Let's first make sure we have the latest version of PHOEBE 2.0 installed. (You can comment out this line if you don't use pip for your installation or don't want to update to the latest release).
In [ ]:
!pip install -I "phoebe>=2.0,<2.1"
As always, let's do imports and initialize a logger and a new bundle. See Building a System for more details.
In [1]:
%matplotlib inline
In [2]:
import phoebe
from phoebe import u # units
import numpy as np
import matplotlib.pyplot as plt
logger = phoebe.logger()
b = phoebe.default_binary()
In [3]:
b.filter(qualifier='l3')
Out[3]:
So let's add a LC dataset
In [4]:
b.add_dataset('lc', times=np.linspace(0,1,101), dataset='lc01')
Out[4]:
We now see that the LC dataset created an 'l3' parameters for the new dataset.
In [5]:
b.filter(qualifier='l3')
Out[5]:
In [6]:
print b['l3@lc01']
"Third" light is simply additional flux added to the light curve from some external source - whether it be crowding from a background object, light from the sky, or an extra component in the system that is unaccounted for in the system hierarchy.
To see this we'll compare a light curve with and without "third" light.
In [7]:
b.run_compute(irrad_method='none', model='no_third_light')
Out[7]:
In [8]:
b['l3@lc01'] = 5
In [9]:
b.run_compute(irrad_method='none', model='with_third_light')
Out[9]:
As expected, adding 5 W/m^3 of third light simply shifts the light curve up by that exact same amount.
In [10]:
fig = plt.figure()
ax1, ax2 = fig.add_subplot(121), fig.add_subplot(122)
axs, artists = b['lc01'].plot(model='no_third_light', ax=ax1)
axs, artists = b['lc01'].plot(model='with_third_light', ax=ax2)
"Third" light does not affect the intensities stored in the mesh (including those in relative units). In other words, like distance, "third" light only scales the fluxes.
NOTE: this is different than pblums which DO affect the relative intensities. Again, see the pblum tutorial for more details.
To see this we can run both of our models again and look at the values of the intensities in the mesh.
In [11]:
b.add_dataset('mesh', times=[0], dataset='mesh01')
Out[11]:
In [12]:
b['l3@lc01'] = 0.0
In [13]:
b.run_compute(irrad_method='none', model='no_third_light')
Out[13]:
In [14]:
b['l3@lc01'] = 5
In [15]:
b.run_compute(irrad_method='none', model='with_third_light')
Out[15]:
In [16]:
print "no_third_light abs_intensities: ", b.get_value(qualifier='abs_intensities', component='primary', dataset='lc01', model='no_third_light').mean()
print "with_third_light abs_intensities: ", b.get_value(qualifier='abs_intensities', component='primary', dataset='lc01', model='with_third_light').mean()
In [17]:
print "no_third_light intensities: ", b.get_value(qualifier='intensities', component='primary', dataset='lc01', model='no_third_light').mean()
print "with_third_light intensities: ", b.get_value(qualifier='intensities', component='primary', dataset='lc01', model='with_third_light').mean()