.jyds extensions

From autoplot.org

Jump to: navigation, search

Purpose: introduce jyds extensions

Audience: jyds script writers using jyds scripts to implement data sources.

Contents

  1. Introduction
  2. Releasing the script
  3. Debugging
  4. Examples

1. Introduction

Sometimes a jyds script is all that's needed to provide a satisfactory data source, and a scientist wants to make it available to everyone using Autoplot. Autoplot 2018 now allows "jyds extensions" to quickly implement a new data source, associating a file extension, such as ".sps", with a .jyds reader. This was introduced to read .sps and spd files used with RadioJove, where the scientist is maintaining the script which reads the files.

2. Releasing the script

  • copy must be in svn or github which is modifiable by the Autoplot team.
  • Autoplot team will have to approve the extension which will trigger (e.g. wdc is world data center files).
  • Autoplot team will have to modify code to use this site.

3. Debugging

If the environment variable "jydsExtension_<EXT>" is set, then this alternate version of the script will be used. Logger apdss.jyds will report what script is actually used.

System.setProperty("jydsExtension_sps","")

System.setProperty("jydsExtension_sps","file:/home/jbf/project/earth/svn/public/jyds/readTypeSps.jyds")

4. Examples

The extension .sps is associated with the jyds script https://saturn.physics.uiowa.edu/svn/earth/public/jyds/readTypeSps.jyds. (Increase the logging for apdss.jyds to see the source.) This is done by adding ".sps" to the META-INF file org.autoplot.datasource.DataSourceFactory.extensions, and modifying JythonExtensionDataSourceFactory.java to delegate to the script. TODO: This should be modified so that no Java code is needed to configure.

Personal tools