Downloads and Installation: Difference between revisions

From SPEDAS Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 32: Line 32:
= If you have an IDL license =
= If you have an IDL license =


If you have an [http://www.exelisvis.com/IntelliEarthSolutions/GeospatialProducts/IDL.aspx IDL software] license, then download the nightly build. Check with your system administrator on how to obtain and install IDL.  
If you have an [http://www.harrisgeospatial.com/ProductsandTechnology/Software/IDL.aspx IDL software] license, then download the nightly build. Check with your system administrator on how to obtain and install IDL.  


== Download the SPEDAS nightly build ==
== Download the SPEDAS nightly build ==
Line 56: Line 56:
== IDL CDF library ==
== IDL CDF library ==


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


  * [http://cdf.gsfc.nasa.gov/html/sw_and_docs.html Download the CDF Library]
  * [http://cdf.gsfc.nasa.gov/html/sw_and_docs.html Download the CDF Library]


You can check which version of CDF you have, by typing this at the IDL command prompt: '''help, 'cdf', /dlm'''
You can check which version of CDF you have, by typing this at the IDL command prompt: '''help, 'cdf', /dlm'''
The CDF dlm files can also be downloaded here: [http://spedas.org/downloads/cdf_dlm.zip CDF dlm files]
== Older versions ==
1. You can download the source code for the SPEDAS version 1.0 release that has undergone extensive Quality assurance (QA) testing:
* [http://spedas.org/downloads/spedas_1_00.zip Download the SPEDAS 1.0 source code, August 2014]
2. For a list of previous nightly builds, see:
* [http://themis.ssl.berkeley.edu/socware/bleeding_edge/?C=M;O=D The nightly builds download site]




Line 85: Line 73:
== Download the SPEDAS save file, Version 2.00 beta 2, January 2017 ==
== Download the SPEDAS save file, Version 2.00 beta 2, January 2017 ==


The SPEDAS save file requires the run-time [http://www.harrisgeospatial.com/Support/HelpArticles/TabId/185/ArtMID/800/ArticleID/12395/The-IDL-Virtual-Machine.aspx IDL Virtual Machine (VM)] which has to be downloaded for free from Exelis. There are limitations using the VM compared to the full IDL.  
The SPEDAS save file requires the run-time [http://www.harrisgeospatial.com/Support/SelfHelpTools/HelpArticles/HelpArticles-Detail/TabId/2718/ArtMID/10220/ArticleID/17309/The-IDL-Virtual-Machine.aspx IDL Virtual Machine (VM)] which has to be downloaded for free from Harris Corporation. There are limitations using the VM compared to the full IDL.  


  * [http://spedas.org/downloads/spedas_2b2_savefile_84.zip  SPEDAS 2.00 beta 2, IDL Savefile (15 MB)]
  * [http://spedas.org/downloads/spedas_2b2_savefile_84.zip  SPEDAS 2.00 beta 2, IDL Savefile (15 MB)]
Line 99: Line 87:


Further information for loading IDL sav files can be found here:
Further information for loading IDL sav files can be found here:
http://www.exelisvis.com/docs/StartingVirtualMachineApplication.html
http://harrisgeospatial.com/docs/StartingVirtualMachineApplication.html
 
== Previous version: SPEDAS executable, Version 1.00, August 2014 ==
 
The executable is a zip file that contains everything you need to run the SPEDAS GUI:
 
    IDL 8.3
        * [http://spedas.org/downloads/spedas_10_win64_83_93b.zip Download the SPEDAS 1.0 Executable, Windows 64bit, IDL 8.3, Geopack 9.3 (52 MB)]
        * [http://spedas.org/downloads/spedas_10_mac64_83_93b.zip Download the SPEDAS 1.0 Executable, MacOs 64bit, IDL 8.3, Geopack 9.3 (60 MB)]
        * [http://spedas.org/downloads/spedas_10_linux64_83_93b.zip Download the SPEDAS 1.0 Executable, Linux 64bit, IDL 8.3, Geopack 9.3 (70 MB)]
        * [http://spedas.org/downloads/spedas_10_linux64_83_76b.zip Download the SPEDAS 1.0 Executable, Linux 64bit, IDL 8.3, Geopack 7.6 (70 MB)]
 
    IDL 7.1
        * [http://spedas.org/downloads/spedas_10_win64_71_93b.zip Download the SPEDAS 1.0 Executable, Windows 64bit, IDL 7.1, Geopack 9.3 (34 MB)]
        * [http://spedas.org/downloads/spedas_10_mac64_71_93b.zip Download the SPEDAS 1.0 Executable, MacOs 64bit, IDL 7.1, Geopack 9.3 (48 MB)]
        * [http://spedas.org/downloads/spedas_10_linux64_71_93b.zip Download the SPEDAS 1.0 Executable, Linux 64bit, IDL 7.1, Geopack 9.3 (53 MB)]
        * [http://spedas.org/downloads/spedas_10_linux64_71_76b.zip Download the SPEDAS 1.0 Executable, Linux 64bit, IDL 7.1, Geopack 7.6 (53 MB)]
 
== Previous version: SPEDAS save file, Version 1.00, August 2014 ==
 
The SPEDAS save file requires the run-time [http://www.harrisgeospatial.com/Support/HelpArticles/TabId/185/ArtMID/800/ArticleID/12395/The-IDL-Virtual-Machine.aspx IDL Virtual Machine (VM)] which has to be downloaded for free from Exelis. There are limitations using the VM compared to the full IDL.


* [http://spedas.org/downloads/spedas_10_savefile_83b.zip Download the SPEDAS 1.00 savefile (14 MB)]
To run SPEDAS using 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.
Further information for loading IDL sav files can be found here:
http://www.exelisvis.com/docs/StartingVirtualMachineApplication.html


= Installation on a Mac =
= Installation on a Mac =

Revision as of 20:17, 6 June 2017

*New* SPEDAS 2.00 released (June 2017)

The QA process for SPEDAS 2.00 has now been completed, and this version of the software is now released for general use for users who have paid for IDL licenses. This release includes improved support for HTTPS downloads, updated plugin support for the ERG, IUGONET, THEMIS, and MMS missions, and many bug fixes and performance improvements.

For users without IDL licenses, we will soon be building and releasing a set of SPEDAS 2.00 executable files for Linux, Windows, and MacOS, which allow access to the Graphical User Interface capabilities of SPEDAS, with no additional IDL license required. There will be a few weeks delay until these products are available, while we work through the renewal process for the IDL "right to redistribute" license required for us to build the software.

This version contains the source code and can be installed in a similar way to a nightly build (see below).

* SPEDAS 2.00, IDL source code (~33 MB)

In the meantime, for users without IDL licenses, we have built executables based on the SPEDAS 2.00 beta 2 release from January 2017, and we recommend using those until the executables from the final release build are available:

* SPEDAS 2.00 beta 2, Windows 64bit executable, IDL 8.4, CDF 3.6.3, Geopack 9.4 (~50 MB)
* SPEDAS 2.00 beta 2, MacOs 64bit executable, IDL 8.4, CDF 3.6.3, Geopack 9.4 (~65 MB)
* SPEDAS 2.00 beta 2, Linux 64bit executable, IDL 8.4, CDF 3.6.3, Geopack 9.4 (~65 MB)
* SPEDAS 2.00 beta 2, Linux 64bit executable, IDL 8.4, CDF 3.6.3, Geopack 7.6 (~65 MB)


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 the SPEDAS nightly build

The nightly build contains the most recent source code:

* Download the latest SPEDAS nightly build

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.4 version.

* Download the 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).

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

The GEOPACK dlm files can also be downloaded here: GEOPACK dlm files

IDL CDF library

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

* Download the 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

SPEDAS is free software but if you do not have an IDL license, then you cannot use the IDL command line, and hence neither the SPEDAS command line tools. You can still use the SPEDAS GUI, and you have two options:

  1. Download the SPEDAS executable (see above), or
  2. Download the SPEDAS save file.

Download the SPEDAS save file, Version 2.00 beta 2, January 2017

The SPEDAS save file requires the run-time IDL Virtual Machine (VM) which has to be downloaded for free from Harris Corporation. There are limitations using the VM compared to the full IDL.

* SPEDAS 2.00 beta 2, IDL Savefile (15 MB)

To run SPEDAS using the IDL virtual machine,

  1. start the IDL virtual machine executable
  2. click through the splash screen to get to the file selection dialog
  3. navigate to the SPEDAS installation
  4. 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.

Further information for loading IDL sav files can be found here: http://harrisgeospatial.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.

MacOS Sierra

If you want to run the executable SPEDAS file on macOS 10.12 Sierra, after downloading the zip file you have to do the following:

  • Open the Finder and move the (automatically uncompressed) spedas_v_2 directory from Downloads to your Desktop.
  • Open a terminal and type the following:

cd Desktop/spedas_v_2/spd_gui
sudo xattr -r -d com.apple.quarantine spedas.app
(enter your password)
open ./spedas.app

Installation on Windows

When we update Geopack DLM or the CDF library on Windows, we have to copy files in the "Program Files\Exelis\IDL84\bin\bin.x86_64" folder. When we try to copy files into folders that reside inside Program Files, Windows 10 (and probably older Windows versions, too) will ask for administrator permission as you can see in the following image. In that case, we just have to click the button "Continue". If we are logged in as a user without administration permissions, then we either have to log in as administrator, or perhaps contact the system administrator for the PC we are using.

Request for administrator permission in Windows
Request for administrator permission in Windows

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.

SPEDAS Configuration Settings
SPEDAS Configuration Settings