"""
Module with functions for creating color-magnitude and color-color plots.
"""
import os
import math
import itertools
import numpy as np
import matplotlib as mpl
import matplotlib.pyplot as plt
from scipy.interpolate import interp1d
from matplotlib.colorbar import Colorbar, ColorbarBase
from species.read import read_object
from species.util import plot_util
mpl.rcParams['font.serif'] = ['Bitstream Vera Serif']
mpl.rcParams['font.family'] = 'serif'
plt.rc('axes', edgecolor='black', linewidth=2.5)
[docs]def plot_color_magnitude(colorbox=None,
objects=None,
isochrones=None,
models=None,
mass_labels=None,
companion_labels=False,
field_range=None,
label_x='color [mag]',
label_y='M [mag]',
xlim=None,
ylim=None,
offset=None,
legend='upper left',
output='color-magnitude.pdf'):
"""
Parameters
----------
colorbox : list(species.core.box.ColorMagBox, ), None
Boxes with the colors and magnitudes. Not used if set to None.
objects : tuple(tuple(str, str, str, str), ),
tuple(tuple(str, str, str, str, str, str, float, float), ), None
Tuple with individual objects. The objects require a tuple with their database tag, the two
filter IDs for the color, and the filter ID for the absolute magnitude. Optionally, the
horizontal and vertical alignment and fractional offset values can be provided for the
label can be provided (default: 'left', 'bottom', 8e-3, 8e-3). Not used if set to None.
isochrones : tuple(species.core.box.IsochroneBox, ), None
Tuple with boxes of isochrone data. Not used if set to None.
models : tuple(species.core.box.ColorMagBox, ), None
Tuple with :class:`~species.core.box.ColorMagBox` objects which have been created from the
isochrone data with :func:`~species.read.read_isochrone.ReadIsochrone.get_color_magnitude`.
These boxes contain synthetic photometry for a given age and a range of masses. Not used
if set to None.
mass_labels : list(float, ), None
Plot labels with masses next to the isochrone data of `models`. The list with masses has
to be provided in Jupiter mass. No labels are shown if set to None.
companion_labels : bool
Plot labels with the names of the directly imaged companions.
field_range : tuple(str, str), None
Range of the discrete colorbar for the field dwarfs. The tuple should contain the lower
and upper value ('early M', 'late M', 'early L', 'late L', 'early T', 'late T', 'early Y).
The full range is used if set to None.
label_x : str
Label for the x-axis.
label_y : str
Label for the y-axis.
xlim : tuple(float, float)
Limits for the x-axis.
ylim : tuple(float, float)
Limits for the y-axis.
legend : str, None
Legend position. Not shown if set to None.
output : str
Output filename.
Returns
-------
None
"""
model_color = ('#234398', '#f6a432')
model_linestyle = ('-', '--', ':', '-.')
print(f'Plotting color-magnitude diagram: {output}... ', end='')
plt.figure(1, figsize=(4., 4.8))
gridsp = mpl.gridspec.GridSpec(3, 1, height_ratios=[0.2, 0.1, 4.5])
gridsp.update(wspace=0., hspace=0., left=0, right=1, bottom=0, top=1)
ax1 = plt.subplot(gridsp[2, 0])
ax2 = plt.subplot(gridsp[0, 0])
ax1.tick_params(axis='both', which='major', colors='black', labelcolor='black',
direction='in', width=1, length=5, labelsize=12, top=True,
bottom=True, left=True, right=True)
ax1.tick_params(axis='both', which='minor', colors='black', labelcolor='black',
direction='in', width=1, length=3, labelsize=12, top=True,
bottom=True, left=True, right=True)
ax1.set_xlabel(label_x, fontsize=14)
ax1.set_ylabel(label_y, fontsize=14)
ax1.invert_yaxis()
if offset:
ax1.get_xaxis().set_label_coords(0.5, offset[0])
ax1.get_yaxis().set_label_coords(offset[1], 0.5)
else:
ax1.get_xaxis().set_label_coords(0.5, -0.08)
ax1.get_yaxis().set_label_coords(-0.12, 0.5)
if xlim:
ax1.set_xlim(xlim[0], xlim[1])
if ylim:
ax1.set_ylim(ylim[0], ylim[1])
if models is not None:
cmap_teff = plt.cm.afmhot
teff_min = np.inf
teff_max = -np.inf
for item in models:
if np.amin(item.sptype) < teff_min:
teff_min = np.amin(item.sptype)
if np.amax(item.sptype) > teff_max:
teff_max = np.amax(item.sptype)
norm_teff = mpl.colors.Normalize(vmin=teff_min, vmax=teff_max)
count = 0
model_dict = {}
for j, item in enumerate(models):
if item.library not in model_dict:
model_dict[item.library] = [count, 0]
count += 1
else:
model_dict[item.library] = [model_dict[item.library][0],
model_dict[item.library][1]+1]
model_count = model_dict[item.library]
if model_count[1] == 0:
label = plot_util.model_name(item.library)
ax1.plot(item.color, item.magnitude, linestyle=model_linestyle[model_count[1]],
linewidth=1.2, color=model_color[model_count[0]], label=label, zorder=0)
if mass_labels is not None:
interp_magnitude = interp1d(item.sptype, item.magnitude)
interp_color = interp1d(item.sptype, item.color)
for i, mass_item in enumerate(mass_labels):
if j == 0 or (j > 0 and mass_item < 20.):
pos_color = interp_color(mass_item)
pos_mag = interp_magnitude(mass_item)
mass_label = str(int(mass_item))+r' M$_\mathregular{J}$'
xlim = ax1.get_xlim()
ylim = ax1.get_ylim()
if xlim[0]+0.2 < pos_color < xlim[1]-0.2 and \
ylim[1]+0.2 < pos_mag < ylim[0]-0.2:
ax1.scatter(pos_color, pos_mag, c=model_color[model_count[0]], s=15,
edgecolor='none', zorder=0)
ax1.annotate(mass_label, (pos_color, pos_mag),
color=model_color[model_count[0]], fontsize=9,
xytext=(pos_color+0.05, pos_mag-0.1), zorder=1)
else:
ax1.plot(item.color, item.magnitude, linestyle=model_linestyle[model_count[1]],
linewidth=0.6, color=model_color[model_count[0]], zorder=0)
if colorbox is not None:
cmap = plt.cm.viridis
bounds, ticks, ticklabels = plot_util.field_bounds_ticks(field_range)
norm = mpl.colors.BoundaryNorm(bounds, cmap.N)
for item in colorbox:
sptype = item.sptype
color = item.color
magnitude = item.magnitude
indices = np.where(sptype != b'None')[0]
sptype = sptype[indices]
color = color[indices]
magnitude = magnitude[indices]
spt_disc = plot_util.sptype_substellar(sptype, color.shape)
_, unique = np.unique(color, return_index=True)
sptype = sptype[unique]
color = color[unique]
magnitude = magnitude[unique]
spt_disc = spt_disc[unique]
if item.object_type == 'field':
scat = ax1.scatter(color, magnitude, c=spt_disc, cmap=cmap, norm=norm, s=50,
alpha=0.7, edgecolor='none', zorder=2)
cb = Colorbar(ax=ax2, mappable=scat, orientation='horizontal',
ticklocation='top', format='%.2f')
cb.ax.tick_params(width=1, length=5, labelsize=10, direction='in', color='black')
cb.set_ticks(ticks)
cb.set_ticklabels(ticklabels)
elif item.object_type == 'young':
ax1.plot(color, magnitude, marker='s', ms=4, linestyle='none', alpha=0.7,
color='gray', markeredgecolor='black', label='Young/low-gravity', zorder=2)
if isochrones is not None:
for item in isochrones:
ax1.plot(item.color, item.magnitude, linestyle='-', linewidth=1.2, color='black')
if objects is not None:
for i, item in enumerate(objects):
objdata = read_object.ReadObject(item[0])
objcolor1 = objdata.get_photometry(item[1])
objcolor2 = objdata.get_photometry(item[2])
abs_mag = objdata.get_absmag(item[3])
colorerr = math.sqrt(objcolor1[1]**2+objcolor2[1]**2)
x_color = objcolor1[0]-objcolor2[0]
y_mag = abs_mag[0]
# if item[0] in ('PDS 70 b'):
# if item[0] in ('beta Pic b', 'HIP 65426 b', 'PZ Tel B', 'HD 206893 B'):
# marker = '*'
# markersize = 12
# color = '#eb4242'
# markerfacecolor = '#eb4242'
# markeredgecolor = 'black'
#
# else:
# marker = '>'
# markersize = 6
# color = 'black'
# markerfacecolor = 'white'
# markeredgecolor = 'black'
# if item[0] == 'HR 8799 b':
# label = 'Directly imaged'
# elif item[0] == 'beta Pic b':
# label = 'This work'
# elif item[0] == 'PDS 70 b':
# label = 'This work'
# else:
# label = None
marker = '>'
markersize = 6
color = 'black'
markerfacecolor = 'white'
markeredgecolor = 'black'
if i == 0:
label = 'Directly imaged'
else:
label = None
ax1.errorbar(x_color, y_mag, yerr=abs_mag[1], xerr=colorerr, marker=marker,
ms=markersize, color=color, markerfacecolor=markerfacecolor,
zorder=3, markeredgecolor=markeredgecolor, label=label)
if companion_labels:
x_range = ax1.get_xlim()
y_range = ax1.get_ylim()
if len(item) == 8:
ha = item[4]
va = item[5]
x_scaling = item[6]
y_scaling = item[7]
else:
ha = 'left'
va = 'bottom'
x_scaling = 1e-2
y_scaling = 5e-3
x_offset = x_scaling*abs(x_range[1]-x_range[0])
y_offset = y_scaling*abs(y_range[1]-y_range[0])
ax1.text(x_color+x_offset, y_mag-y_offset, objdata.object_name, ha=ha, va=va,
fontsize=8, color=color, zorder=3)
if legend is not None:
handles, labels = ax1.get_legend_handles_labels()
if handles:
ax1.legend(loc=legend, prop={'size': 8.5}, frameon=False, numpoints=1)
plt.savefig(os.getcwd()+'/'+output, bbox_inches='tight')
plt.clf()
plt.close()
print('[DONE]')
[docs]def plot_color_color(colorbox,
objects=None,
models=None,
mass_labels=None,
companion_labels=False,
field_range=None,
label_x='color [mag]',
label_y='color [mag]',
xlim=None,
ylim=None,
offset=None,
legend='upper left',
output='color-color.pdf'):
"""
Parameters
----------
colorbox : species.core.box.ColorColorBox, None
Box with the colors and magnitudes.
objects : tuple(tuple(str, str, str, str), ),
tuple(tuple(str, str, str, str, str, str, float, float), ), None
Tuple with individual objects. The objects require a tuple with their database tag, the two
filter IDs for the first color, and the two filter IDs for the second color. Optionally,
the horizontal and vertical alignment and fractional offset values can be provided for the
label can be provided (default: 'left', 'bottom', 8e-3, 8e-3). Not used if set to None.
models : tuple(species.core.box.ColorMagBox, ), None
Tuple with :class:`~species.core.box.ColorColorBox` objects which have been created from
the isochrone data with :func:`~species.read.read_isochrone.ReadIsochrone.get_color_color`.
These boxes contain synthetic photometry for a given age and a range of masses. Not used
if set to None.
mass_labels : list(float, ), None
Plot labels with masses next to the isochrone data of `models`. The list with masses has
to be provided in Jupiter mass. No labels are shown if set to None.
companion_labels : bool
Plot labels with the names of the directly imaged companions.
field_range : tuple(str, str), None
Range of the discrete colorbar for the field dwarfs. The tuple should contain the lower
and upper value ('early M', 'late M', 'early L', 'late L', 'early T', 'late T', 'early Y).
The full range is used if set to None.
label_x : str
Label for the x-axis.
label_y : str
Label for the y-axis.
output : str
Output filename.
xlim : tuple(float, float)
Limits for the x-axis.
ylim : tuple(float, float)
Limits for the y-axis.
offset : tuple(float, float)
Offset of the x- and y-axis label.
legend : str
Legend position.
Returns
-------
None
"""
model_color = ('#234398', '#f6a432')
model_linestyle = ('-', '--', ':', '-.')
print(f'Plotting color-color diagram: {output}... ', end='')
plt.figure(1, figsize=(4, 4.3))
gridsp = mpl.gridspec.GridSpec(3, 1, height_ratios=[0.2, 0.1, 4.])
gridsp.update(wspace=0., hspace=0., left=0, right=1, bottom=0, top=1)
ax1 = plt.subplot(gridsp[2, 0])
ax2 = plt.subplot(gridsp[0, 0])
ax1.tick_params(axis='both', which='major', colors='black', labelcolor='black',
direction='in', width=1, length=5, labelsize=12, top=True,
bottom=True, left=True, right=True)
ax1.tick_params(axis='both', which='minor', colors='black', labelcolor='black',
direction='in', width=1, length=3, labelsize=12, top=True,
bottom=True, left=True, right=True)
ax1.set_xlabel(label_x, fontsize=14)
ax1.set_ylabel(label_y, fontsize=14)
ax1.invert_yaxis()
if offset:
ax1.get_xaxis().set_label_coords(0.5, offset[0])
ax1.get_yaxis().set_label_coords(offset[1], 0.5)
else:
ax1.get_xaxis().set_label_coords(0.5, -0.08)
ax1.get_yaxis().set_label_coords(-0.12, 0.5)
if xlim:
ax1.set_xlim(xlim[0], xlim[1])
if ylim:
ax1.set_ylim(ylim[0], ylim[1])
if models is not None:
cmap_teff = plt.cm.afmhot
teff_min = np.inf
teff_max = -np.inf
for item in models:
if np.amin(item.sptype) < teff_min:
teff_min = np.amin(item.sptype)
if np.amax(item.sptype) > teff_max:
teff_max = np.amax(item.sptype)
norm_teff = mpl.colors.Normalize(vmin=teff_min, vmax=teff_max)
count = 0
model_dict = {}
for j, item in enumerate(models):
if item.library not in model_dict:
model_dict[item.library] = [count, 0]
count += 1
else:
model_dict[item.library] = [model_dict[item.library][0],
model_dict[item.library][1]+1]
model_count = model_dict[item.library]
if model_count[1] == 0:
label = plot_util.model_name(item.library)
ax1.plot(item.color1, item.color2, linestyle=model_linestyle[model_count[1]],
linewidth=0.6, color=model_color[model_count[0]], label=label, zorder=0)
if mass_labels is not None:
interp_color1 = interp1d(item.sptype, item.color1)
interp_color2 = interp1d(item.sptype, item.color2)
for i, mass_item in enumerate(mass_labels):
if j == 0 or (j > 0 and mass_item < 20.):
pos_color1 = interp_color1(mass_item)
pos_color2 = interp_color2(mass_item)
mass_label = str(int(mass_item))+r' M$_\mathregular{J}$'
xlim = ax1.get_xlim()
ylim = ax1.get_ylim()
if xlim[0]+0.2 < pos_color1 < xlim[1]-0.2 and \
ylim[0]+0.2 < pos_color2 < ylim[1]-0.2:
ax1.scatter(pos_color1, pos_color2, c=model_color[model_count[0]],
s=15, edgecolor='none', zorder=0)
ax1.annotate(mass_label, (pos_color1, pos_color2),
color=model_color[model_count[0]], fontsize=9,
xytext=(pos_color1+0.05, pos_color2-0.1), zorder=1)
else:
ax1.plot(item.color1, item.color2, linestyle=model_linestyle[model_count[1]],
linewidth=0.6, color=model_color[model_count[0]], zorder=0)
if colorbox is not None:
cmap = plt.cm.viridis
bounds, ticks, ticklabels = plot_util.field_bounds_ticks(field_range)
norm = mpl.colors.BoundaryNorm(bounds, cmap.N)
for item in colorbox:
sptype = item.sptype
color1 = item.color1
color2 = item.color2
indices = np.where(sptype != 'None')[0]
sptype = sptype[indices]
color1 = color1[indices]
color2 = color2[indices]
spt_disc = plot_util.sptype_substellar(sptype, color1.shape)
_, unique = np.unique(color1, return_index=True)
sptype = sptype[unique]
color1 = color1[unique]
color2 = color2[unique]
spt_disc = spt_disc[unique]
if item.object_type == 'field':
scat = ax1.scatter(color1, color2, c=spt_disc, cmap=cmap, norm=norm, s=50,
alpha=0.7, edgecolor='none', zorder=2)
cb = Colorbar(ax=ax2, mappable=scat, orientation='horizontal',
ticklocation='top', format='%.2f')
cb.ax.tick_params(width=1, length=5, labelsize=10, direction='in', color='black')
cb.set_ticks(ticks)
cb.set_ticklabels(ticklabels)
elif item.object_type == 'young':
ax1.plot(color1, color2, marker='s', ms=4, linestyle='none', alpha=0.7,
color='gray', markeredgecolor='black', label='Young/low-gravity', zorder=2)
if objects is not None:
for i, item in enumerate(objects):
objdata = read_object.ReadObject(item[0])
mag1 = objdata.get_photometry(item[1][0])[0]
mag2 = objdata.get_photometry(item[1][1])[0]
mag3 = objdata.get_photometry(item[2][0])[0]
mag4 = objdata.get_photometry(item[2][1])[0]
err1 = objdata.get_photometry(item[1][0])[1]
err2 = objdata.get_photometry(item[1][1])[1]
err3 = objdata.get_photometry(item[2][0])[1]
err4 = objdata.get_photometry(item[2][1])[1]
color1 = mag1 - mag2
color2 = mag3 - mag4
error1 = math.sqrt(err1**2+err2**2)
error2 = math.sqrt(err3**2+err4**2)
# if item[0] in ('beta Pic b', 'HIP 65426 b', 'PZ Tel B', 'HD 206893 B'):
# marker = '*'
# markersize = 12
# color = '#eb4242'
# markerfacecolor = '#eb4242'
# markeredgecolor = 'black'
#
# else:
# marker = '>'
# markersize = 6
# color = 'black'
# markerfacecolor = 'white'
# markeredgecolor = 'black'
#
# if item[0] == 'HR 8799 b':
# label = 'Directly imaged'
# elif item[0] == 'beta Pic b':
# label = 'This work'
# else:
# label = None
marker = '>'
markersize = 6
color = 'black'
markerfacecolor = 'white'
markeredgecolor = 'black'
if not companion_labels and i == 0:
label = 'Directly imaged'
else:
label = None
ax1.errorbar(color1, color2, xerr=error1, yerr=error2, marker=marker, ms=markersize,
color=color, markerfacecolor=markerfacecolor,
markeredgecolor=markeredgecolor, label=label, zorder=3)
if companion_labels:
x_range = ax1.get_xlim()
y_range = ax1.get_ylim()
if len(item) == 7:
ha = item[3]
va = item[4]
x_scaling = item[5]
y_scaling = item[6]
else:
ha = 'left'
va = 'bottom'
x_scaling = 8e-3
y_scaling = 8e-3
x_offset = x_scaling*abs(x_range[1]-x_range[0])
y_offset = y_scaling*abs(y_range[1]-y_range[0])
ax1.text(color1+x_offset, color2+y_offset, objdata.object_name, ha=ha, va=va,
fontsize=8, color=color, zorder=3)
handles, labels = ax1.get_legend_handles_labels()
if handles:
ax1.legend(loc=legend, prop={'size': 9}, frameon=False, numpoints=1)
plt.savefig(os.getcwd()+'/'+output, bbox_inches='tight')
plt.clf()
plt.close()
print('[DONE]')