File structure and naming

This pages denotes the current project structure, and naming conventions.
The structure for 2011 is located here.
The structure for previous years is located here.

A single site/logical group of flight lines/sortie should be contained in a single project directory. If there are multiple sites, significantly different times of overflight or large time gaps, each should have its own directory.

The directory name should look like: PROJECTCODE-YYYY_JJJxx_SITENAME, e.g. GB07_07-2007_102a_Inverclyde, boresight-2007_198, etc.

There should be:

  • No spaces, brackets or other Unix-upsetting characters in filenames
  • Execute permission removed from anything non-executable

The structure under the project directory should look like:

Top Level Dirs 2nd Level Dirs 3rd Level Dirs 4th Level Dirs 5th Level Dirs 6th Level Dirs Example File Formats Comments
admin Contains the flight logsheet and any miscellaneous information (readme's, copies of trac tickets, etc)
GB08_02-2009_078a-Delamere.(doc|txt|pdf) Logsheet
GB08_02-2009_078a-Delamere.fpd Flight planning document
delivery_readmes Read_Me-20100809.(aux|log|tex) Intermediate files used to create the ReadMe(s)
(cam|hyp|lidar)_genreadme.cfg Configuration files generated by generate_readme_config.py
calibration Typically a symlink to the appropriate calibration directory
camera Camera-type sensors
rcd RCD digital camera
090803-100306ImageEvents1-processed.csv Processed events file
logs
camera_delivery.log
090803-100306ImageEvents(1|2).csv
090803-145404PhotoId(1|2).csv
090803-100306SensorLog.csv
090803-145404SensorStat(1|2).csv
raw_images 16093417100001G(3|4).raw
webcam 100715_124101_000.jpg Webcam image
20100715_105036_evt.csv Webcam event file
hyperspectral
eagle Raw Eagle data files
dataCube.raw
VNIR078a-09-1.hdr ENVI compatible header
VNIR078a-09-1.log Log files
VNIR078a-09-1.nav Navigation synchronisation data
VNIR078a-09-1.raw Uncalibrated image data in .bil format
hawk Raw Hawk data files
dataCube.raw
SWIR078a-09-1.hdr ENVI compatible header
SWIR078a-09-1.log Log files
SWIR078a-09-1.nav Navigation synchronisation data
SWIR078a-09-1.raw Uncalibrated image data in .bil format
orignal_headers (optional) SWIR078a-09-1.hdr-orig If the header files have been altered for any reason, the originals should be in here
lidar als50
aux_files Reg file used, any logs produced, intensity mosaics, boresight values
lidar_2009078a.mos ENVI mosaic of lidar lines intensity
lidar_2009078a.mos.hdr ENVI mosaic header
2009078a.reg Contains ALSPP settings
lidar_2009078a.tif Lidar intensity image
line01_2009078a.tif Individual flightline intensity image
logs Contains the flight/ops log files
100411_084840_FlightLineLog.csv
20091123212501_LogData.mdb
091005_LogFile.txt
090812_DLLogFile.txt
20091123212501_LogDataSysDesc.xml
RawLaser Contains the raw laser data
090601_111411 Contains raw laser for one contiguous recording
LDR090601_111411_0000000001.scn Raw LIDAR scan files
RawWFD Raw waveform data
100706_094620
WFD100706_094620_0000000001A.LWV
logfiles EU11_06_2011-098_eagle_-3.o2810538 Logs from hyperspectral script runs on gridnode (one log per flightline)
posatt Position/attitude data
basestation Basestation data
ppp_result Contain the output from the PPP processing of basestation
oxfr154g30.09n
oxfr154g30.09o
oxfr154g30.epp
oxfr154g30.gpb POSGNSS friendly file format
oxfr154g30.sta Text file with info about basestation
ipas_honeywell Data from ipas using the honeywell imu
*.gpj IPAS Pro Project File
*.itp IPAS TC Project File
extract
*.epp
*.EVT
*_extractLog.txt
*.fbv
*.rbv
*.gpb Grafnav friendly file format
*.GPS
*.IMU
*.RNV
*.RTG
*_RTMsg.txt
*.sta
*.SUP
*.tm
gps
*.cfg Grafnav project file
*.fml
*.fss
*.fsl PPP log file
*.fwd
*.his
*.lat Grafnav final output which is used by IPAS (text version)
*.lat.bin Grafnav final output which is used by IPAS
*.rev
*.rml
*.rsl PPP log file
*.rss
proc Processed ipas nav data
20090319_142319.sol Final output file
sbet_20090319_from_sol.out Applanix sbet created from sol file
20090319_142319.ers
20090319_142319.sup
2009078a_procLog.txt
20090319_142319.iqc IPAS TC quality control file
raw 20090319_111251.001 Raw GPS/IMU data
ipas20 Data from ipas using the old applanix imu
extract
gps
proc Processed ipas nav data
raw 20120323_103627.dat.000 Raw GPS/IMU data
processing
als50
las Contains the finalised processed LAS files
LDR091026_060148_1.LAS LAS file
pplog_20100226_122027.txt Log output from ALSPP
stats.txt Info from ALSPP about the LAS files
las-classified Contains the classified LAS files for delivery
LDR091026_060148_1.LAS LAS file
delivery Contains copies of data delivered to end users
EUFAR11_06-098-hyperspectral-20110621 Delivery structures described below Delivery folder
hyperspectral 0532010.cfg Config file
dem
flightlines
georeferencing
igm
mapped e078a013b_n_sct-0.03_p_gpt0.0.tif Geo-rectified images
level 1b
line information
navigation
interpolated
post_processed
real_time
rcd
proc_images 16093417100001G(3|4).tif
thumbnails 16093417100001G(3|4).jpg
tabi Raw TABI data

The lev1 and lev3 data filenames are structured as "sdddfnn1b.{hdf|tif}", where:

  • s is the sensor id (a=ATM, c=CASI, e=Eagle, h=Hawk)
  • ddd is the Julian day of the data acquisition
  • f distinguishes between multiple flights on the same day (“a” being the first flight)
  • 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)

