tardis.io.model_reader module

exception tardis.io.model_reader.ConfigurationError

Bases: Exception

tardis.io.model_reader.model_to_dict(model)

Retrieves all the data from a SimulationState object and returns a dictionary.

Parameters

transporttardis.model.SimulationState

Returns

model_dictdict

isotope_abundancedict

tardis.io.model_reader.parse_csv_abundances(csvy_data)

A parser for the csv data part of a csvy model file. This function filters out columns that are not abundances.

Parameters

csvy_datapandas.DataFrame

Returns

indexnp.ndarray

abundancespandas.DataFrame

isotope_abundancepandas.MultiIndex

tardis.io.model_reader.read_abundances_file(abundance_filename, abundance_filetype, inner_boundary_index=None, outer_boundary_index=None)

read different density file formats

Parameters

abundance_filenamestr

filename or path of the density file

abundance_filetypestr

type of the density file

inner_boundary_indexint

index of the inner shell, default None

outer_boundary_indexint

index of the outer shell, default None

tardis.io.model_reader.read_artis_density(fname)

Reading a density file of the following structure (example; lines starting with a hash will be ignored): The first density describes the mean density in the center of the model and is not used. 5 #index velocity [km/s] log10(density) [log10(g/cm^3)] 0 1.1e4 1.6e8 1 1.2e4 1.7e8

Parameters

fnamestr

filename or path with filename

Returns

time_of_modelastropy.units.Quantity

time at which the model is valid

datapandas.DataFrame

data frame containing index, velocity (in km/s) and density

tardis.io.model_reader.read_cmfgen_composition(fname, delimiter='\\s+')

Read composition from a CMFGEN model file

The CMFGEN file format contains information about the ejecta state in the first four columns and the following ones contain elemental and isotopic abundances.

WARNING : deprecated

fnamestr

filename of the csv file

tardis.io.model_reader.read_cmfgen_density(fname)

Reading a density file of the following structure (example; lines starting with a hash will be ignored): The first density describes the mean density in the center of the model and is not used. The file consists of a header row and next row contains unit of the respective attributes Note that the first column has to contain a running index

Example:

index velocity densities electron_densities temperature - km/s g/cm^3 /cm^3 K 0 871.66905 4.2537191e-09 2.5953807e+14 7.6395577 1 877.44269 4.2537191e-09 2.5953807e+14 7.6395577

Rest columns contain abundances of elements and isotopes

Parameters

fnamestr

filename or path with filename

Returns

time_of_modelastropy.units.Quantity

time at which the model is valid

velocitynp.ndarray

mean_densitynp.ndarray

electron_densitiesnp.ndarray

temperaturenp.ndarray

tardis.io.model_reader.read_csv_composition(fname, delimiter='\\s+')

Read composition from a simple CSV file

The CSV file can contain specific isotopes or elemental abundances in the different columns. The first row must contain the header in which the contents of each column is specified by the elemental symbol (for elemental abundances) or by the symbol plus mass number (for isotopic abundances).

Example: C O Fe Ni56 Co

The i-th row specifies the composition in the i-th shell

fnamestr

filename of the csv file

tardis.io.model_reader.read_csv_isotope_abundances(fname, delimiter='\\s+', skip_columns=0, skip_rows=[1])

A generic parser for a TARDIS composition stored as a CSV file

The parser can read in both elemental and isotopic abundances. The first column is always expected to contain a running index, labelling the grid cells. The parser also allows for additional information to be stored in the first skip_columns columns. These will be ignored if skip_columns > 0. Note that the first column, containing the cell index is not taken into account here.

Specific header lines can be skipped by the skip_rows keyword argument

It is expected that the first row of the date block (after skipping the rows specified in skip_rows) specifies the different elements and isotopes. Each row after contains the composition in the corresponding grid shell. The first composition row describes the composition of the photosphere and is essentially ignored (for the default value of skip_rows).

Example:

Index C O Ni56 0 1 1 1 1 0.4 0.3 0.2

Parameters

fnamestr

filename or path with filename

Returns

indexnp.ndarray

abundancespandas.DataFrame

isotope_abundancepandas.MultiIndex

tardis.io.model_reader.read_density_file(filename, filetype)

read different density file formats

Parameters

filenamestr

filename or path of the density file

filetypestr

type of the density file

Returns

time_of_modelastropy.units.Quantity

time at which the model is valid

velocitynp.ndarray

the array containing the velocities

unscaled_mean_densitiesnp.ndarray

the array containing the densities

tardis.io.model_reader.read_simple_ascii_abundances(fname)

Reading an abundance file of the following structure (example; lines starting with hash will be ignored): The first line of abundances describe the abundances in the center of the model and are not used. #index element1, element2, …, element30 0 0.4 0.3, .. 0.2

Parameters

fnamestr

filename or path with filename

Returns

indexnp.ndarray

containing the indices

abundancespandas.DataFrame

data frame containing index, element1 - element30 and columns according to the shells

tardis.io.model_reader.read_simple_ascii_density(fname)

Reading a density file of the following structure (example; lines starting with a hash will be ignored): The first density describes the mean density in the center of the model and is not used. 5 s #index velocity [km/s] density [g/cm^3] 0 1.1e4 1.6e8 1 1.2e4 1.7e8

Parameters

fnamestr

filename or path with filename

Returns

time_of_modelastropy.units.Quantity

time at which the model is valid

datapandas.DataFrame

data frame containing index, velocity (in km/s) and density

tardis.io.model_reader.read_uniform_abundances(abundances_section, no_of_shells)

Parameters

abundances_sectionconfig.model.abundances

no_of_shellsint

Returns

abundancepandas.DataFrame

isotope_abundancepandas.DataFrame

tardis.io.model_reader.store_model_to_hdf(model, fname)

Stores data from SimulationState object into a hdf file.

Parameters

modeltardis.model.SimulationState

filenamestr

tardis.io.model_reader.store_transport_to_hdf(transport, fname)

Stores data from MontecarloTransport object into a hdf file.

Parameters

transporttardis.transport.montecarlo.MontecarloTransport

filenamestr

tardis.io.model_reader.transport_from_hdf(fname)

Creates a MontecarloTransport object using data stored in a hdf file.

Parameters

fnamestr

Returns

new_transporttardis.transport.montecarlo.MontecarloTransport

tardis.io.model_reader.transport_to_dict(transport)

Retrieves all the data from a transport object and returns a dictionary.

Parameters

transporttardis.transport.montecarlo.MontecarloTransport

Returns

transport_dictdict

integrator_settingsdict

v_packet_settingsdict

virtual_spectrum_spawn_rangedict