-
Notifications
You must be signed in to change notification settings - Fork 2
Use Cases
This document outlines the different ways you should configure the input CSV in order to produce the desired output. For what each csv setting is, please see CSV Parameters
These are the general settings which apply to every form of time streaming you can do.
The input directory is denoted as SOURCE in the csv file. This will be the directory where we will look for images.
The output directory is denoted as DESTINATION in the csv file. This is where we will output our time streams to. It is best to think of the output as four parts. The output directory, then the time stream format, then the year / month / day folders, then finally the file name itself. With the exception of the year / month / day folders, each of these is fully customizable.
The Archive directory is denoted as ARCHIVE_DEST in the csv file. If the Archive mode is selected, then this will store all of the unprocessed images. This will be done before any resizing, or rotating.
These fields are useful if you only wish to look at images between specific dates, or times. All images which fall outside of EXPT_START and EXPT_END date range, will not be processed at all. The same can be said for times entered in SUNRISE and SUNSET.
Therefore, if we had the follwing values:
- Sunrise: 11:01
- Sunset: 11:03
- Expt_Start: 06/10/2015
- Expt_End: 06/10/2015
and the following 5 image times:
- 11:02 05/10/2015
- 11:00 06/10/2015
- 11:02 06/10/2015
- 11:04 06/10/2015
- 11:02 07/10/2015
Then only Image 3 would be processed.
It is also possible to filter images based on a string value. This is entered into the FN_PARSE value in the csv. This option is useful when images are not stored according to their camera, but rather by date, or folders based on when they were copied from a hard drive. This value works by ONLY processing images which have the string value entered in FN_PARSE somewhere in their Global file path.
If you had the following folder structure storing two cameras (Overstory_Nadir, and Understory Nadir):
-- Images -- Field_Photos -- 2015_06_06 -- Overstory_Nadir -- <Images>
\ \ Understory_Nadir -- <Images>
\
\ 2015_06_08 -- Overstory_Nadir -- <Images>
\- Understory_Nadir -- <Images>
Rather than having four values in the CSV, you can simply have one for each camera using the FN_PARSE parameter. The following values would be needed in overstory CSV entry:
- SOURCE: Images/Field_Photos
- FN_PARSE: Overstory
This would ignore all images in the Understory folders, as it doesn't have the FN_Parse value in their file path. However, if you had a FN_PARSE value of "erstory" Then all images would be used, as "erstory" is in all the global file path.
Sometimes its useful to shift all times and dates of images. This can be useful when images are recorded in UTC, but you wish to display them in local time. The csv parameter is called TIMESHIFT Simply enter the number of hours you wish to offset by. So if you wish to shift everything forward 2 hours, enter 2.
If you wanted to shift everything backwards by one day, then simply enter -24 as the value.
We can tell the program to only specifically time stream a particular image type. This is done by the IMAGE_TYPE csv parameter.
Each image type you want to process needs to be separated by a ~ character. So if you wanted to process only jpg images, then your IMAGE_TYPE value would be jpg. However if you wanted to process jpg and raw images, then the value should be jpg~raw
Sometimes images don't have the date taken stored in the image metadata, instead storing it in their filename. In this case, you will need to enter a FILENAME_DATE_MASK csv parameter.
This is a string value which stores how to get the date from the filename. Character meanings can be found here.
If the string was
20120901_122732 meaning the 12:27:32, 1st of September, 2012, then your FILENAME_DATE_MASK would be
%Y%m%d_%H%M%S
This section describes the different ways you can customise the output of the program.
When dealing with the output, its best to think of it as four separate parts. Destination, Timestream Strucutre, Date folders, and Filename.
/images/Timestreams/BVZ-0000/Original/Location-C01~fullres-orig/2015/2015_11/2015_11_01/BVZ00000-Location-C01~fullres-orig_2015_11_01_12_12_12.jpg
| DESTINATION | TS_STRUCTURE |COMPULSORY |COMPULSORY Date folders| FN_STRUCTURE | COMPULSORY |
The destination path is set by the DESTINATION csv parameter, however this will not be generated by the program. The compulsary parts are not editable. These are required by the timestream viewers. However, the TS_STRUCTURE and FN_STRUCTURE parts are editable.
This field determines everything from the destination, up to the ~{res}-{step} fields. This field CAN have folder separators, but CANNOT have underscores. This field is also a Replacable Parameters field. This means that fields in capitals will be replaced with their actual value.
If you wish to have a separate folder for original images, and resized images, then you will need to enter {folder} where you wish this split to occur.
The default value (or value entered if TS_STRUCTURE is blank) for TS_STRUCTURE in the CSV is EXPT/LOCATION/{folder}/EXPT-LOCATION-CCAM_NUM-DATASETID
No matter what you enter for this field, it will ALWAYS be appended with ~{res}-{step} automatically. This is not optional.
The FN_STRUCTURE csv parameter determines the editable portion of the filename. This is a Replacable Parameters field. This value determines everything up to the ~{res}-{step} portion. This portion is Always added.
The FN_STRUCTURE CANNOT contain any folder separators, or underscores.