The Dusty Evolved Star Kit (DESK)

The Dusty Evolved Star Kit (DESK): A Python package for fitting the Spectral Energy Distribution of Evolved Stars - Published in JOSS (2020)

https://github.com/s-goldman/dusty-evolved-star-kit

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
    1 of 4 committers (25.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Scientific Fields

Mathematics Computer Science - 84% confidence
Last synced: 6 months ago · JSON representation

Repository

SED-fitting python package for fitting evolved stars

Basic Info
Statistics
  • Stars: 16
  • Watchers: 0
  • Forks: 3
  • Open Issues: 21
  • Releases: 7
Created almost 8 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog Contributing License

README.md

Build Documentation Status Codacy Badge pypi status Steve Goldman

The DESK is an SED-fitting python package for fitting data from evolved stars (photometry or spectra) with radiative transfer model grids. The package is currently in development and all contributions are welcomed. For current progress, see the Issues tab at the top of the page. The package is ideal for fitting small samples of dusty evolved stars.

Input: A csv file with the first column as wavelength in um and second column as flux in Jy. To fit multiple csv files, put them in a directory, and use the directory name as the input.

Output: A csv files with the best fit model and corresponding stellar parameters, as well as an optional figure of the fit SED.

Available model grids: Several grids are already available upon installation. A range of other model grids, including 2D GRAMS model grids based on the 2DUST code, and state-of-the-art dust-growth models by Nanni et al. (2019), are downloaded automatically and used when selected. Descriptions of the model grids can be found in the documentation.

A module for creating your own DUSTY grid is under development, but for now, please email me (Dr. Steven Goldman) directly for potential grid requests or for help with the package.

Documentation

The documentation can be found on readthedocs.

Install Using Python

1). Install the package from source or with pip using the command pip install desk.

Using the DESK

2). Go to the directory where your target csv file (or target directory of files) is.

3). Use the following command in any terminal (or use the instructions for python)

desk fit --source='target_name.csv'

or if you have a folder of csv files

desk fit --source='folder_of_csvs'

To fit the example sources use the command

desk fit

additional options are:

desk fit --source='target_name.csv' --distance=50 --grid='Oss-Orich-bb'

The other important options are the distance (in kpc) and the grid of models you would like to use (options listed below). For other options see the Usage page. For the model grids, you can select 'oxygen' or 'carbon' to use the default models. To see other available grids use:

desk grids

To create a figure showing all of the fits of the SED, use the following command in the same directory.

desk sed

This is an example of the output_sed.png file fitting three massive oxygen-rich AGB stars from the LMC.

To produce individual figures for each SED instead use the command:

desk sed_indiv

The package can also be used within python (see the docs).

Retrieve Photometry

Don't have the photometry? You can retrieve them from Vizier using the vizier_sed command if you have the source name or position in degrees:

desk vizier_sed 'MSX LMC 807'

or

desk vizier_sed '(83.15482600, -67.11567600)'

Afterwords, you can fit that data with the command:

desk fit --source='MSX_LMC_807_sed.csv'

Citation

Goldman, S. R. 2020, Journal of Open Source Software, 5, 2554, doi: 10.21105/joss.02554

or with bibtex:

