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