Let's first make sure we have the latest version of PHOEBE 2.3 installed (uncomment this line if running in an online notebook session such as colab).
In [1]:
#!pip install -I "phoebe>=2.3,<2.4"
As always, let's do imports and initialize a logger and a new bundle.
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_mode')
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_mode' parameter, and since l3_mode is set to 'flux' the 'l3' parameter is also visible.
In [5]:
print(b.filter(qualifier='l3*'))
In [6]:
print(b.filter(qualifier='l3*'))
In [7]:
print(b.get_parameter('l3'))
To compute the fractional third light from the provided value in flux units, call b.compute_l3s. This assumes that the flux of the system is the sum of the extrinsic passband luminosities (see the pblum tutorial for more details on intrinsic vs extrinsic passband luminosities) divided by $4\pi$ at t0@system, and according to the compute options.
Note that calling compute_l3s is not necessary, as the backend will handle the conversion automatically.
In [8]:
print(b.compute_l3s())
In [9]:
b.set_value('l3_mode', 'fraction')
In [10]:
print(b.filter(qualifier='l3*'))
In [11]:
print(b.get_parameter('l3_frac'))
Similarly to above, we can convert to actual flux units (under the same assumptions), by calling b.compute_l3s.
Note that calling compute_l3s is not necessary, as the backend will handle the conversion automatically.
In [12]:
print(b.compute_l3s())
"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 [13]:
b.run_compute(irrad_method='none', model='no_third_light')
Out[13]:
In [14]:
b.set_value('l3_mode', 'flux')
b.set_value('l3', 5)
In [15]:
b.run_compute(irrad_method='none', model='with_third_light')
Out[15]:
As expected, adding 5 W/m^3 of third light simply shifts the light curve up by that exact same amount.
In [16]:
afig, mplfig = b['lc01'].plot(model='no_third_light')
afig, mplfig = b['lc01'].plot(model='with_third_light', legend=True, show=True)
"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 [17]:
b.add_dataset('mesh', times=[0], dataset='mesh01', columns=['intensities@lc01', 'abs_intensities@lc01'])
Out[17]:
In [18]:
b.set_value('l3', 0.0)
In [19]:
b.run_compute(irrad_method='none', model='no_third_light', overwrite=True)
Out[19]:
In [20]:
b.set_value('l3', 5)
In [21]:
b.run_compute(irrad_method='none', model='with_third_light', overwrite=True)
Out[21]:
In [22]:
print("no_third_light abs_intensities: ", np.nanmean(b.get_value(qualifier='abs_intensities', component='primary', dataset='lc01', model='no_third_light')))
print("with_third_light abs_intensities: ", np.nanmean(b.get_value(qualifier='abs_intensities', component='primary', dataset='lc01', model='with_third_light')))
In [23]:
print("no_third_light intensities: ", np.nanmean(b.get_value(qualifier='intensities', component='primary', dataset='lc01', model='no_third_light')))
print("with_third_light intensities: ", np.nanmean(b.get_value(qualifier='intensities', component='primary', dataset='lc01', model='with_third_light')))
In [ ]: