Skip to content

Commit

Permalink
Update DataGuide_AAPF_RGB.md
Browse files Browse the repository at this point in the history
  • Loading branch information
oh231 authored Jun 28, 2024
1 parent 212de4c commit e4e50d5
Showing 1 changed file with 20 additions and 35 deletions.
55 changes: 20 additions & 35 deletions DataGuide_AAPF_RGB.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ The data includes RGB and fluorescence images of plants along with derived morph

Individual files (interim data products) are located under subdirectories. Filenames follow a specific format that encodes information about the data:

`VIS_<Data_Type>_<POT_BARCODE>_<Time_In>_<RGB|FLUO>-<View>-<Ang>-<Img_Product>_<Exp_No>_<Treatment>_<Time_Out>.{png|csv}`
`VIS_<Data_Type>_<POT_BARCODE>_<Time_In>_<RGB_FLUO>-<View>-<Ang>-<Img_Product>_<Exp_No>_<Treatment>_<Time_Out>.{png|csv}`

Example: VIS_V_2401323_240226103000057_RGB-SideSmall-30-MES_394_SandSoybeanHigh_240226105925431.png

Expand Down Expand Up @@ -83,49 +83,34 @@ Example: VIS_V_2401323_240226103000057_RGB-SideSmall-30-MES_394_SandSoybeanHigh_

These image files visually represent morphological measurements on the vegetation segments. Color overlays indicate different aspects:




- `Gray (pixels)`: vegetation pixels segmented
- `Green (Polyline)`: Smallest enclosing rectangle of the vegetation segments
- `Blue (Polyline)`: Convex hull (smallest enclosing polygon) of the vegetation segments
- `Red (Pollyline)`: Pixel-wise boundary of vegetation segments
- `Cyan (point)`: Center of mass coordinate



### How to Read Information in spreadsheet files (.xlsx for masterfile or csv file for individual measurements)

The spreadsheets contains various phenotypic measurements derived from the RGB images and auxiliary measurement info. Here's a breakdown of the column headers:

- `frame_nr`
- Frame number from 0-11 for side view data
- `Angle`
- Side view angle where the vegetation is most dispersed
- `Width`, `Height`
- Dimensions of the green box in the corresponding "MES" file
- `Surface`
- Area of the vegetation measured by the red polygon (Section 2)
- `Convex hull`
- Area of the convex hull measured by the blue polygon
- `Roundedness`
- Roundness of the red polygon (❗ calculation method unclear)
- `Center_of_mass_distance`
- ❗ Unclear meaning
- `Center_of_mass_x`, `Center_of_mass_y`
- Coordinates of the center of mass point
- `Hue, Saturation`, `Intensity`
- Average values for these color properties in the image
- `Fluorescence`
- Average fluorescence intensity
- `H###`, `S##`, `V##`
- Frequency of pixels with specific hue (###: 0-359), saturation (##: 0-99), and value (##: 0-99)
- Check the definitions of hue, saturation, and value in [this link](https://changingminds.org/explanations/perception/visual/hsl.htm)
- `F##`
- Frequency of pixels with a specific fluorescence value (##: 0-99)
- `View`
- TOP FRAME: Ignore this row
- TOP AVG: Data from the top view
- Side{Bottom, Small, Top, Full} FRAME 0 to 11: Data from various side view angles (0, 30, ..., 330 degrees)
- Side{Bottom, Small, Top, Full} AVG: Average of Side view FRAME data

| Column Head | Description |
|-------------------|-------------------------------------------------------------------------------------------------|
| `frame_nr` | Frame number from 0-11 for side view data |
| `Angle` | Side view angle where the vegetation is most dispersed |
| `Width`, `Height` | Dimensions of the smallest enclosing rectangle of the vegetation segments |
| `Surface` | Area of the vegetation within the pixel-wise boundary of vegetation segments |
| `Convex hull` | Area of the convex hull measured by the smallest enclosing polygon of the vegetation segments |
| `Roundedness` | Roundness of the red polygon (❗ calculation method unclear) |



| `Center_of_mass_distance` | ❗ Unclear meaning |
| `Center_of_mass_x`, `Center_of_mass_y` | Coordinates of the center of mass point |
| `Hue, Saturation`, `Intensity` | Average values for these color properties in the image |
| `Fluorescence` | Average fluorescence intensity |
| `H###`, `S##`, `V##` | Frequency of pixels with specific hue (###: 0-359), saturation (##: 0-99), and value (##: 0-99)<br>Check the definitions of hue, saturation, and value in [this link](https://changingminds.org/explanations/perception/visual/hsl.htm) |
| `F##` | Frequency of pixels with a specific fluorescence value (##: 0-99) |
| `View`| TOP FRAME: Ignore this row<br>TOP AVG: Data from the top view<br>Side{Bottom, Small, Top, Full} FRAME 0 to 11: Data from various side view angles (0, 30, ..., 330 degrees)<br>Side{Bottom, Small, Top, Full} AVG: Average of Side view FRAME data |

0 comments on commit e4e50d5

Please sign in to comment.