Creating a New Project
Before a new project can be started in Rootfly, the root images must be prepared for use by 1) assigning their filenames to adhere to a common convention that Rootfly can use and 2) placing all of the project images into a single directory.
For example, the Bartz ICAP uses the filename format
experiment_T[tube #]_L[window #]_[session date]_[time]_[session #]_[initials].[image format]. In Rootfly, this image file format is equivalent to: [expt]_T[tube]_L[win]_[yyyy.mm.dd]_[time]_[sess]_[user].[jpg/bmp]. In practice, an image file of this format may appear as: EXPERIMENT_T001_L000_2007.05.09_070000_001_CBD.jpg.
Rootfly is able to accommodate various filename conventions. Since the user is able to specify the locations of particular "blocks" of information in their image filenames (e.g., [tube number], [window number], and [time]), no one format is required. The list below describes the 'blocks' of information that Rootfly understands and will expect when a user requests to use their images.
- Each block may be prefaced by a prefix (like the T before tube number, or the L before window number in the Bartz format above).
- Blocks must be delimited with a special character. The default delimiter (as shown above) is the underscore ("_").
Block Name |
Block Convention |
Examples |
Required? |
Experiment Name |
None. |
Experiment 5 |
No |
Tube Number |
Numbers only. |
001 |
Yes |
Window Number |
Numbers only. |
012 |
Yes |
Session Date |
The ordering of the year, month, and day can be set at the user's option. The user may also specify a delimiter between each. The year may be 2 or 4 digits; the month and day must be specified in 2 digits. |
1999.12.31 12.31.99 31_12_1999 |
No |
Image Capture Time |
None. |
12:59:59 |
No |
Session Number |
Numbers only. |
000 |
Yes |
User Initials |
None. |
CRR |
No |
Unused (Miscillaneous) |
None. |
No |
Only the blocks required by Rootfly can be used by the program (with the exception of the session date), therefore it is not necessary to provide all fields if the files do not already possess them. Since other fields are unused, they have no convention and are ignored (just be sure that the filename delimiter is not used or Rootfly will assume that the block has ended and begin reading the next).
New
A project is started by selecting File > New or pressing Ctrl + N on the keyboard.
To tell Rooyfly the images necessary for the project, the directory containing the root images needs to be specified. After New has been pressed, the "Browse For Folder" directory will show. Find the image directory, select it, and press "OK."
Image: Browse For Folder
After the root image directory is specified, the user will be asked to select the image file format from the following dialog box:
Image: Select Image Format
This is where the user will tell Rootfly the convention of their root image filenames established in the preparing images section.
Note: As changes are made to the file format, a preview of the current format is updated at the bottom ("Format:").
- Pressing the "Date Format" button will bring up the "Modify Date Format" dialog box (shown below). Using this, the user can set the order the month, day, and year appear in the file format, the number of digits in the year, and the delimiter between the three date elements.
Image: Modify Date Format
Copyright © 2005-2009, Clemson University
This help file has been generated by the freeware version of HelpNDoc