CanopyDigi Control List

Program Overview

CanopyDigiControlList.exe exists simply to control the other programs in the suite, and to guide the user through the process of image analysis in a straightforward manner. It can be accessed directly, or, preferably, from a shortcut placed on the Desktop.

Procedure
The program will process all photographs in the OriginalBMP folder, so this folder should not contain any files or photographs other than those to be processed (which, as detailed above, should be in monochrome BMP format at a resolution of 640*480 pixels). The programs will not delete anything from this folder.

There are two sets of programs that can be run through the CanopyDigi Control List and programs from each section (Determination and Quantification) should be used in sequence. These sections are briefly described below, but for a detailed description please see the appropriate help file.

Determination Section
1. CanopyDigiThresholdSet - This option converts photographs into their false colour equivalents at eight different thresholds. No user interaction is needed once the program has started.

2. CanopyDigiThresholdChoose - This option requires user interaction. The program displays each original photograph and its associated eight false colour images, in sequence. This enables the user to select the most appropriate false colour image, which can then be saved (with the click of a button) for further processing.

Quantification Section
This option processes the selected false colour images – no user interaction is needed once the program has started. Initially each false colour image is electronically divided into twelve sub-images. As the program runs, it produces a text file for each group of twelve sub-images giving statistical information. In addition, a single CSV (comma separated variable) file is constructed giving all necessary percentage and aggregation information for every original photograph analysed in a given run of the program. This can be loaded straight into a spreadsheet program (e.g. Microsoft Excel) or statistical software (e.g. SPSS or Minitab) for further analysis.

Buttons
Buttons are provided for each of the options mentioned. In addition there are two small buttons (top left) that can be used to adjust the size of the screen slightly, if required.

Input
As this program merely controls other programs, there is no direct input. However, the user must ensure that all the photographs required for processing, and only those, are copied to the OriginalBMP folder before proceeding further.

Output
There is no direct output from this program, it simply controls the other programs in the suite.

Technical Comments
The structure within C:\CanopyDigi (or equivalent) MUST be as follows:  

Folders required

 

OriginalBMP

Supplied empty

ProcessedBMP

Supplied empty

CalculateDone

Supplied empty

CalculateHistoric

Supplied empty

 

 

Files required

 

CANOPYDigiCALCULATE.chm

Help File

CANOPYDigiControllist.chm

Help File

CANOPYDigiThresholdchoose.chm

Help File

CANOPYDigiThresholdSet.chm

Help File

CanopyDigiControlList.exe

Program File

CanopyDigiThresholdChoose.exe

Program File

CanopyDigiThresholdSet.exe

Program File

CanopyDigiCalculate.exe

Program File

ThresholdsDefault.txt

Text File – required

ThresholdsUser.txt

Text File – required

CanopyDigiThresholdChooseInputs.txt

Text File – required

 

 

Files- not required, possibly useful

 

CanopyDigiThresholdChooseInputs4.txt

Text File

CanopyDigiThresholdChoose4SafetyCopy.txt

Text File – safety copy

CanopyDigiThresholdChoose9SafetyCopy.txt

Text File – safety copy

ThresholdsDefaultSafetyCopy.txt

Text File – safety copy

ThresholdsUserSafetyCopy.txt

Text File – safety copy

-End of Help -