Skip to content

Commit 82ca341

Browse files
authored
Merge pull request #24 from ssec-jhu/add-ui-docs
added some documentation for running the plugin to the README
2 parents 84a48c6 + c1dfdb1 commit 82ca341

File tree

6 files changed

+42
-7
lines changed

6 files changed

+42
-7
lines changed

README.md

Lines changed: 42 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,6 @@ Place the `jar` file into the `plugins` folder for you ImageJ installation.
2626

2727
Open ImageJ and select `Plugins` from the top menu, then select `FLFM Plugin`.
2828

29-
30-
3129
> [!TIP]
3230
> ISSUES DETECTING GPU?
3331
> Sometimes there can be an issue with the detection of the GPU when running the
@@ -91,15 +89,52 @@ make clean
9189

9290
### Run
9391

94-
#### Docker:
95-
(TODO)
92+
This plugin can be run as a standalone jar and as an ImageJ 1.x plugin
93+
with the latter being the general use case and the former being more
94+
helpful for debugging and testing, but functional nonetheless.
9695

97-
#### Locally:
98-
(TODO)
96+
#### ImageJ 1.x Plugin
97+
98+
To run this in ImageJ 1.x, copy the `.jar` for your OS
99+
`flfm_plugin.<linux|windows>.jar` into the `plugins` folder in your ImageJ
100+
installation, then start ImageJ.
101+
102+
#### Standalone
103+
104+
Using Java 8, the jar can be run directly using:
105+
106+
```bash
107+
java -jar flfm_plugin.<linux|windows>.jar
108+
```
109+
110+
Where `<linux|window>` should be replaced with the OS you're running it on.
99111
100112
### Usage:
101-
(TODO)
102113
114+
The standalone jar opens directly to the FLFM PLugin UI, if it's being run as
115+
an ImageJ plugin there is a single step to get to the plugin.
116+
117+
Open ImageJ and from the *Plugins* menu select `FLFM Plugin`:
118+
119+
![imagej-plugin-select](docs/_static/imagej_plugin_menu.png)
120+
121+
This will open the FLFM Plugin Menu:
122+
123+
![imagej-plugin-select](docs/_static/plugin_menu.png)
124+
125+
To use the plugin populate the fields with the desired values and click **Calculate**
126+
127+
![imagej-plugin-guide](docs/_static/plugin_ui_guide.png)
128+
129+
**NOTE on image selection**
130+
131+
When you try to select an image, the Plugin will first try to get an image
132+
already opened in ImageJ with the following menu popping up:
133+
134+
![plugin-img-selector](docs/_static/plugin_ui_img_selector.png)
135+
136+
If the plugin doesn't detect any open ImageJ images or if you close the menu,
137+
the plugin will open a file selector menu to select an image from disk.
103138
104139
# Testing
105140
41.7 KB
Loading

docs/_static/plugin_menu.png

18 KB
Loading

docs/_static/plugin_ui_guide.png

92.4 KB
Loading

docs/_static/plugin_ui_guide.xcf

285 KB
Binary file not shown.
11.6 KB
Loading

0 commit comments

Comments
 (0)