Current status

Normally tools are invoked from their tool pages with no arguments (i.e. parameters passed to them). There are exceptions where the tool is started with selected parameters. The best example of this is the indeed viewer that plots sensor measurement data on nees.org.

Indeed can be started from

• the indeed tool page with no arguments.
• a link to a data file in the Project Warehouse.
• a database viewer where the user can select multiple data files.

Current Implementation

This is implemented by a simple file mechanism.

Step 1: Add a list parameter to the "invoke" URL

The "invoke" URL of indeed (​https://nees.org/tools/indeed/invoke) is augmented with a "list" parameter. The parameter can be set statically (e.g. Project Warehouse pages) or dynamically (e.g. database viewer).

Here is an example of a static link.

 http://nees.org/tools/indeed/invoke?list=/nees/home/NEES-2005-0022.groups/Experiment-2/Trial-6/Rep-1/Corrected_Data/NEES-0022_RWN_Sensor_Corrected_Data.csv&return=L3dhcmVob3VzZS9leHBlcmltZW50cy8yMg==

The list parameter contains one item which is the file name.

 list=/nees/home/NEES-2005-0022.groups/Experiment-2/Trial-6/Rep-1/Corrected_Data/NEES-0022_RWN_Sensor_Corrected_Data.csv

Step 2: A web plugin processes the list argument and creates file.

A plugin specific to indeed (/www/neeshub/plugins/mw/indeed.php) has been created to process the list parameter. The plugin creates a file /apps/projects/workingdir/user/file where user is the name of the user. This means that the user must be logged into the website before they can run indeed. The plugin will take you to the login page if you are not already logged in. The format of the file is that each element of the list is written on its own line. It the file contains two parameters, there will be two lines to the file. The purpose here was to make parsing very simple since it's the tool that will be doing.

Step 3: The tool is invoked and reads the file.

It is up to the tool to check it the file /apps/projects/workingdir/user/file exists and to read its contents.

• indeed must first check if the file exists. If indeed is launched from the tool page, there will be no file. Also because of NFS delays, the file may not be accessible by the execution host when indeed is first launched. indeed waits and polls for the existence of the file. It will give up after some number of tries.
• indeed reads the file and processes each line as a data file name.
• indeed deletes the file to indicate that it has processed the data and so that the parameters are not used by another invocation.

Problems with the current implementation

• The tool has to poll for the existence of the file even in cases where there may not be one.
• Read and write access is needed to read and delete the file. This means the file systems /apps must be mounted read/write.
• The file can be overwritten by other tools or invocations of indeed.
• Must create a plugin for each tool that wants to accept parameters.
• Some advanced uses are not possible or extremely difficult due to the careful input validation needed when sending things, e.g. commands, through the client web browser.