Prepare Images
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).
Copyright © 2005-2009, Clemson University
This help file has been generated by the freeware version of HelpNDoc