Description Usage Arguments Details Value References Examples
This function is the core of the GiNA package which is in charge of reading the pictures find in the folder provided and perform the image segmentation in order to find the objects in the picture (i.e. fruits) and measure parameters such as area, perimeter, shape, volume, gray color, red, green and blue color.
1 2 3 |
folder |
A path where the pictures are located |
cutoffvalue |
A scalar value (0-1) where the fruits are distinguishable from the background in the color scale handled by R which is 0-1. if not passed the function will determine the color of the background and assign the value of 0.08 if black and 0.6 if white. We highly recommend to use the |
minArea |
A scalar number indicating the minimum size in pixels for a real object in the picture to avoid the program to confuse some little trash with an object. The function |
cores |
A scalar value indicating the number of cores that you want to use for parallelizing the function |
gray |
a TRUE/FALSE value indicating if the user want the color to bereturned in grayscale besides the RGB color |
stand |
a vector with 2 scalar values for width and length of your references |
fact |
a scalar value between 0-1 indicating at what extent the picture should be reduced in size in order to make computations faster, by default the pictures are sized at the 25 percent of their original size. If no reduction is required the user should set the argument to 1. |
In order to exploit the advantages of this function we highly recommend the users to determine the best cutoff value with the use of the cutoff
function to achieve a good segmentation of the objects. The package is sensitive to the prescense of shades in the picture, for that reason we highly recommend the use of black background and reference circles in a clear color (i.e. white).
This is a rough idea of how you should take the pictures, where the circles are your references and the dots are your fruits. Your fruits shouldn't block the references and YOUR REFERENCES SHOULD BE ALWAYS ON THE SIDES OF YOUR PICTURE.
O . . . . O
O . . . . . O
O . . . . . O
For additional information such as tutorials and most recent releases please visit our website http://cggl.horticulture.wisc.edu/software/.
If parameters are indicated correctly the function returns:
a list of dataframes, one for each picture provided. The dataframe contains the measurements for each object (rows) found in the puncture for the variables (columns) area, perimeter, length, width, shape (ratio of length/width), volume and red, green, blue, grey color.
We have spent valuable time developing this package, please cite it in your publication:
Diaz-Garcia L, Covarrubias-Pazaran G, Schlautman B, Zalapa J. GiNA: A flexible high throughput phenotyping tool. http://horticulture.wisc.edu/cggl/ZalapaLab/People.html. 2015.
1 2 3 4 5 | library(GiNA)
data(GINA.sample) # RUN
writeImage(GINA.sample, "gina_cran.JPG") # RUN
folder <- getwd()
mydata <- scanCRAN(folder,cutoffvalue=0.5,cores=1, fact = 1) # RUN!!!
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.