tardis.visualization.widgets.shell_info module

class tardis.visualization.widgets.shell_info.BaseShellInfo(t_radiative, w, abundance, number_density, ion_number_density, level_number_density)

Bases: object

The simulation information that is used by shell info widget

element_count(shell_num)

Generates fractional abundance of elements present in a specific shell in a form that can be used by a table widget

Parameters

shell_numint

Shell number (note: starts from 1, not 0 which is what simulation model use)

Returns

pandas.DataFrame

Dataframe containing element symbol and fractional abundance in a specific shell, against each atomic number

ion_count(atomic_num, shell_num)

Generates fractional abundance of ions of a specific element and shell, in a form that can be used by a table widget

Parameters

atomic_numint

Atomic number of element

shell_numint

Shell number (note: starts from 1, not 0 which is what simulation model use)

Returns

pandas.DataFrame

Dataframe containing ion specie and fractional abundance for a specific element, against each ion number

level_count(ion, atomic_num, shell_num)

Generates fractional abundance of levels of a specific ion, element and shell, in a form that can be used by a table widget

Parameters

ionint

Ion number (note: starts from 0, same what is used by simulation model)

atomic_numint

Atomic number of element

shell_numint

Shell number (note: starts from 1, not 0 which is what simulation model use)

Returns

pandas.DataFrame

Dataframe containing fractional abundance for a specific ion, against each level number

shells_data()

Generates shells data in a form that can be used by a table widget

Returns

pandas.DataFrame

Dataframe containing Rad. Temp. and W against each shell of simulation model

class tardis.visualization.widgets.shell_info.HDFShellInfo(hdf_fpath)

Bases: tardis.visualization.widgets.shell_info.BaseShellInfo

The simulation information that is used by shell info widget, obtained from a simulation HDF file

class tardis.visualization.widgets.shell_info.ShellInfoWidget(shell_info_data)

Bases: object

The Shell Info Widget to explore abundances in different shells.

It consists of four interlinked table widgets - shells table; element count, ion count and level count tables - allowing to explore fractional abundances all the way from elements, to ions, to levels by clicking on the rows of tables.

display(shells_table_width='30%', element_count_table_width='24%', ion_count_table_width='24%', level_count_table_width='18%', **layout_kwargs)

Display the shell info widget by putting all component widgets nicely together and allowing interaction between the table widgets

Parameters

shells_table_widthstr, optional

CSS width property value for shells table, by default ‘30%’

element_count_table_widthstr, optional

CSS width property value for element count table, by default ‘24%’

ion_count_table_widthstr, optional

CSS width property value for ion count table, by default ‘24%’

level_count_table_widthstr, optional

CSS width property value for level count table, by default ‘18%’

Returns

ipywidgets.Box

Shell info widget containing all component widgets

Other Parameters

**layout_kwargs

Any valid CSS properties to be passed to the layout attribute of table widgets container (HTML div) as explained in ipywidgets documentation

update_element_count_table(event, qgrid_widget)

Event listener to update the data in element count table widget based on interaction (row selected event) in shells table widget.

Parameters

eventdict

Dictionary that holds information about event (see Notes section)

qgrid_widgetqgrid.QgridWidget

QgridWidget instance that fired the event (see Notes section)

Notes

You will never need to pass any of these arguments explicitly. This is the expected signature of the function passed to handler argument of on method of a table widget (qgrid.QgridWidget object) as explained in qrid documentation.

update_ion_count_table(event, qgrid_widget)

Event listener to update the data in ion count table widget based on interaction (row selected event) in element count table widget.

Parameters

eventdict

Dictionary that holds information about event (see Notes section)

qgrid_widgetqgrid.QgridWidget

QgridWidget instance that fired the event (see Notes section)

Notes

You will never need to pass any of these arguments explicitly. This is the expected signature of the function passed to handler argument of on method of a table widget (qgrid.QgridWidget object) as explained in qrid documentation.

update_level_count_table(event, qgrid_widget)

Event listener to update the data in level count table widget based on interaction (row selected event) in ion count table widget.

Parameters

eventdict

Dictionary that holds information about event (see Notes section)

qgrid_widgetqgrid.QgridWidget

QgridWidget instance that fired the event (see Notes section)

Notes

You will never need to pass any of these arguments explicitly. This is the expected signature of the function passed to handler argument of on method of a table widget (qgrid.QgridWidget object) as explained in qrid documentation.

class tardis.visualization.widgets.shell_info.SimulationShellInfo(sim_model)

Bases: tardis.visualization.widgets.shell_info.BaseShellInfo

The simulation information that is used by shell info widget, obtained from a TARDIS Simulation object

tardis.visualization.widgets.shell_info.shell_info_from_hdf(hdf_fpath)

Create shell info widget from a simulation HDF file

Parameters

hdf_fpathstr

A valid path to a simulation HDF file (HDF file must be created from a TARDIS Simulation object using to_hdf method with default arguments)

Returns

ShellInfoWidget

tardis.visualization.widgets.shell_info.shell_info_from_simulation(sim_model)

Create shell info widget from a TARDIS simulation object

Parameters

sim_modeltardis.simulation.Simulation

TARDIS Simulation object produced by running a simulation

Returns

ShellInfoWidget