perceived_color

tulips.tulips.perceived_color(m, time_ind=- 1, raxis='log_R', fps=10, fig=None, ax=None, show_time_label=True, time_label_loc=(), time_unit='Myr', fig_size=(5.5, 4), axis_lim=- 99, axis_label='', theta1=0, theta2=360, hrd_inset=True, show_hrd_ticks_and_labels=False, show_total_mass=True, show_surface=True, output_fname='perceived_color', anim_fmt='.mp4', time_scale_type='model_number')[source]

Create perceived color diagram of a stellar model.

Represent the model of a stellar object as circle with radius raxis. The color of the circle corresponds to its color as perceived by the human eye by assuming black body radiation at a certain effective temperature. Requires a MESA history file.

Parameters
mmesaPlot object

Already loaded a history file.

time_indint or tuple (start_index, end_index, step=1) or (start_index, end_index, step)

If int: create the plot at the index time_ind. If tuple: create an animation from start index to end index with intervals of step.

raxisstr

Default axis to use as radius of the circle.

fpsint

Number of frames per second for the animation.

figFigure object

If set, plot on existing figure.

axAxes object

If set, plot on provided axis.

show_time_labelboolean

If set, insert a label that gives the age of the stellar object (in Myr).

time_label_loctuple

Location of the time label on the plot as fraction of the maximal size.

time_unitstr

Valid astropy time unit.

fig_sizetuple

Size of the figure in inches.

axis_limfloat

Value to set for the maximum limit of the x and y axis.

axis_labelstr

Label of the x and y axis.

theta1: int or float

Start angle for the wedge.

theta2int or float

End angle for the wedge.

hrd_insetboolean

If set, add an inset HRD where the location of the current model is indicated with a circle.

show_hrd_ticks_and_labelsBoolean

If set, display the axis ticks and labels of the inset HRD

show_total_massboolean

If set, display the value of the total mass of the model in the bottom right corner.

show_surfaceboolean,

If set, show the outer boundary of the stellar object.

output_fnamestr

Name of the output file.

anim_fmtstr

Format to use for saving an animation.

time_scale_typestr

One of model_number, linear, or log_to_end. For model_number, the time follows the moment when a new MESA model was saved. For linear, the time follows linear steps in star_age. For log_to_end, the time axis is tau = log10(t_final - t), where t_final is the final star_age of the model.

Returns
fig, ax