Downloading and Installing Stingray¶
There are currently two ways to install Stingray:
- from source
If you manage your Python installation and packages
via Anaconda or miniconda, you can install
$ conda install -c conda-forge stingray
That should be all you need to do! Just remember to run the tests before you use it!
pip-installing Stingray is easy! Just do:
$ pip install stingray
And you should be done! Just remember to run the tests before you use it!
Installing from source (bleeding edge version)¶
For those of you wanting to install the bleeding-edge development version from source (it will have bugs; you’ve been warned!), first clone our repository on GitHub:
$ git clone --recursive https://github.com/StingraySoftware/stingray.git
cd into the newly created
stingray directory and install the necessary
$ cd stingray
$ pip install -e "."
Note that this will install the package without the optional dependencies required by
modeling subpackage. In order to install
stingray with these dependencies
$ pip install -e ".[modeling]"
Please be sure to run the test suite before you use the package, and please report anything you think might be bugs on our GitHub Issues page.
Stingray uses py.test for testing. To run the tests, go into
stingray root directory and execute
$ python setup.py test
If you have installed Stingray via pip or conda, the source directory might not be easily accessible. Once installed, you can also run the tests using:
$ python -c 'import stingray; stingray.test()'
or from within a python interpreter:
You can build the API reference yourself by going into the
docs folder within the
directory and running the
$ cd stingray/docs $ make html
If that doesn’t work on your system, you can invoke
sphinx-build itself from the stingray source directory:
$ cd stingray $ $ sphinx-build docs docs/_build
The documentation should be located in
stingray/docs/_build. Try opening
the stingray source directory.