Class offlineProcessingPlugin
- All Implemented Interfaces:
CommonPluginInterface
,PamPluginInterface
- Author:
- SCANS
-
Field Summary
Fields inherited from interface PamModel.PamPluginInterface
ALLMODES, NOTINVIEWER, VIEWERONLY
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionint
Specifies the type of PAMGuard mode that the plugin is allowed to run in.A brief description of the plugin.The class name of the plugin.Returns the developer's contact emailThe default name of the plugin.Your module may be dependent on data from some other PAMGUARD module.A short description of the plug in module.Returns the name of the developer.Return the name of the helpset file.Returns the name of the jar file holding the plugin.int
Maximum number of instances of this plugin.Due to the large number of PAMGUARD modules now in existence, you may want to have your module listed in one of the sub menus of the File/Add Modules menu.int
Minimum number of instances of this plugin.int
The number of instances to instantiate when this module is loadedThe Pamguard version number that the plugin was developed on.The Pamguard version number that the plugin has been tested on.String containing the tool tip that will be displayed when hovering over the menu item.Returns the version number of the pluginboolean
Whether or not this plugin should be hidden in the menu.void
setJarFile
(String jarFile) Sets the name of the jar file (including path) holding the plugin code.
-
Constructor Details
-
offlineProcessingPlugin
public offlineProcessingPlugin()
-
-
Method Details
-
getClassName
Description copied from interface:PamPluginInterface
The class name of the plugin. This should be the class that extends PamControlledUnit. The correct format is PackageName.ClassName, with no extension on the class name. Thus if the package name is MyFirstPlugin and the class name is MyPluginControl.java, the return should be:return "MyFirstPlugin.MyPluginControl";
This field cannot be null.
- Specified by:
getClassName
in interfacePamPluginInterface
- Returns:
- the class name as a String
-
getDefaultName
Description copied from interface:CommonPluginInterface
The default name of the plugin.This field cannot be null.
- Specified by:
getDefaultName
in interfaceCommonPluginInterface
- Returns:
- the default name of the plugin as a String. Cannot be null.
-
getDescription
Description copied from interface:PamPluginInterface
A short description of the plug in module. This text is used in various informational windows displayed to the user. The value returned here is typically the same as the text returned from thegetDefaultName()
method (e.g. Click Detector or FFT (Spectrogram) Engine).
This is the text used in the main 'Add Modules' menus and is used as the second argument to PamModuleInfo.registerControlledUnitThis field cannot be null.
- Specified by:
getDescription
in interfacePamPluginInterface
- Returns:
- String describing the plugin. Cannot be null.
-
getMenuGroup
Description copied from interface:PamPluginInterface
Due to the large number of PAMGUARD modules now in existence, you may want to have your module listed in one of the sub menus of the File/Add Modules menu. You can add your module to one of the existing groups or you can create a new group of your own. The return string of this method specifies the name of the menu group the plug-in should belong to. Current PAMGuard menus include:- Maps and Mapping
- Sound Processing
- Detectors
- Classifiers
- Localisers
- Displays
- Utilities
- Visual Methods
- Sensors
- Seiche Modules
- Sound Measurements
This field cannot be null.
- Specified by:
getMenuGroup
in interfacePamPluginInterface
- Returns:
- the name of the menu group to include the plugin in. Cannot be null.
-
getToolTip
Description copied from interface:PamPluginInterface
String containing the tool tip that will be displayed when hovering over the menu item.This field cannot be null.
- Specified by:
getToolTip
in interfacePamPluginInterface
- Returns:
- ToolTip, as a String. Cannot be null.
-
getDependency
Description copied from interface:PamPluginInterface
Your module may be dependent on data from some other PAMGUARD module. For example, the click detector requires raw data from an acquisition module, the whistle detector required raw data from a FFT module and the GPS module requires data from an NMEA data source.If the plug-in requires a different module to function, specify that dependent module here (seePamDependency
for the constructors).For example, a dependency on the FFT Engine would be defined as:
return new PamDependency(FFTDataUnit.class, "fftManager.PamFFTControl");
which tells Pamguard that the plug-in is dependent on some source of FFTDataUnit, and that a possible source of this type of data is the fftManager.PamFFTControl module.
If the plug-in has no dependencies, this field should be null.
- Specified by:
getDependency
in interfacePamPluginInterface
- Returns:
- See Also:
-
getMinNumber
public int getMinNumber()Description copied from interface:PamPluginInterface
Minimum number of instances of this plugin. If the minimum number is greater than 0, then PAMGuard will automatically create that number of modules at start-up.This field must be an integer >= 0
- Specified by:
getMinNumber
in interfacePamPluginInterface
- Returns:
-
getMaxNumber
public int getMaxNumber()Description copied from interface:PamPluginInterface
Maximum number of instances of this plugin. PAMGuard will prevent the user from creating more modules than the number specified here. Returning 0 indicates that there is no maximum number of instances.This field can be an integer >= 1 and > the minimum number (to specify a specific number), or 0 (to indicate no limits on the number).
- Specified by:
getMaxNumber
in interfacePamPluginInterface
- Returns:
-
getNInstances
public int getNInstances()Description copied from interface:PamPluginInterface
The number of instances to instantiate when this module is loadedThis field must be an integer >= the minimum number
- Specified by:
getNInstances
in interfacePamPluginInterface
- Returns:
-
isItHidden
public boolean isItHidden()Description copied from interface:PamPluginInterface
Whether or not this plugin should be hidden in the menu. True=hidden, False=visible. Except for rare circumstances, this method should return false.This field cannot be null.
- Specified by:
isItHidden
in interfacePamPluginInterface
- Returns:
- Hide status. True=hidden, False=visible. Cannot be null.
-
getHelpSetName
Description copied from interface:CommonPluginInterface
Return the name of the helpset file. For information on the helpset format, seeinvalid @link
{@link https://docs.oracle.com/cd/E19253-01/819-0913/author/helpset.html
If the helpset file is in a package folder of the plugins folder, make sure to include that in the filename. For example, if the package name is MyFirstPlugin and the help file is MyPluginHelp.hs, the return should be:
return "MyFirstPlugin/MyPluginHelp.hs";
If there is no helpset file, return null.
- Specified by:
getHelpSetName
in interfaceCommonPluginInterface
- Returns:
-
setJarFile
Description copied from interface:CommonPluginInterface
Sets the name of the jar file (including path) holding the plugin code. This method is called fromPamModel.loadPlugins(PamModuleInfo)
for every valid interface file found in the plugins folder.- Specified by:
setJarFile
in interfaceCommonPluginInterface
- Parameters:
jarFile
- String containing the jarFile name and absolute path
-
getJarFile
Description copied from interface:CommonPluginInterface
Returns the name of the jar file holding the plugin. The jarFile String should be declared as a class field, but does not need to be initialised to anything specific as it will be set by Pamguard in thePamModel.loadPlugins(PamModuleInfo)
method when the plugin was first found.- Specified by:
getJarFile
in interfaceCommonPluginInterface
- Returns:
-
getDeveloperName
Description copied from interface:CommonPluginInterface
Returns the name of the developer. Can be company name or individual.- Specified by:
getDeveloperName
in interfaceCommonPluginInterface
- Returns:
- String containing the name of the developer. Cannot be null.
-
getContactEmail
Description copied from interface:CommonPluginInterface
Returns the developer's contact email- Specified by:
getContactEmail
in interfaceCommonPluginInterface
- Returns:
- String containing the developer's contact email. Cannot be null.
-
getVersion
Description copied from interface:CommonPluginInterface
Returns the version number of the plugin- Specified by:
getVersion
in interfaceCommonPluginInterface
- Returns:
- String containing the plugin version number. Cannot be null
-
getPamVerDevelopedOn
Description copied from interface:CommonPluginInterface
The Pamguard version number that the plugin was developed on.- Specified by:
getPamVerDevelopedOn
in interfaceCommonPluginInterface
- Returns:
- String containing the version number of Pamguard that the plugin was developed on. Cannot be null.
-
getPamVerTestedOn
Description copied from interface:CommonPluginInterface
The Pamguard version number that the plugin has been tested on.- Specified by:
getPamVerTestedOn
in interfaceCommonPluginInterface
- Returns:
- String containing the latest version of Pamguard that the plugin has been tested on. Cannot be null.
-
getAboutText
Description copied from interface:CommonPluginInterface
A brief description of the plugin. This will be displayed in the Help>About window. Could include not just a description of the plugin, but also the developer's website and additional contact information.- Specified by:
getAboutText
in interfaceCommonPluginInterface
- Returns:
- String containing a description of the plugin. Cannot be null
-
allowedModes
public int allowedModes()Description copied from interface:PamPluginInterface
Specifies the type of PAMGuard mode that the plugin is allowed to run in. Options are:- Specified by:
allowedModes
in interfacePamPluginInterface
- Returns:
- allowable run modes. Cannot be null
-