File structure and naming

The old structure is located here.

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

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
• no empty directories? (need to think about this, maybe only do after checking it's not a stub for later data)

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
						(eagle|hawk).mos	Eagle and Hawk mosaics of lev3 data
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)	Contains 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
	rcd
						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
						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 (.raw = image data, .hdr = ENVI compatible header, .nav = navigation synchronisation data)
						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
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						*.logs	Logs from hyperspectral script runs on gridnode (one log per flightline)
posatt							position/attitude data
	applanix_litton						data from applanix using the litton imu
						2009078a.ppc	POSPac project file
					base (deprecated)		?
					eo (possibly optional and often empty)		?
					extract		Plane gps data after extracted from raw files by applanix
						dephem_2009078a.dat
						extract_2009078a.log
						gps_prim_2009078a.dat
						hwconf_2009078a.out
						iinr_2009078a.out
						iinz_2009078a.out
						imu_2009078a.dat
						mgps_2009078a.epp
						mgps_2009078a.gpb	POSGNSS friendly file format
						mgps_2009078a.nov
						mgps_2009078a.sta
						navclk_prim_2009078a.dat
						obs_prim_2009078a.dat
						rers_2009078a.out
						rinv_2009078a.out
						rmrs_2009078a.out
						rrms_2009078a.out
						rtstat_2009078a.txt
						tm_2009078a.dat
						vnav_2009078a.out
						vrms_2009078a.out
						*GNSS.dat
		gps					Files associated with POSGNSS
						2009078a.cmb	Combined
						2009078a.fbv
						2009078a.fml
						2009078a.fsl	PPP log file
						2009078a.fss
						2009078a.fwd
						2009078a.gnv	POSGNSS Project file
						2009078a.his
						2009078a.rbv
						2009078a.rev
						2009078a.rml
						2009078a.rsl	PPP log file
						2009078a.rss
	proc						Processed applanix data
						ers_2009078a.out
						idx_2009078a.txt
						inv_2009078a.out
						iin_2009078a.out
						mrs_2009078a.out
						rms_2009078a.out
						rmsg_2009078a.out
						sbet_2009078a.out	Main output file
						sbet_2009078.out
						smhkm_2009078a.dat
						smindex_2009078a.dat
						smout_2009078a.out
						smparm_2009078a.txt
						smphi_2009078a.dat
						smpx_2009078a.dat
						smreset_2009078a.dat
						smrms_2009078a.out
						smrmsg_2009078a.out
	raw					DCALM.001	Raw gps data from plane
	basestation						basestation data
		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
	base						Base station data
						oxfr154g30.09n
						oxfr154g30.09o
						oxfr154g30.epp
						oxfr154g30.gpb	Gravnav friendly file format
						oxfr154g30.sta	Text file with info about basestation
	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
				processing
					als50
					proc_images	16093417100001G(3|4).tif
					proc_thumbnails	16093417100001G(3|4).jpg
	proc_laser						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
	delivery						Contains copies of data delivered to end users
	(see below)						Structure described below
	hyperspectral					0532010.cfg	Config file
			dem				Contains azgcorr compatible DEMs
	flightlines
			navigation
				interpolated	post_processed
			georeferencing
				mapped		e078a013b_n_sct-0.03_p_gpt0.0.tif
	rcd
					proc_images
					thumbnails
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 delivery/YYYYMMDD/PROJECTCODE/, where YYYYMMDD is the date the delivery was created. The directory structure of a delivery looks like:

Hyperspectral deliveries

Dirs	Example Files	Comments
	COPYRIGHT.txt (deprecated - now in Readme)	Copyright notice
	Read_Me-20100202.(txt|pdf)	Instructions for use and description of dataset, plus any problems encountered.
bin (deprecated - now in readme)		Instructions for downloading azgcorr
dem (optional)	GB08_19-2010_254b-lidar-ASTER.dem	A dem to help the user with processing to lev3. Can be from their lidar/SRTM/ASTER or a combination (not from NEXTMAP data - license restrictions).
doc		azgcorr manual and other documentation
	azgcorr_geocorrection.pdf
	azgcorr_manual.pdf
	data_quality-20100525.pdf
	README-manual_outdated.txt
lev1		Processed level 1 data
	(e|h)078a031b.bil	Level 1 image data
	(e|h)078a031b.bil.hdr	Header file for image data
	(e|h)078a031b.hdf	Metadata for image
logsheet		Copy of pdf version of logsheet
	FW10_01-2010_187_Dennys_wood.pdf
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
screenshots		Images of the level 3 output we managed 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

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 Dirs	Example Files	Comments
		COPYRIGHT.txt (deprecated - now in Readme)	Copyright notice
		Read_Me-20100202.(txt|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		GB08_19-2010_254b-lidar_ASTER-wgs84_utm.dem	DEM created from the lidar data. Can be from their lidar/SRTM/ASTER or a combination (not from NEXTMAP data - license restrictions). DEM is in same co-ordinate system as processed LAS files.
		GB08_19-2010_254b-lidar_ASTER-wgs84_latlong.dem	Above LiDAR dem converted to wgs84_latlong (compatible with apl)

doc		lidar-quality-report_20110519.pdf	Lidar quality report
flightlines			Classified lidar point clouds
	ascii	LDR-FW10_02-201010101.txt	ASCII point clouds
	las1.0	LDR-FW10_02-201010101.LAS	LAS1.0 point clouds
	las1.3 (FW only)	LDR-FW-FW10_02-201009801.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			Logsheet as stored in admin/ above
screenshots			Images of the dem and intensity mosaic
		GB08_19-2010_254b_intensity.jpg
		GB08_19-2010_254b_intensity_vectors.jpg
		GB08_19-2010_254b_dem.jpg

Photographic deliveries

Dirs	Example Files	Comments
	COPYRIGHT.txt (deprecated - now in Readme)	Copyright document
	GB08_02-2009_078a.kml	Google earth file containing eagle/hawk/photo positions
	Read_Me-20100202.(txt|pdf)	Instructions for use and description of dataset, plus any problems encountered
doc	data_quality-20091202.pdf	Camera data quality report
	RCD105_Calibration_Certificate.pdf (2010 only)	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