-
Notifications
You must be signed in to change notification settings - Fork 5
UNH PhenoCam Tools
The University of New Hampshire hosts some tools for working with PhenoCam imagery in the Tools section of their PhenoCam website. This page describes relevant tools and their use.
The PhenoCam Image Processor is a MATLAB application with a Graphical User Interface. This tool is designed to allow the user to easily browse PhenoCam images, define regions of interest, and calculate a time series of Green Chromatic Coordinate values.
Note: official installation notes are available in the PhenoCamGUI_UserGuide.pdf included in any download of the application.
If one has access to MATLAB, the PhenoCam Image Processor MATLAB source code can be used directly. Simply add the folder containing the downloaded source code to your MATLAB path using the path command, and then enter phenocamimageprocessor. For example, if you download the source to C:\Users\username\Matlab\PhenoCamGUI, one would use the following code to run the application:
path(path, 'C:\Users\username\Matlab\PhenoCamGUI')
phenocamimageprocessorAlternatively, change directory to the folder containing the application source code, and then run the application:
cd C:\Users\username\Matlab\PhenoCamGUI
phenocamimageprocessorPre-compiled versions of the PhenoCam Image Processor are available for Windows 32 and 64 bit systems, and MacOSX. Simply download the correct version for your system, and extract the contents of the zipped download to an installation directory.
Once Extracted, run the included executable (phenocamW[32/64]_pkg.exe in windows or run_PhenoCamGUI_maci64.sh for Mac) and follow the self-guided directions. Note that you will need to install the MATLAB runtime libraries as part of the installation process.
The following sub-sections explain the use of the PhenoCam image processor GUI, in roughly the order of use.
Clicking on the Set Dir button will open a directory selection window. Select a directory containing a SINGLE year's worth of image data. The GUI is designed for working with one year of data at a time, and will throw an error if an incompatible directory structure is encountered.
On the right-hand side of the application, under the 'Input' frame and below the Set ROI and Clear ROI buttons, is a list of images found after setting the input directory. Clicking on an image's name will change the displayed image to that image.
Up to three ROIs can be drawn in the image for analysis. To set the number of ROIs, use the dropdown next to the Set Dir button.
Clicking the Set ROI button will change the mouse cursor to a polygon drawing crosshair. Select points to define a polygon representing a region of interest in your image. Double-click to finalize the polygon. The polygon draw crosshairs will return to a normal mouse pointer once all ROIs have been defined.
The Clear ROI button will clear all defined ROIs. Use this if a mistake in ROI creation is made.
The calculation options determine how the Green Chromatic Coordinate will be calculated for the selected ROI(s).
More info soon.