Changes between Version 80 and Version 81 of Procedures/RCDPhotoProcessing

Timestamp:

Feb 6, 2014, 3:31:34 PM (11 years ago)

Author:

mark1

Comment:

--

Procedures/RCDPhotoProcessing

@@ -30 +30 @@
 
 
-=== Delivery Script ===
+=== Image Tagging ===
 
-The script incorporates:
- * Tagging the images with positional and navigational data as well as project information
- * Renaming the images to conform to ARSF standards
- * Generating thumbnail images of the tiffs
- * Creating the final kml
- * Making final version of the eventfile, including removing any lines referring to photos you have removed
- * Creating and populating delivery directory
+Image tagging inserts exiftags into the TIFF files that contain information such as: project details, camera parameters and photograph pos/att information.
 
-Run:
+This is scripted and can be run as follows. 
 
-make_camera_delivery.py -p <main_project_dir> -e <event_file>
+Assuming a CSV file as output from IPASCO - the first thing to do is to fix the header in the csv file (space delimited file with spaces in the header names!):
 
-Check the output then run with --final option.
+{{{rcd_tiff_tagging.py --eventfile <eventfilename> --fixipascoheader <fixedeventfilename>}}}
 
-If the script fails then you will have to fix the problem and try again, or follow the individual stages listed [wiki:RCDPhotoProcessing/RCDPostProcessing here]. Possible causes of failure, excluding the ones previously mentioned above, could be: 
- * SOL file GPS times do not overlap with photograph log file times. Either fix the SOL (if possible) else use the logfile to tag the images (and mention in the Read_Me)
+This creates a new event file with a parseable header. Note that the DEFAULT header is HARD CODED in the script. If it is not the same as the below then you can call the function {{{rcdclasses.FixIPASCOEventFileHeader(filename,newfilename,origheader,newheader)}}} from within python to convert the origheader to the newheader.
+
+Default header:
+{{{
+     ID Event#    GPS Time(s) Easting(degrees) Northing(degrees) Ell Ht(metres) Omega(deg)   Phi(deg)   Kap(deg)    Lat(deg)     Lon(deg)    Xstd(m)    Ystd(m)    Zstd(m)  Ostd(deg)  Pstd(deg)  Kstd(deg)
+}}}
+
+You are now ready to tag the tiffs. '''rcd_tiff_tagging.py''' has a lot of options to help in the tagging of images, but for usual tagging (i.e. in an ARSF repository porject) you (probably :) ) only need to specify the solfile, eventfile and project location. For other options see the --help. First run I suggest you do as the following:
+
+{{{rcd_tiff_tagging.py --eventfile <eventfilename> --solfile <solfilename> --projectlocation <toplevelprojectpath> }}}
+
+If that outputs everything OK (no errors etc) then add {{{--final}}} to the command to actually perform the tagging. Note also that the script can be loaded in as a library of functions, and the accompanying rcdclasses.py library is also of use here. This will also create an updated event file in the same directory as the photographs.
+
+=== Making the Delivery ===
+
+Now that the processing has been completed the delivery can be made. This, as with the hyperspectral and lidar, uses the [wiki:Procedures/DeliveryCreation/pythonlibrary arsf_delivery_library] together with the convenience script make_arsf_delivery.py. An example usage:
+
+{{{make_arsf_delivery.py --projectlocation /users/rsg/arsf/arsf_data/2013/flight_data/uk/MYPROJECT --deliverytype camera --steps STRUCTURE}}}
+
+check that the output looks correct, and if so repeat with {{{--final}}}. This creates an empty structure. Then run:
+
+{{{make_arsf_delivery.py --projectlocation /users/rsg/arsf/arsf_data/2013/flight_data/uk/MYPROJECT --deliverytype camera --notsteps STRUCTURE}}}
+
+This will do a dry-run on the camera delivery and output information clearly labelled for each step. You can then proceed running a single step at a time if you so wish, or run the whole lot together. 
+
 
 === Creating the Read me ===
 
- * The above script will generate a config file for the latex PDF script. If it fails for some reason then run `generate_readme_config.py` with the -d option (giving the delivery directory) and "-r camera" as airborne. 
+ * Run `generate_readme_config.py` with the -d option (giving the delivery directory) and "-r camera" as airborne. 
  * Edit the config (should be located in processing directory). Remember to add information on any photos which could not be tagged fully, or any images which look like they have anomalies or over/under exposure. To add new line characters enter '\\'. Tagtype should be "full" if photos have been tagged with pos/att information or "min" if only tagged with project details. If both types are present in the delivery then use full and in the "data_quality_remarks" section add a sentence explaining which photos have been unable to be tagged with pos/att and why. Line_numbering should contain a space separated list of names/numbers identifying flight lines. 
  * Create the LaTeX TeX file. To create the TeX file use the script create_latex_camera_readme.py with the -f option, giving the location of the config file generated above. This is editable in any text editor and can be manually edited to correct mistakes or insert new text