Skip to main content

Automated property interpolation and color calculations for main sequence stars

Project description

Build Status Coverage Status astropy PyPI version Requirements Status


This code provides functionality for automating calculations based on Eric Mamajek's "A Modern Mean Dwarf Stellar Color and Effective Temperature Sequence" (

The purpose of the code is to allow users to automatically interpolate the property columns of the table, and to calcualte colors based on any combination of the photometry columns.

Installation and Requirements

MeanStars requires the following python modules:

  • numpy
  • scipy
  • astropy

To install, simply run:

pip install MeanStars

Alternatively, grab a copy of the repository and run:

python install


To use MeanStars, you must first create a MeanStars object:

from MeanStars import MeanStars
ms = MeanStars()

This object contains a number of useful attributes, including:

  • The full dataset in astropy table format
  • ms.bands: The names of all unique bands from the dataset (in a string array)
  • ms.colors: All of the original colors from the dataset (in an nx2 string array, where n is the length of ms.bands and the color is the first column minus the second). The same information is also encoded in ms.colorstr, which is the original color name from the dataset
  • ms.noncolors: All data attributes not related to color (these include stellar masses, radii, etc.)
  • ms.SpecTypes: All of the major spectral types from the dataset (in a string array - nominally this will always be O,B,A,F,G,K,M,L,T,Y)
  • ms.colorgraph: A directed graph (encoded as a dictionary) mapping all relationships between bands established by the colors in the original dataset

Interpolating Colors

MeanStars provides two methods for interpolating colors: TeffColor and SpTColor, where the former interpolates by effective temperature, and the latter by spectral type. In general, it is unlikely that you will want to query the data by any spectral type not explicilty listed, so the SpTColor most frequently acts as a simple lookup table of the data. In each case, the methods are called by providing the two bands defining the color (called start and end in the code such that the color is start - end), and the temperature or spectral type.

So, to find the 'U-B' color of a 29000 K star, you would execute:


This particular instance corresponds to an exact entry in the data table, and the value returned should exactly match the entry. A more interesting case is the 'U-H' color of a 6000 K star:


Here, you are requesting a color not found in the table at a temperature not found in the table (but bracketed by other temperature values). You can query to find the specific sets of color combined to give this result by running:


which will return ['U', 'B', 'V', 'Ks', 'H'], meaning that the 'U-B','B-V','V-Ks', and 'Ks-H' colors were added to get the result.

Interpolating by spectral type works exactly the same way, excpet that the type is defined by two input variables representing the major and minor subtype. So, to find the 'U-H' color of a G2V dwarf, you would execute:


Each time one of these routines is called on a new color (for a given object instance), the generated interpolant is saved in ms.Teffinterps and ms.SpTinterps (as appropriate to the method call). This means that the interpolant is generated just once per object instance, speeding up subsequent computations.

Interpolating Other Properties

Just as with colors, any other property in the original data set can be interpolated as a function of effective temperature or spectral type, via methods TeffOther and SpTOther, respectively. The methods use the same syntax as their color counterparts, save that the property is defined by a single string input.

So, to find the mean solar mass of a 5500 K star, you would run:


and to find the mean radius of a K9V star, you would run:


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for MeanStars, version 3.0.0
Filename, size File type Python version Upload date Hashes
Filename, size MeanStars-3.0.0-py3-none-any.whl (27.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size MeanStars-3.0.0.tar.gz (27.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page