Skip to content

Commit 10062d9

Browse files
authored
Update README
1 parent d739b38 commit 10062d9

File tree

1 file changed

+39
-1
lines changed

1 file changed

+39
-1
lines changed

README.md

+39-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,39 @@
1-
# flowjo-plugin-data-dump
1+
## FlowJo Data Dump Plugin
2+
3+
Note: This plugin is to be used in conjuction with [flowjo-plugin-testbed](https://github.com/nicbarker/flowjo-plugin-testbed)
4+
5+
### Usage
6+
- Download the plugin .jar from the releases page
7+
- Place it in your `/Applications/plugins` directory or windows equivalent
8+
- Start FlowJo
9+
- Select a sample or node then click Workspace -> Plugins -> FlowJoPluginDataDump
10+
- It will save files to the output folder and give you a popup window that says something like this:
11+
- Import [flowjo-plugin-testbed.jar](https://github.com/nicbarker/flowjo-plugin-testbed) and call the following on your plugin:
12+
```Java
13+
invokeAlgorithm(FlowJoPluginTestbed.getFcmlFromFile("/some/directory/FlowJo Plugin Data Dump/fcmlQueryElement.xml"), FlowJoPluginTestbed.createFileObject("/some/directory/FlowJo Plugin Data Dump/st_HM-1_CHECK192_001..ExtNode.csv"), FlowJoPluginTestbed.createFileObject("/some/directory/FlowJo Plugin Data Dump"));
14+
```
15+
In your plugin, create a main function and call the `invokeAlgorithm()` from the previous step
16+
```Java
17+
public static void main(String[] args) {
18+
YourPlugin plugin = new YourPlugin();
19+
try {
20+
plugin.invokeAlgorithm(FlowJoPluginTestbed.getFcmlFromFile("/some/directory/FlowJo Plugin Data Dump/fcmlQueryElement.xml"), FlowJoPluginTestbed.createFileObject("/some/directory/FlowJo Plugin Data Dump/st_HM-1_CHECK192_001..ExtNode.csv"), FlowJoPluginTestbed.createFileObject("/some/directory/FlowJo Plugin Data Dump"));
21+
} catch (IOException e) {
22+
e.printStackTrace();
23+
}
24+
}
25+
```
26+
27+
- You'll now be able to use standard Java development and debugging practise to test if your plugin works.
28+
29+
### Rationale
30+
The standard cycle for developing and debugging [FlowJo](https://www.flowjo.com/) plugins can be quite painful, and usually involves some variation of the following:
31+
32+
- Build a fat .jar file including dependencies for your plugin
33+
- Copy it into your `/Applications/plugins` directory or windows equivalent
34+
- Start FlowJo from the command line
35+
- Open your workspace
36+
- Wait for FlowJo to finish scanning for .jar files
37+
- Run the plugin and check the console for errors
38+
39+
Sometimes this process can take upwards of 5 minutes for a single round trip, which is not feasible if you're developing a plugin or have a programming style that requires a lot of back and forth debugging. By using this in combination with [flowjo-plugin-testbed](https://github.com/nicbarker/flowjo-plugin-testbed), you'll be able to get quick debugging

0 commit comments

Comments
 (0)