Creating a New Project

Preparing 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).



New

A project is started by selecting File > New or pressing Ctrl + N on the keyboard.


Select Image Directory


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



Select Image File Format


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