help-import

Copyrighted data

Use OpenEV to export raw data

Naming

Landsat 8 metadata text file is to be named scene_name_MTL.txt
Landsat 8 image files are to be named by their scene_name
- so LC80350422019284LGN00_B1.pix to LC80350422019284LGN00_B8.pix

first use OPENEV to export your raw data image
- in : from its native format...................(like .TIF)
- out: to the PCIDSK format.........................(.pix)
raw data is imported
- from any list of channels of any database_in
- into any list of channels of current database_out.pix
USGS origin: database_in.pix must be available in directory ./USGS
- TIF: Landsat data from USGS Earth Explorer come as separate TIF files, one file per band
- they must be exported to PCIDSK format, one file per band?
Other formats must be exported to PCIDSK format
- 4SM shall read from FILE interleaving

Access the USGS or WV2 metadata

-import/v/dTM/USGS*LC80350422019284LGN00............

this provides the location where to read the metadata of USGS or WV2 images

Import from inside a rectangular shapefile

-Import/v/dTM/data*tarawa-full/dbnc_3_0s_0s_0s/R1630_L1860/Origin_709.049_182.231_0_0/chIn1,3/chOut1,3/import.shp
-Import/v/dTM/USGS*LC80350422019284LGN00/dbnc_0_0S_1S_0s/chIn1,7/chOut44,50/import

-Import/V(v)... VerboseI to display comments on screen while importing

DTM or not?

.../D(d)TM/... to import a DTM

directory for the raw data

.../USGS*database_in/... for data courtesy of USGS Earth Explorer
- .../path_to_rawdata/...
- * shall be converted from USGS*database_in to USGS/database_in
- shall import from USGS/database_in.pix into ./database.pix in the current directory
.../data*database_in/... for data courtesy of other providers
- .../path_to_rawdata/...
- * shall be converted from data*database_in to data/database_in
- shall import from data/database_in.pix into ./database.pix in the current directory

import file structure

.../dbnc_0_0s_1S_0s/... format of original data
- dbnc means "data base number of channels" in PCIDSK speak
- default: IU8=U8 IS16=S16 IU16=U16 IR32=R32
- .../dbnc_0_0s_1S_0s/... : import_database channel structure:
  - IU8=0
  - IS16=0s
  - IU16=1S one U16 band per file in USGS data, SwapByte is ON
  - IR32=0s
  - endiannness: swapByte is compulsory
    - S for swapByte is ON
    - s for swapByte is OFF

.../R1630_L1860/... import image size
- InbRow=1630 rows
- InbLin =1860 lines
default is same as in -DB argument
- InbRow=nbRow
- InbLin =nbLin

.../S0.015_S0.015/... import pixel size
- IsizeXpixel=0.030
- IsizeYpixel=0.030
default is same as in -DB/... argument
- IsizeXpixel=sizeXpixel

.../Origin_709.049_182.231_0_0/... in kilometers please: UTM coordinates of UL corner of UL pixel
- West=709.049
- North=182.231
- FalseEasting=0
- FalseNorthing=0
West and North are same as in -DB/... argument

channels

.../chIn1,3/chOut1,3/...
- /chIn1/.........................from ch1of database_In to ch1 of database_Out
- /chIn1/chOut6/..............from ch1 of database_In to ch6 of database_Out
- /chIn1,3/chOut1,3/.........from chIn1, 2 and 3 to chOut1, 2 and 3
- /chIn1,7/chOut44,50/.....from chIn1 to 7 to Ch44 to 50

Optional..............output window to import/insert only into sub-window of database_out.pix
you can place the imported subset anywhere you want in the output image
for this, specify a -Eext1/ext2/ext3/ext4 argument for writing into a sub-window of database_out.pix
-E101/250/1/250 would write from Row_101 to Row_250 and from Line_1 to Line_250
This would insert a subwindow of database_in at the desired location of database_out

Optional and obsolete................../dbiw_IoffsetX_IoffsetY_nbX_nbY
- if an import.sh shapefile is not available
- to specify an import window in the -Import... argument
default is........................../dbiw_0_0_nbRow_nbLin
- assumes import_image and database have same dimensions

import shapefile
to specify the ROI for the database

/import
- name of the import shapefile import.shp
- .shp suffix is not required
- optional: if no import.shp shapefile is provided,
  - the whole original image is loaded into the working database

Corners of shapefile

In view of duplicating 30 m GSD data to 15 m GSD,
please ensure that the four corners of the shapefile
are located very close to the corners of the pixels

COPYRIGHTED DATA

I shall progressively release all my working directories on this website
- the problem is: copyright on the imagery: I can't distribute copyrighted data!
- either the copyright is free: all Landsat images
- or you hold a copy of the imagery
- or you have to buy it
If you hold a copy of the original copyrighted data I have, then you can use it straight away to forward your training using the modeling scripts I have prepared:
- CASI
- IKONOS
- ...
Here is how it works
-Import/GetImportKey_65814@42187860852760994610_gezirat/apr4casi/dbnc_0_0_12_0/5363_6566/1,12_65,76
- I was given a copy of raw proprietary data apr4casi.pix by HDI
  - it belongs to University of Hawaii: I can't afford to distribute it around!!
- if you hold a copy of this data, then you can load the raw data from your file into file gezirat.pix
- this works as follows:
  - my own file gezirat.pix is only a subset of the original file
  - I have produced a GetImportKey: it is a unique key that is specific to a series of 100 spectral pixels somewhere in my own file gezirat.pix
  - applying this key through the -Import/GetImportKey_65814@421... commandline argument,
    - # 4SM locates the said series of pixels,
    - # determines row and line offsets,
    - # and proceeds to import the right subset of the original raw data from database_in into database_out: Cool, is'nt it?