@article{Goldman2020,
  doi = {10.21105/joss.02554},
  url = {https://joss.theoj.org/papers/10.21105/joss.02554},
  year = {2020},
  publisher = {The Open Journal},
  volume = {5},
  number = {54},
  pages = {2554},
  author = {Steven R. Goldman},
  title = {The Dusty Evolved Star Kit (DESK): A Python package for fitting the Spectral Energy Distribution of Evolved Stars},
  journal = {Journal of Open Source Software}
}

Please also specify the options selected and make the data publicly available for reproducibility.

License

This project is Copyright (c) Dr. Steven Goldman and licensed under the terms of the BSD 3-Clause license.

Owner

  • Name: Steve Goldman
  • Login: s-goldman
  • Kind: user
  • Location: Mountain View, CA
  • Company: SOFIA

Observatory Scientist, SOFIA sgoldman@usra.edu

JOSS Publication

The Dusty Evolved Star Kit (DESK): A Python package for fitting the Spectral Energy Distribution of Evolved Stars
Published
October 03, 2020
Volume 5, Issue 54, Page 2554
Authors
Steven R. Goldman ORCID
Space Telescope Science Institute, 3700 San Martin Drive, Baltimore, MD 21218, USA
Editor
Arfon Smith ORCID
Tags
astronomy asymptotic giant branch stars radiative Transfer stellar Mass Loss spectral energy distribution fitting

Papers & Mentions

Total mentions: 1

QTL mapping and epistatic interaction analysis in asparagus bean for several characterized and novel horticulturally important traits
Last synced: 4 months ago

GitHub Events

Total
  • Create event: 6
  • Release event: 1
  • Issues event: 3
  • Watch event: 1
  • Delete event: 3
  • Push event: 15
  • Pull request event: 7
  • Fork event: 1
Last Year
  • Create event: 6
  • Release event: 1
  • Issues event: 3
  • Watch event: 1
  • Delete event: 3
  • Push event: 15
  • Pull request event: 7
  • Fork event: 1

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 875
  • Total Committers: 4
  • Avg Commits per committer: 218.75
  • Development Distribution Score (DDS): 0.078
Past Year
  • Commits: 17
  • Committers: 1
  • Avg Commits per committer: 17.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Steve Goldman s****n@s****u 807
steve.goldman.astro@gmail.com 66
codesee-maps[bot] 8****] 1
Pey Lian Lim 2****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 42
  • Total pull requests: 62
  • Average time to close issues: 2 months
  • Average time to close pull requests: 4 days
  • Total issue authors: 4
  • Total pull request authors: 2
  • Average comments per issue: 0.4
  • Average comments per pull request: 0.18
  • Merged pull requests: 52
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 8
  • Average time to close issues: N/A
  • Average time to close pull requests: about 1 hour
  • Issue authors: 2
  • Pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 6
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • s-goldman (26)
  • Deech08 (9)
  • TomGoffrey (5)
  • peissker (1)
Pull Request Authors
  • s-goldman (63)
  • codacy-badger (2)
Top Labels
Issue Labels
enhancement (21) bug (11) documentation (2) minor (2)
Pull Request Labels
bug (5) testing (4) enhancement (3) minor (2) documentation (2)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 367 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 50
  • Total maintainers: 1
pypi.org: desk

The DESK is an SED-fitting python scripts for fitting data from evolved stars

  • Versions: 50
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 367 Last month
Rankings
Downloads: 9.1%
Dependent packages count: 10.1%
Average: 15.0%
Stargazers count: 15.2%
Forks count: 19.1%
Dependent repos count: 21.5%
Maintainers (1)
Last synced: 6 months ago

Dependencies

requirements.txt pypi
  • astropy *
  • h5py *
  • ipdb *
  • matplotlib *
  • pytest-cov *
  • scipy *
  • seaborn *
  • sphinx *
  • sphinx_automodapi *
  • tqdm *
  • twine *
  • wheel *
setup.py pypi
  • astropy *
  • h5py *
  • ipdb *
  • matplotlib *
  • numpy *
  • pytest-cov *
  • scipy *
  • seaborn *
  • sphinx *
  • sphinx_automodapi *
  • tqdm *
  • twine *
  • wheel *
.github/workflows/publish-to-test-pypi.yml actions
  • actions/checkout master composite
  • actions/setup-python v1 composite
  • pypa/gh-action-pypi-publish master composite
.github/workflows/python-package.yml actions
  • actions/checkout v2 composite
  • s-weigand/setup-conda v1 composite
.github/workflows/codesee-arch-diagram.yml actions
  • Codesee-io/codesee-action v2 composite
.github/workflows/cron.yml actions
  • actions/checkout v2 composite
  • s-weigand/setup-conda v1 composite