Delivered data

As 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.

Delivered data is stored processing/delivery/PROJECTCODE-JDAY-SENSOR-YYYYMMDD/...., where YYYYMMDD is the date the delivery was created, PROJECTCODE is the project code, JDAY is the day of year of the flight (+ optional sortie ID) and SENSOR is {camera,hyperspectral,lidar}. The directory structure of a delivery looks like:

Hyperspectral deliveries

Top level Dir 2nd level Dir Example Files Comments
Read_Me-20100202.pdf Instructions for use and description of dataset, plus any problems encountered.
dem A dem to help the user with processing to lev3. Should be ASTER.
GB08_19-2010_254b-ASTER.dem ASTER binary dem
GB08_19-2010_254b-ASTER.hdr Header file for DEM
doc data quality report and other documentation
hyperspectral_data_quality_report2012.pdf data quality report
ISO19115-stylesheet.xsl XSLT style sheet for the XML files in line_information and project_information directories
ISO19115-css.css CSS style sheet for the XML files in line_information and project_information directories
flightlines
fodis (only for Eagle deliveries and not 2013) Data for the FODIS instrument
e078a021b_FODIS.bil Do not include in 2013 projects
e078a021b_FODIS.bil.hdr Do not include in 2013 projects
level1b Level 1 image data
(e|h)078a021b.bil ENVI bil file of level 1 data
(e|h)078a021b.bil.hdr
(e|h)078a021b_mask.bil A bil mask, generated for each project
(e|h)078a021b_mask.bil.hdr
(h|f)078a021b_mask-badpixelmethod.bil A bil mask, generated during the yearly calibration (hawk and fenix only)
(h|f)078a021b_mask-badpixelmethod.bil.hdr
line_information
(e|h)221021b.xml metadata for each line
ISO19115-stylesheet.xsl XSLT style sheet for the XML files in line_information and project_information directories
ISO19115-css.css CSS style sheet for the XML files in line_information and project_information directories
mapped
e078a023b_mapped_(utm*|osng).bil Mapped level 3 bil files (these have had the mask applied)
e078a023b_mapped_(utm*|osng).bil.hdr
e078a023b_mapped_(utm*|osng)_bil.zip Zipped mapped files (this is how they are delivered)
unzipped_filesize.csv Details of the filesizes before zipping
navigation Navigation data for each line
e078a021b_nav_post_processed.bil Envi bil file with navigation data
e078a021b_nav_post_processed.bil.hdr Header file for navigation
e078a021b_nav_post_processed_quality.bil Bil file indicating quality of navigation file
e078a021b_nav_post_processed_quality.bil.hdr Header file for quality file
logsheet FW10_01-2010_187-Dennys_wood.pdf Copy of pdf version of logsheet
misc (optional) Any additional files needed for level 3 processing (e.g. OS National Grid correction file, geoid-spheroid separation grid file, etc)
osgb02
sphsep15lx.grd
project_information
BB11_01-2011_244a-project.xml Meta data for the project as a whole
ISO19115-stylesheet.xsl XSLT style sheet for the XML files in line_information and project_information directories
ISO19115-css.css CSS style sheet for the XML files in line_information and project_information directories
screenshots Images of the level 3 output we created when testing the data
(e|h)078a013b.jpg Individual line screenshot
(eagle|hawk)_mosaic.jpg Screenshot of all level 3 data
(eagle|hawk_mosaic_with_vectors.jpg Screenshot of all level 3 data with overlaid vectors (UK only)
sensor_FOV_vectors
(eagle|hawk)_fov_fullccd_vectors.bil
(eagle|hawk)_fov_fullccd_vectors.hdr
(eagle|hawk)_viewvector_list.txt

The image filenames in the lev1 directory are structured as sdddfnnLL.hdf, where:

  • s is the sensor id (a=ATM, c=CASI, e=Eagle, h=Hawk)
  • ddd is the Julian day of the data acquisition
  • f distinguishes between multiple flights on the same day ("a" being the first flight)
  • nn is the flight line number
  • LL is the processing level
    • 1b = ungeocorrected data
    • 3a = geocorrected without a DEM
    • 3b = geocorrected with a DEM

Lidar deliveries

Dirs Sub Dir Level 1 Sub Dir Level 2 Example Files Comments
Read_Me-20100202.pdf Instructions for use and description of dataset, plus any problems encountered
bin Latest versions of the pt_cloud_filter for linux and windows
dem DEMs created from the LiDAR
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.
GB08_19-2010_254b-lidar_ASTER-wgs84_utm.hdr
GB08_19-2010_254b-lidar_ASTER-wgs84_latlong.dem Above LiDAR dem converted to wgs84_latlong (compatible with apl)
GB08_19-2010_254b-lidar_ASTER-wgs84_latlong.hdr
README_DEM_MAY_NOT_BE_ACCURATE.txt Warning to end user that there are potential flaws with the provided DEMs
doc lidar_quality_report_2011.pdf Lidar quality report
full_waveform.pdf FW Lidar Data review (full waveform deliveries only)
flightlines Classified lidar point clouds
(IF DISCRETE)
ascii LDR-EU11_03-2011-102-10.txt ASCII point clouds
(las1.0|las1.2) LDR-EU11_03-2011-102-10.LAS LAS1.0 point clouds
(IF FULL WAVEFORM PRESENT)
discrete_laser
ascii LDR-EU11_03-2011-102-10.txt ASCII point clouds
(las1.0|las1.2) LDR-EU11_03-2011-102-10.LAS LAS1.0 point clouds
fw_laser
las1.3 LDR-FW-GB13_10-2014-156-01.LAS LAS1.3 point clouds
fw_extractions (FW only) Full waveform area extractions
FW10_02-2010_101_extractions.jpg
FW10_02-2010_101_extractions.txt
area1
waveform_42437_649348_only.txt ?
logsheet GB08_02-2009_078a-Delamere.pdf Flight logsheet, typed up or created by generate_logsheet.py
navigation
FW10_02-2010_101.sol
trj_files (FW only)
FW10_02-2010-101-01.trj
screenshots Images of the dem and intensity mosaic
GB08_19-2010_254b-intensity.jpg
GB08_19-2010_254b-intensity_vectors.jpg UK only
GB08_19-2010_254b-dem.jpg
LDR-GB12_05-2014-075-22.jpg Screenshot for each flightline in the flight.

Photographic deliveries

Dirs Example Files Comments
GB08_02-2009_078a.kml Google earth file containing eagle/hawk/photo positions
Read_Me-20100202.pdf Instructions for use and description of dataset, plus any problems encountered
doc Useful documents
camera_data_quality_report2012.pdf Camera data quality report
RCD105_SN21_Calibration_Certificate.pdf Camera Calibration Certificate
eventfile RCD105-GB08_02-2009078a-ImageEvents.csv CSV file containing pos/att info per photograph event (may be missing if camera crashed)
photographs RCD105-GB08_02-2009078a-00001.tif Tagged tif files of each photograph in area of interest
thumbnails RCD105-GB08_02-2009078a-00001.jpg JPEG thumbnails of each photograph in area of interest
Last modified 3 years ago Last modified on Jul 21, 2015 3:49:42 PM