nsgportal graphical user interface: pop_nsg
Interaction with key function in EEGLAB is mostly supported through both, command line and graphical user interface (GUI). The plugin nsgportal also follows this philosophy. In this section, we introduce the GUI supporting the plugin nsgportal through its main function, pop_nsg. A more advanced tutorial on using the plugin from its GUI will be addressed in the next sections (see here).
The pop_nsg GUI
To call the pop_nsg GUI, simply type pop_nsg from the MATLAB command windows. The GUI depicted below will pop up. the GUI can also be invoked from the EEGLAB main GUI by clicking Tools > NSG Tools > Manage NSG jobs. For this, the plugin nsgportal has to be installed before (see this section).
The main functionalities supported from the pop_nsg GUI are listed below:
- Submit an EEGLAB job to NSG. See GUI section “Submit new NSG job”
- Test NSG jobs locally on your computer.
- Delete jobs from your NSG account
- Download NSG job results.
- Load results from a completed and downloaded NSG job.
- Visualize error and intermediate logs
- Access pop_nsg help.
GUI main sections
Submitting new NSG job
From this section of the GUI you will be able to test and submit a job for processing in NSG.
Component list:
- Edit Job folder or zip file : Full path to the zip file or folder for a job to submit to NSG
- Button Browse: Browse a zip file or folder for a job to submit to NSG
- Edit Matlab script to execute: Matlab script for NSG to execute upon job submission
- Button Test job locally: Test job locally on this computer. A downscaled version of the job MUST be used.
- Edit Job ID (default or custom): Unique identifier for the NSG job. Modify this field at your convenience.
- Edit NSG run options (see Help): NSG options for the job to be submitted. See » pop_nsg help for the list of all options.
- Button Run job on NSG: Submit the job to run on NSG
Interacting with your jobs
From this section of the GUI, you will be able to interact with the jobs submitted to NSG under your credentials. This section is comprised of the following components:
- Button Refresh job list: Refresh the list of all of your NSG jobs.
- Checkbox Auto-refresh job list: Automatically refresh the list of all of your NSG jobs.
- Button Delete this NSG job: Delete the currently selected job
- List box Select job: List of all jobs under your credentials in NSG. A color code is used here to inform on the status of the jobs in this list. The legend can be found below the list box.
- Button Matlab output log: Download and display MATLAB command line output for the currently selected job. Intermediate job logs can be also visualized from here. In the figure above, this option appears disabled since there is no current job on the list.
- Button Matlab error log: Download and display the MATLAB error log for the currently selected job. In the figure above, this option appears disabled since there is no current job on the list.
- Button Download job result: Download result files from the currently selected job
- Button Load/plot results: Launch a GUI for loading and displaying results of the currently selected job
Checking your NSG job status
In this section are displayed the messages issued by NSG during the submission and processing of the job currently selected from the list box Select job.