Difference between revisions of "AnyWave:CLI runPlugin"

From WikiMEG
Jump to: navigation, search
(Created page with "=Process files= AnyWave can also process data files, running a specific process (plugin) to a bunch a files or directories.<br/> The keyword to do that kind of opteration is :...")
(Process files)
Line 5: Line 5:
 
To run a plugin, the user must set all the required parameters as well as input and output options.<br/>
 
To run a plugin, the user must set all the required parameters as well as input and output options.<br/>
 
The other requirement is that the plugin CAN run in batch mode.<br/>
 
The other requirement is that the plugin CAN run in batch mode.<br/>
See the dedicated section to see how to make your plugin compatible or simply browse the list of compatible built-in plugins.<br/>
+
[[AnyWave:CLI_PluginList|List of CLI compatible plugins]]
There is a list of common command line keywords that can be used anytime by every plug-ins:<br/>
+
 
'''--input_file <file>''' set the file to process.<br/>
+
'''--input_dir <dir>''' sets the input directory to use.<br/>
+
'''--output_dir <dir>''' sets the output directory. The location where the plugin should generate its results.<br/>
+
'''--output_file <file>''' sets the name of the processing output file.<br/>
+
'''--output_prefix <string>''' sets the prefix of the output file.<br/>
+
'''--hp <value>''' sets the high pass filter value to use.<br/>
+
'''--lp <value>''' sets the low pass filter value to use.<br/>
+
'''--notch <value>''' sets the notch filter value to use.<br/>
+
<br/>
+
 
==Setup parameters and run a processing plugin==
 
==Setup parameters and run a processing plugin==
 
Processing a file relies on a specific plugin which need to be setup using specific parameters.<br/>
 
Processing a file relies on a specific plugin which need to be setup using specific parameters.<br/>

Revision as of 12:51, 14 April 2020

Process files

AnyWave can also process data files, running a specific process (plugin) to a bunch a files or directories.
The keyword to do that kind of opteration is :
--run <plugin name | json file | json string>
To run a plugin, the user must set all the required parameters as well as input and output options.
The other requirement is that the plugin CAN run in batch mode.
List of CLI compatible plugins

Setup parameters and run a processing plugin

Processing a file relies on a specific plugin which need to be setup using specific parameters.
There are several ways to setup plugin parameters and run it:
1. use a json file to describe all the parameters.
2. use a json string to describe all the parameters.
3. use a plugin which declares its parameters.

Examples:
Suppose we want to run a processing using a plugin named ProcessPlugin.
This ProcessPlugin requires two parameters, a time window (s) and a threshold value.
The expected parameters are : time_window, threshold.
If the plugin published its required arguments to AnyWave, you can do :

anywave --run ProcessPlugin --input_file d:\data\my_file.eeg --time_window 4 --threshold 0.3

Note the input_file common keyword that set the data file to be processed by the plugin.
If the command fails, you'd probably need to use the json way:
Create a parameters.json file as follow:

{ 
"plugin" : "ProcessPlugin",
"time_window" : 4,
"threshold" : 0.3
}

and use the command line:

anywave --run parameters.json --input_file d:\data\my_file.eeg

This way AnyWave will read the parameters from the json file and setup the plugin accordingly.
Note the you can also use the common keywords inside your json file:

{ 
"plugin" : "ProcessPlugin",
"input_file" : "d:\\data\\my_file.eeg",
"time_window" : 4,
"threshold" : 0.3
}

Although it does not make sense there to specify input_file, you can do it. You can also write down the json string on the command line after the --run keyword:

anywave --run "{ """plugin""" : """ProcessPlugin""", """time_window""" : 4, """threshold""" : 0.3 }" --input_file d:\data\my_file.eeg