Revision as of 18:07, 23 March 2016

If you have an IDL license

If you have an IDL software license, then download the nightly build. Check with your system administrator on how to obtain and install IDL.

Download SPEDAS nightly build

The nightly build contains the most recent source code:

* Download the latest SPEDAS nightly build

For a list of older nightly builds, see the nightly builds download site.

Unzip the files you downloaded and create a new IDL project that includes these files. To start the SPEDAS GUI from the IDL command line, type: spd_gui

IDL Geopack DLM

To use the Tsyganenko Model extensions with the SPEDAS software, you need to download and install the Geopack DLM. We recommend using the 9.3 version.

* Download IDL Geopack

Installation instructions can be found in the download page, but basically you have to copy two files into the IDL bin directory: a .dlm file and either a .so file (Linux, Mac) or a .dll file (Windows).

IDL CDF library

We recommend downloading and installing the most recent version (3.6.1) of the CDF library from NASA:

* Download CDF Library

You can check which version of CDF you have, by typing this at the IDL command prompt: help, 'cdf', /dlm

If you don't have an IDL license

If you do not have an IDL license, then you cannot use the IDL command line, nor the SPEDAS command line tools. You can still use the SPEDAS GUI, and you have two options:

Download a SPEDAS executable.
Download the IDL run-time virtual machine (free) and the SPEDAS save file.

Download SPEDAS executable, Version 1.00, August 2014

The latest SPEDAS executable was created in August 2014. A new version will be available later in 2016.

The executable is a zip file that contains everything you need to run the SPEDAS GUI:

   IDL 8.3
       * Download SPEDAS 1.0 Executable, Windows 64bit, IDL 8.3, Geopack 9.3 (52 MB)
       * Download SPEDAS 1.0 Executable, MacOs 64bit, IDL 8.3, Geopack 9.3 (60 MB)
       * Download SPEDAS 1.0 Executable, Linux 64bit, IDL 8.3, Geopack 9.3 (70 MB)
       * Download SPEDAS 1.0 Executable, Linux 64bit, IDL 8.3, Geopack 7.6 (70 MB)

   IDL 7.1
       * Download SPEDAS 1.0 Executable, Windows 64bit, IDL 7.1, Geopack 9.3 (34 MB)
       * Download SPEDAS 1.0 Executable, MacOs 64bit, IDL 7.1, Geopack 9.3 (48 MB)
       * Download SPEDAS 1.0 Executable, Linux 64bit, IDL 7.1, Geopack 9.3 (53 MB)
       * Download SPEDAS 1.0 Executable, Linux 64bit, IDL 7.1, Geopack 7.6 (53 MB)

Download SPEDAS save file, August 2014

This requires the run-time IDL Virtual Machine (VM) which has to be downloaded for free from Exelis. There are limitations using the VM compared to the full IDL. This distribution only provides access to the GUI, and not the command line tools.

* Download the SPEDAS 1.00 savefile (14 MB)

To run SPEDAS in the IDL virtual machine,

start the IDL virtual machine executable
click through the splash screen to get to the file selection dialog
navigate to the SPEDAS installation
go into the thm_gui_new directory and click on thm_gui.sav

This should bring up the main screen of the SPEDAS GUI. From this point you should be able to load, plot, and analyze data through the GUI, as documented in the Users Guide.

Further information for loading IDL sav files can be found here: http://www.exelisvis.com/docs/StartingVirtualMachineApplication.html

Installation on a Mac

Newer Mac OS X versions do not include the X11 libraries. XQuartz (X11) has to be downloaded and installed, or IDL will not work. Also, you may need to install an older Java version for IDL to work properly.

Download and install XQuartz 2.7.8 or later, from here: http://www.xquartz.org/
Download and install Java for OS X 2015-001, from here: https://support.apple.com/kb/DL1572
To be able to install SPEDAS, you have to allow installation of applications from unidentified developers.
- Instructions can be found here: https://support.apple.com/kb/PH14369?locale=en_US
- Another way to override these warnings is described here: https://www.mcvsd.org/tips/powerteacher/osx_unidentified_developers.html

Running SPEDAS for the first time

The first time you run SPEDAS, please make sure that all the directories where data files will be downloaded exist and have the proper permissions (they should be writable). To do this, launch the SPEDAS GUI (using the command spd_gui) and in the File menu choose Configuration Settings. Make sure that all the directories for SPEDAS and any other missions you use exist and are writable. If you make any changes, click "Save to File" to have the new settings saved.

@@ Line 35: / Line 35: @@
 If you do not have an IDL license, then you cannot use the IDL command line, nor the SPEDAS command line tools. You can still use the SPEDAS GUI, and you have two options:
-. Download a SPEDAS executable.
+# Download a SPEDAS executable.
-. Download the IDL run-time virtual machine (free) and the SPEDAS save file.
+# Download the IDL run-time virtual machine (free) and the SPEDAS save file.
 == Download SPEDAS executable, Version 1.00, August 2014 ==
@@ Line 75: / Line 75: @@
-== Installation on a Mac ==
+= Installation on a Mac =
 Newer Mac OS X versions do not include the X11 libraries. XQuartz (X11) has to be downloaded and installed, or IDL will not work. Also, you may need to install an older Java version for IDL to work properly.
@@ Line 86: / Line 86: @@
-== Running SPEDAS for the first time ==
+= Running SPEDAS for the first time =
 The first time you run SPEDAS, please make sure that all the directories where data files will be downloaded exist and have the proper permissions (they should be writable). To do this, launch the SPEDAS GUI (using the command spd_gui) and in the File menu choose Configuration Settings. Make sure that all the directories for SPEDAS and any other missions you use exist and are writable. If you make any changes, click "Save to File" to have the new settings saved.
 [[File:configuration_settings.png|200px|thumb|left|SPEDAS Configuration Settings]]

Downloads and Installation: Difference between revisions