Changes between Initial Version and Version 1 of Processing/FilenameConventions2011


Ignore:
Timestamp:
May 9, 2012 3:37:54 PM (9 years ago)
Author:
knpa
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Processing/FilenameConventions2011

    v1 v1  
     1= File structure and naming =
     2[[PageOutline]]
     3
     4This page denotes the 2011 project structure. The current structure can be found [wiki:Processing/FilenameConventions here].
     5
     6A single site/logical group of flight lines/sortie should be contained in a single directory.  If there are multiple sites from different projects, significantly different times of overflight or large time gaps, each should have its own directory.
     7
     8The directory name should look like: PROJECTCODE-YYYY_JJJxx_SITENAME, e.g. GB07_07-2007_102a_Inverclyde, boresight-2007_198, etc.
     9
     10There should be:
     11 * no spaces, brackets or other Unix-upsetting characters in filenames
     12 * execute permission removed from anything non-executable
     13 * no empty directories? (need to think about this, maybe only do after checking it's not a stub for later data)
     14
     15The structure under the project directory should look like:
     16||'''Top Level Dirs '''|| '''2nd Level Dirs''' || '''3rd Level Dirs''' || '''4th Level Dirs''' || '''5th Level Dirs''' || '''6th Level Dirs''' || '''Example File Formats''' || '''Comments''' ||
     17|| admin || || || || || || || Contains the flight logsheet and any miscellaneous information (readme's, copies of trac tickets, etc) ||
     18|| || || || || || || GB08_02-2009_078a_Delamere.(doc|txt|pdf) || Logsheet ||
     19|| || || || || || || GB08_02-2009_078a_Delamere.fpd || Flight planning document ||
     20|| || delivery_readmes || ||  ||  || || Read_Me-20100809.(aux|log|tex) || Intermediate files used to create the !ReadMe(s) ||
     21|| || || || || || || (cam|hyp|lidar)_genreadme.cfg || Configuration files generated by generate_readme_config.py ||
     22|| calibration || || || || || || || Typically a symlink to the appropriate calibration directory ||
     23|| camera || || || || || || || Camera-type sensors || 
     24|| || rcd || || || ||  ||  || RCD digital camera ||
     25|| || || || || ||  || 090803-100306ImageEvents1-processed.csv || Processed events file ||
     26|| || || logs || || || || || ||
     27|| || || || || || || camera_delivery.log || ||
     28|| || || || || || ||  090803-100306ImageEvents(1|2).csv || ||
     29|| || || || || || ||  090803-145404PhotoId(1|2).csv || ||
     30|| || || || || || ||  090803-100306SensorLog.csv  || ||
     31|| || || || || || ||  090803-145404SensorStat(1|2).csv || ||
     32|| || || raw_images || || || || 16093417100001G(3|4).raw|| ||
     33|| || || webcam     || || || || 100715_124101_000.jpg || Webcam image ||
     34|| || || || || || || 20100715_105036_evt.csv || Webcam event file ||
     35|| hyperspectral || || || || || || || ||
     36|| || eagle || || || || || || Raw Eagle data files ||
     37|| || || || || || || dataCube.raw || ||
     38|| || || || || || || VNIR078a-09-1.hdr || ENVI compatible header ||
     39|| || || || || || || VNIR078a-09-1.log || Log files ||
     40|| || || || || || || VNIR078a-09-1.nav || Navigation synchronisation data ||
     41|| || || || || || || VNIR078a-09-1.raw || Uncalibrated image data in .bil format ||
     42|| || hawk || || || || || || Raw Hawk data files ||
     43|| || || || || || || dataCube.raw || ||
     44|| || || || || || || SWIR078a-09-1.hdr || ENVI compatible header ||
     45|| || || || || || || SWIR078a-09-1.log || Log files ||
     46|| || || || || || || SWIR078a-09-1.nav || Navigation synchronisation data ||
     47|| || || || || || || SWIR078a-09-1.raw || Uncalibrated image data in .bil format ||
     48|| lidar || als50 || || || || || || ||
     49|| || || aux_files || || || || || Reg file used, any logs produced, intensity mosaics, boresight values ||
     50|| || || || || || || lidar_2009078a.mos || ENVI mosaic of lidar lines intensity ||
     51|| || || || || || || lidar_2009078a.mos.hdr || ENVI mosaic header ||
     52|| || || || || || || 2009078a.reg  || Contains ALSPP settings ||
     53|| || || || || || || lidar_2009078a.tif || Lidar intensity image ||
     54|| || || || || || || line01_2009078a.tif || Individual flightline intensity image ||
     55|| || || logs || || ||  || || Contains the flight/ops log files ||
     56|| || || || || || || 100411_084840_FlightLineLog.csv || ||
     57|| || || || || || || 20091123212501_LogData.mdb || ||
     58|| || || || || || ||  091005_LogFile.txt || ||
     59|| || || || || || ||  090812_DLLogFile.txt || ||
     60|| || || || || || ||  20091123212501_LogDataSysDesc.xml || ||
     61|| || || !RawLaser  || || || || || Contains the raw laser data ||
     62|| || || || 090601_111411 || || || || Contains raw laser for one contiguous recording ||
     63|| || || || || || ||  LDR090601_111411_0000000001.scn || Raw LIDAR scan files ||
     64|| || || RawWFD  || || || || || Raw waveform data ||
     65|| || || || 100706_094620 || || || || ||
     66|| || || || || || || WFD100706_094620_0000000001A.LWV || ||
     67|| logfiles  || || || ||  || ||  EU11_06_2011-098_eagle_-3.o2810538 || Logs from hyperspectral script runs on gridnode (one log per flightline) ||
     68|| posatt || || || || || || || Position/attitude data ||
     69|| || applanix_litton || || || || || || Data from applanix using the litton imu ||
     70|| || || || || || || 2009078a.ppc || POSPac project file ||
     71|| || || extract  || || || || || Plane gps data after extracted from raw files by applanix ||
     72|| || || || || || || dephem_2009078a.dat  || ||
     73|| || || || || || || extract_2009078a.log || ||
     74|| || || || || || || gps_prim_2009078a.dat || ||
     75|| || || || || || || hwconf_2009078a.out || ||
     76|| || || || || || || iinr_2009078a.out || ||
     77|| || || || || || || iinz_2009078a.out || ||
     78|| || || || || || || imu_2009078a.dat || ||
     79|| || || || || || || mgps_2009078a.epp || ||
     80|| || || || || || || mgps_2009078a.gpb || POSGNSS friendly file format  ||
     81|| || || || || || || mgps_2009078a.nov|| ||
     82|| || || || || || || mgps_2009078a.sta || ||
     83|| || || || || || || navclk_prim_2009078a.dat || ||
     84|| || || || || || || obs_prim_2009078a.dat || ||
     85|| || || || || || || rers_2009078a.out || ||
     86|| || || || || || || rinv_2009078a.out || ||
     87|| || || || || || || rmrs_2009078a.out || ||
     88|| || || || || || || rrms_2009078a.out || ||
     89|| || || || || || || rtstat_2009078a.txt || ||
     90|| || || || || || || tm_2009078a.dat || ||
     91|| || || || || || || vnav_2009078a.out || ||
     92|| || || || || || || vrms_2009078a.out || ||
     93|| || || || || || || *GNSS.dat || ||
     94|| || || gps || || || || || Files associated with POSGNSS ||
     95|| || || || || || || 2009078a.cmb  || Combined ||
     96|| || || || || || || 2009078a.fbv || ||
     97|| || || || || || || 2009078a.fml || ||
     98|| || || || || || || 2009078a.fsl || PPP log file ||
     99|| || || || || || || 2009078a.fss || ||
     100|| || || || || || || 2009078a.fwd || ||
     101|| || || || || || || 2009078a.gnv || POSGNSS Project file ||
     102|| || || || || || || 2009078a.his || ||
     103|| || || || || || || 2009078a.rbv || ||
     104|| || || || || || || 2009078a.rev || ||
     105|| || || || || || || 2009078a.rml || ||
     106|| || || || || || || 2009078a.rsl || PPP log file ||
     107|| || || || || || || 2009078a.rss || ||
     108|| || || proc || || || || ||  Processed applanix data ||
     109|| || || || || || || ers_2009078a.out || ||
     110|| || || || || || || idx_2009078a.txt || ||
     111|| || || || || || || inv_2009078a.out || ||
     112|| || || || || || || iin_2009078a.out || ||
     113|| || || || || || || mrs_2009078a.out || ||
     114|| || || || || || || rms_2009078a.out || ||
     115|| || || || || || || rmsg_2009078a.out || ||
     116|| || || || || || || sbet_2009078a.out || Main output file ||
     117|| || || || || || || sbet_2009078.out|| ||
     118|| || || || || || || smhkm_2009078a.dat || ||
     119|| || || || || || || smindex_2009078a.dat  || ||
     120|| || || || || || || smout_2009078a.out || ||
     121|| || || || || || || smparm_2009078a.txt|| ||
     122|| || || || || || || smphi_2009078a.dat|| ||
     123|| || || || || || || smpx_2009078a.dat || ||
     124|| || || || || || || smreset_2009078a.dat || ||
     125|| || || || || || || smrms_2009078a.out || ||
     126|| || || || || || || smrmsg_2009078a.out || ||
     127|| || || raw || || || ||  DCALM.001 || Raw gps data from plane ||
     128|| || basestation || || || || || || Basestation data ||
     129|| || || || || || || oxfr154g30.09n || ||
     130|| || || || || || || oxfr154g30.09o  || ||
     131|| || || || || || || oxfr154g30.epp || ||
     132|| || || || || || || oxfr154g30.gpb || POSGNSS friendly file format ||
     133|| || || || || || ||  oxfr154g30.sta || Text file with info about basestation ||
     134|| || ipas_honeywell || || || || || || Data from ipas using the honeywell imu ||
     135|| || || || || || || *.gpj || IPAS Pro Project File ||
     136|| || || || || || || *.itp || IPAS TC Project File ||
     137|| || || extract || || || || || ||
     138|| || || || || || || *.epp || ||
     139|| || || || || ||  || *.EVT || ||
     140|| || || || || || || *_extractLog.txt || ||
     141|| || || || || || || *.fbv || ||
     142|| || || || || || || *.rbv || ||
     143|| || || || || || || *.gpb || Grafnav friendly file format  ||
     144|| || || || || || || *.GPS || ||
     145|| || || || || || || *.IMU || ||
     146|| || || || || || || *.RNV || ||
     147|| || || || || || || *.RTG || ||
     148|| || || || || || || *_RTMsg.txt || ||
     149|| || || || || || || *.sta || ||
     150|| || || || || || || *.SUP || ||
     151|| || || || || || || *.tm || ||
     152|| || || gps || || || ||  || ||
     153|| || || || || || || *.cfg || Grafnav project file ||
     154|| || || || || || || *.fml || ||
     155|| || || || || || || *.fss || ||
     156|| || || || || || || *.fsl || PPP log file ||
     157|| || || || || || || *.fwd || ||
     158|| || || || || || || *.his || ||
     159|| || || || || || || *.lat || Grafnav final output which is used by IPAS (text version) ||
     160|| || || || || || || *.lat.bin || Grafnav final output which is used by IPAS ||
     161|| || || || || || || *.rev || ||
     162|| || || || || || || *.rml || ||
     163|| || || || || || || *.rsl || PPP log file ||
     164|| || || || || || || *.rss || ||
     165|| || || proc || || || || || Processed ipas nav data ||
     166|| || || || || || || 20090319_142319.sol || Final output file ||
     167|| || || || || || || sbet_20090319_from_sol.out || Applanix sbet created from sol file ||
     168|| || || || || || || 20090319_142319.ers || ||
     169|| || || || || || || 20090319_142319.sup || ||
     170|| || || || || || || 2009078a_procLog.txt || ||
     171|| || || || || || || 20090319_142319.iqc || IPAS TC quality control file ||
     172|| || || raw || || || || 20090319_111251.001 || Raw GPS/IMU data ||
     173|| processing || || || || || || || ||
     174|| || als50  || || || || || || ||
     175|| || || las || || || ||  || Contains the finalised processed LAS files ||
     176|| || || || || || || LDR091026_060148_1.LAS || LAS file ||
     177|| || || || || || || pplog_20100226_122027.txt || Log output from ALSPP ||
     178|| || || || || || || stats.txt || Info from ALSPP about the LAS files ||
     179|| || || las-classified || || || ||  || Contains the classified LAS files for delivery||
     180|| || || || || || || LDR091026_060148_1.LAS || LAS file ||
     181|| || delivery   || || || || || || Contains copies of data delivered to end users ||
     182|| || || EUFAR11_06-098-hyperspectral-20110621 || ''Delivery structures described below'' || || || || Delivery folder ||
     183|| || hyperspectral || || || || || 0532010.cfg  || Config file ||
     184|| || ||  dem  || || || || || ||
     185|| || || flightlines || || || || || ||
     186|| || || || georeferencing || || || || ||
     187|| || || || || igm || || || ||
     188|| || || || || mapped || || e078a013b_n_sct-0.03_p_gpt0.0.tif || Geo-rectified images ||
     189|| || || || level 1b || || || || ||
     190|| || || || line information || || || || ||
     191|| || || || navigation || || || || ||
     192|| || || || || interpolated || || || ||
     193|| || || || || || post_processed || || ||
     194|| || || || || || real_time || || ||
     195|| || rcd || || || || || || ||
     196|| || || proc_images || || ||  || 16093417100001G(3|4).tif || ||
     197|| || || thumbnails || || ||  || 16093417100001G(3|4).jpg || ||
     198|| tabi || || || || || || || Raw TABI data ||
     199
     200The lev1 and lev3 data filenames are structured as "sdddfnn1b.{hdf|tif}", where:
     201 * s is the sensor id (a=ATM, c=CASI, e=Eagle, h=Hawk)
     202 * ddd is the Julian day of the data acquisition
     203 * f distinguishes between multiple flights on the same day (“a” being the first flight)
     204 * nn is the flight line number (note this is not necessarily the same as the flight line identifier as specified by the PI - these numbers are the number of the flight in order of when it was taken, as on the logsheet)
     205
     206
     207== Delivered data ==
     208
     209As data may be delivered multiple times (in the event of a problem requiring reprocessing) or in stages (if particular sensors are completed first and others look like they'll be delayed), we take copies of any data sent to the end user for future reference (e.g. in support).  The lev1/ and lev3/ directories will typically contain the latest processed version.
     210
     211Delivered data is stored delivery/YYYYMMDD/PROJECTCODE/, where YYYYMMDD is the date the delivery was created.  The directory structure of a delivery looks like:
     212
     213==== Hyperspectral deliveries ==== #HyperspecDel
     214
     215|| '''Top level Dir''' || '''2nd level Dir''' || '''Example Files''' || '''Comments''' ||
     216|| || ||  Read_Me-20100202.pdf ||    Instructions for use and description of dataset, plus any problems encountered. ||
     217|| dem || ||  || A dem to help the user with processing to lev3. Should be ASTER. ||
     218|| || || GB08_19-2010-254b-ASTER.dem || ASTER binary dem ||
     219|| || || GB08_19-2010-254b-ASTER.hdr || Header file for DEM ||
     220|| doc || || || data quality report and other documentation ||
     221|| || || data_quality-20100525.pdf || data quality report ||
     222|| flightlines || || || ||
     223|| || fodis || || Data for the FODIS instrument ||
     224|| || || e220041b_FODIS.bil || ||
     225|| || || e220041b_FODIS.bil.hdr || ||
     226|| || level1b || || Level 1 image data ||
     227|| || || (e|h)078a031b.bil || ENVI bil file of level 1 data ||
     228|| || || (e|h)078a031b.bil.hdr || Header file for image data ||
     229|| || || e223041b_mask.bil || An image showing masked pixels ||
     230|| || || e223041b_mask.bil.hdr || Header file for mask image ||
     231|| || || h223041b_badpixels.txt || List of bad pixels (Hawk only) ||
     232|| || line_information || (e|h)221021b.xml || metadata for each line ||
     233|| || navigation || || Navigation data for each line ||
     234|| || || e098101b_nav_post_processed.bil || Envi bil file with navigation data ||
     235|| || || e098101b_nav_post_processed.bil.hdr || Header file for navigation ||
     236|| || || e098101b_nav_post_processed_quality.bil || Bil file indicating quality of navigation file ||
     237|| || || e098101b_nav_post_processed_quality.bil.hdr || Header file for quality file ||
     238|| logsheet || || FW10_01-2010_187_Dennys_wood.pdf || Copy of pdf version of logsheet ||
     239|| misc (optional) || ||  ||  Any additional files needed for level 3 processing (e.g. OS National Grid correction file, geoid-spheroid separation grid file, etc) ||
     240|| || || osgb02 || ||
     241|| || || sphsep15lx.grd || ||
     242|| project_information ||  || BB11_01-2011_244a-project.xml || Meta data for the project as a whole  ||
     243|| screenshots || || || Images of the level 3 output we created when testing the data ||
     244|| || || (e|h)078a013b.jpg || Individual line screenshot ||
     245|| || || (eagle|hawk)_mosaic.jpg || Screenshot of all level 3 data  ||
     246|| || || (eagle|hawk_mosaic_with_vectors.jpg  || Screenshot of all level 3 data with overlaid vectors (UK only) ||
     247|| sensor_FOV_vectors || || || ||
     248|| || || (eagle|hawk)_fov_fullccd_vectors.bil || ||
     249|| || || (eagle|hawk)_fov_fullccd_vectors.hdr || ||
     250
     251The image filenames in the lev1 directory are structured as `sdddfnnLL.hdf`, where:
     252 * `s` is the sensor id (a=ATM, c=CASI, e=Eagle, h=Hawk)
     253 * `ddd` is the Julian day of the data acquisition
     254 * `f` distinguishes between multiple flights on the same day ("a" being the first flight)
     255 * `nn` is the flight line number
     256 * `LL` is the processing level
     257   * 1b = ungeocorrected data
     258   * 3a = geocorrected without a DEM
     259   * 3b = geocorrected with a DEM
     260
     261==== Lidar deliveries ====
     262
     263|| '''Dirs''' || '''Sub Dirs''' || '''Example Files''' || '''Comments''' ||
     264||  || || Read_Me-20100202.pdf ||   Instructions for use and description of dataset, plus any problems encountered ||
     265|| bin ||  ||  ||   Latest versions of the pt_cloud_filter for linux and windows ||
     266|| dem ||  || || DEMs created from the LiDAR ||
     267|| || || GB08_19-2010-254b-lidar_ASTER-wgs84_utm.dem || LiDAR dem patched with ASTER data (do not use NEXTMAP data - license restrictions). DEM is in same co-ordinate system as processed LAS files. ||
     268|| || || GB08_19-2010-254b-lidar_ASTER-wgs84_utm.hdr || ||
     269|| || || GB08_19-2010-254b-lidar_ASTER-wgs84_latlong.dem || Above LiDAR dem converted to wgs84_latlong (compatible with apl) ||
     270|| || || GB08_19-2010-254b-lidar_ASTER-wgs84_latlong.hdr || ||
     271|| || || README_DEM_MAY_NOT_BE_ACCURATE.txt || Warning to end user that there are potential flaws with the provided DEMs ||
     272|| doc || || lidar-quality-report_20110519.pdf  ||  Lidar quality report ||
     273|| flightlines || ||  ||   Classified lidar point clouds ||
     274||  ||  ascii ||  LDR-EU11_03-2011-102-10.txt || ASCII point clouds ||
     275||  ||  las1.0 || LDR-EU11_03-2011-102-10.LAS || LAS1.0 point clouds ||
     276||  ||  las1.3 (FW only) || LDR-FF-EU11_03-201110201.LAS || LAS1.3 point clouds ||
     277|| fw_extractions (FW only) ||  ||  || Full waveform area extractions ||
     278|| ||  || FW10_02-2010_101_extractions.jpg || ||
     279|| ||  || FW10_02-2010_101_extractions.txt || ||
     280|| || area1 || || ||
     281|| || || waveform_42437_649348_only.txt ? || ||
     282|| logsheet ||  || GB08_02-2009_078a_Delamere.pdf || Flight logsheet, typed up or created by generate_logsheet.py ||
     283|| screenshots ||  || || Images of the dem and intensity mosaic ||
     284|| ||  || GB08_19-2010-254b_intensity.jpg || ||
     285|| ||  || GB08_19-2010-254b_intensity_vectors.jpg || UK only ||
     286|| ||  || GB08_19-2010-254b_dem.jpg || ||
     287
     288==== Photographic deliveries ====
     289
     290|| '''Dirs''' || '''Example Files''' || '''Comments''' ||
     291||  || GB08_02-2009_078a.kml ||  Google earth file containing eagle/hawk/photo positions ||
     292||   || Read_Me-20100202.pdf ||  Instructions for use and description of dataset, plus any problems encountered ||
     293|| doc  || || Useful documents ||
     294|| || data_quality-20091202.pdf || Camera data quality report ||
     295|| || RCD105_Calibration_Certificate.pdf || Camera Calibration Certificate ||
     296|| eventfile || RCD105-GB08_02-2009078a-!ImageEvents.csv || CSV file containing pos/att info per photograph event (may be missing if camera crashed) ||
     297|| photographs || RCD105-GB08_02-2009078a-00001.tif || Tagged tif files of each photograph in area of interest ||
     298|| thumbnails || RCD105-GB08_02-2009078a-00001.jpg || JPEG thumbnails of each photograph in area of interest ||