The SolarSoftware (SSW) stack contains nearly every piece of software a solar physicist needs. While libraries like Astropy, SunPy, and ChiantiPy provide Python equivalents to many of these IDL packages, there's still a lot of functionality only available in SSW.
hissw (hiss (like a snake) + SSW) is a (VERY) lightweight (~1 file) Python package that allows you to write IDL scripts (either inline or in a separate file) which use your installed SSW packages and return the results to your local Python namespace. hissw uses Jinja2 templates to generate SSW startup scripts and then runs your IDL code using
subprocess, i.e. the shell. You can also use Jinja syntax to inject arguments from Python into IDL. The results are then saved to a file and then loaded back in using the amazing
readsav() function in
Install and Configuration
hissw has two dependencies,
jinja2a powerful templating engine
scipystandard scientific tools for Python
To install hissw and its dependencies,
$ pip install hissw
You can also install the above dependencies with
conda. Alternatively, you can download and install the source yourself,
$ git clone https://github.com/wtbarnes/hissw.git $ cd hissw $ python setup.py install
Lastly, you can set the locations of your IDL and SSW installs in a configuration file located in
[hissw] ssw_home=/path/to/ssw/tree idl_home=/path/to/local/idl/install
Note that if you do not create this file, you will be required to specify it each time you setup a SSW script environment, using the keywords
If you've downloaded the source, you can run the tests (requires
pytest to be installed) to make sure everything is working properly,
Bridging the IDL-Python Gap the Bad Way...
hissw is a hack, albeit a clever one. In general, the methodology employed here (round-tripping everything in memory to disk) is a terrible idea. There's no shared memory between Python and IDL or anything fancy like that. If you're interested in something more complicated (and harder to install), you may want to check out the more official Python-to-IDL bridge.
Word(s) of Caution
- Python-3 only
- A local install of of IDL and SSW is required
- Relies on executing shell commands with the
subprocessmodule. I've only tested this on Linux and macOS. Windows users may encounter difficulties.
- Be careful when injecting large pieces of data into your IDL script as this must be written to a file. It may be better to load it at (IDL) runtime.
- Widgets and plotting will (likely) not work
- This has not been tested extensively against all SSW/IDL functionality. There are likely many cases where hissw will not work. Bug reports and pull requests welcome!