Skip to content
This repository was archived by the owner on Feb 9, 2024. It is now read-only.

Commit a2e3c9d

Browse files
authored
Merge pull request #12 from tinalasisi/updates
Updates
2 parents 05fe9ba + 103f04a commit a2e3c9d

2 files changed

Lines changed: 2 additions & 66 deletions

File tree

README.md

Lines changed: 1 addition & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,7 @@ For those who want to run the program immediately, just follow these commands in
1818
and
1919

2020
`fibermorph --demo_real_section --output_directory /Users/<UserName>/<ExistingPath>/<NewFolderName`
21-
5. Test fibermorph with dummy data and check the error in the spreadsheets generated with the command.
22-
`fibermorph --demo_dummy_curv --output_directory /Users/<UserName>/<ExistingPath>/<NewFolderName> --repeats 2`
23-
24-
and
25-
26-
`fibermorph --demo_dummy_section --output_directory /Users/<UserName>/<ExistingPath>/<NewFolderName> --repeats 2`
27-
6. Use fibermorph on your own grayscale TIFFs of longitudinal or cross-sectional hair images.
21+
5. Use fibermorph on your own grayscale TIFFs of longitudinal or cross-sectional hair images.
2822

2923
`fibermorph --curvature --input_directory /Users/<UserName>/<ImageFolderPath> --output_directory /Users/<UserName>/<ExistingPath>/ --window_size 0.5 --window_unit mm --resolution 132 --save_image --within_element --jobs 2`
3024

@@ -92,64 +86,6 @@ This flag will run a demo of fibermorph section analysis with real data. You wi
9286
To run the demo, you will input something like:
9387
`fibermorph --demo_real_section --output_directory /Users/<UserName>/<ExistingPath>/<NewFolderName`
9488

95-
## Calculating image analysis error
96-
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-
15389
### Curvature
15490
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:
15591
```

fibermorph/_version.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
__version__ = "0.1.7"
1+
__version__ = "0.1.9"

0 commit comments

Comments
 (0)