You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Feb 9, 2024. It is now read-only.
In order to validate the image analysis program, the fibermorph package includes two modules that will generate and analyze dummy data, then run the appropriate analysis and generate error data.
97
-
98
-
Both `--demo_dummy` modules require the following flags:
99
-
100
-
```
101
-
-o , --output_directory
102
-
Required. Full path to and name of desired output directory.
103
-
Will be created if it doesn't exist.
104
-
105
-
--repeats Integer. Number of times to repeat validation module
106
-
(i.e. number of sets of dummy data to generate).
107
-
108
-
```
109
-
110
-
The modules create a `fibermorph_demo` within the given path. In this folder there will be another folder named `<MonthDay_HourMinute>_ValidationTest_<Curv or Section>` where the generated dummy images and corresponding parameters in spreadsheets will be in a folder named `ValidationData` and the error data will be in a folder named `ValidationAnalysis`.
111
-
112
-
Running the module once will create a set of data and analyses for a single randomly generated arc and line (for curvature) or circle and ellipse (for section). To produce more data, simply add the flag `--repeats` with the number of times you would like to repeat it, e.g. `fibermorph --repeats <integer>`. This flag is optional.
113
-
114
-
### Validating curvature analysis
115
-
`--demo_dummy_curv`
116
-
117
-
This flag will run a demo of fibermorph curvature with dummy data. Arcs and lines are generated, analyzed and error is calculated.
118
-
119
-
For this module, you can optionally include `--window_size`. This will allow you to edit the window size used to fit the circle used to estimate curvature. By default, this is 10 pixels. The images generated are 3900 x 5200 pixels, and you can use a range of values between 10 and 3900.
120
-
121
-
To run the demo, you can enter e.g. `fibermorph --demo_dummy_curv --output_directory /Users/<UserName>/<ExistingPath>/<NewFolderName> --repeats 4`
122
-
123
-
Rather than repeating this analysis with various window_sizes, you can simply use the curvature module (see below) and set the `--input_directory` to the `/ValidationData` folder created above. You will need to set `--resolution 1`, `--window_size 10`, and `--window_unit px` or whatever number of pixels you would like to use as a window size.
124
-
125
-
### Validating section analysis
126
-
`--demo_dummy_section`
127
-
128
-
This flag will run a demo of fibermorph curvature with dummy data. Arcs and lines are generated, analyzed and error is calculated.
129
-
130
-
To run the demo, you can enter e.g. `fibermorph --demo_dummy_section --output_directory /Users/<UserName>/<ExistingPath>/<NewFolderName> --repeats 4`
131
-
132
-
### Deleting demo folders
133
-
`--delete_dir`
134
-
Can be used to delete directories generated in the demo modules.
135
-
136
-
Example usage: `fibermorph --delete_dir --output_directory /Users/<UserName>/<ExistingPath>/<ResultsFolderName>`
137
-
138
-
This will delete the folder (with all its contents) and print a confirmation of which folder has been deleted.
139
-
140
-
## Using the fibermorph packages
141
-
The main modules of the fibermorph package are `--curvature` and `--section`. Both require the following flags to run:
142
-
143
-
```
144
-
-o , --output_directory
145
-
Required. Full path to and name of desired output directory. Will be created
146
-
if it doesn't exist.
147
-
-i , --input_directory
148
-
Required. Full path to and name of desired directory containing input files.
149
-
--jobs Integer. Number of parallel jobs to run. Default is 1.
150
-
151
-
```
152
-
153
89
### Curvature
154
90
To calculate curvature from grayscale TIFF images of hair fibers, the flag `--curvature` is used with the following flags in addition to input and output directories:
0 commit comments