|
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