Covariance tools for fitting stellar spectra
Starfish is a set of tools used for spectroscopic inference. We designed the package to robustly determine stellar parameters using high resolution spectral models.
There have been major, breaking updates since version
0.2.0, please see this page regarding these changes if you are used to the old version!
If you have used Starfish in your work, please let us know and we can add you to this list!
Please bear in mind that this package is under heavy development and features may evolve rapidly. If something doesn't work, please fill an issue on this repository. If you would like to contribute to this project (either with bugfixes, documentation, or new features) please feel free to fork the repository and submit a pull request!
Starfish has several dependencies, however most of them should be satisfied by an up-to-date scientific python installation. We highly recommend using the Anaconda Scientific Python Distribution and updating to Python 3.6 or greater. This code makes no attempt to work on the Python 2.x series, and I doubt it will if you try. This package is tested across Linux, Mac OS X, and Windows.
To make sure you are running the correct version of python, start a python interpreter via the system shell and you should see something similar
$ python Python 3.6.1 |Anaconda custom (64-bit)| (default, May 11 2017, 13:25:24) [MSC v.1900 64 bit (AMD64)] on win32 Type "help", "copyright", "credits" or "license" for more information. >>>
If your shell says Python 2.x, try using the
python3 command instead of
For the most current stable release of Starfish, use the releases from PyPI
$ pip install astrostarfish
If you want to be on the most up-to-date version (or a development version), install from source via
$ pip install git+https://github.com/iancze/Starfish.git#egg=astrostarfish
To test that you've properly installed Starfish, try doing the following inside of a Python interpreter session
>>> import Starfish >>> Starfish.__version__ '0.3.0'
If you see any errors, then something went wrong--please file an issue.
Now that you've successfully installed the code, please see the documentation on how to begin using Starfish to solve your spectroscopic inference problem.
If you are interested in contributing to Starfish, first off, thank you! We appreciate your time and effort into
making our project better. To get set up in a development environment, it is highly recommended to develop in a
virtual environment. We use
pipenv (pending a better PEP 517/518 compliant tool) to manage our environments, to get started clone the repository (and we recommend forking us first)
$ git clone https://github.com/<your_fork>/Starfish.git starfish $ cd starfish
and then create the virtual environment and install all the packages and developer dependencies from the
$ pipenv install -d
and to enter the virtual environment, simply issue
$ pipenv shell
whenever you're in the
We also enforce the
black code style. This tools allows automatically formatting everything for you, which is much easier than caring about it yourself! We have a pre-commit hook that will blacken your code before you commit so you can avoid failing the CI tests because you forgot to format. To use this, just install the hook with
$ pipenv run pre-commit install
From then on, any commits will format your code before succeeding!
Take a look through the issues if you are looking for a place to start improving Starfish!
pytest for testing; within the virtual environment
Note that we use the
black code style and our CI testing will check that everything is formatted correctly. To check your code
$ pytest --black
although if you follow the instructions for using pre-commit you should have no issues.
CONTRIBUTORS.md for a full list of contributors.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size astrostarfish-0.3.0-py3-none-any.whl (51.2 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size astrostarfish-0.3.0.tar.gz (44.7 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for astrostarfish-0.3.0-py3-none-any.whl