tardis.energy_input.transport.gamma_packet_loop module

tardis.energy_input.transport.gamma_packet_loop.gamma_packet_loop(packets: list[GXPacket], grey_opacity: float, photoabsorption_opacity_type: str, pair_creation_opacity_type: str, electron_number_density_time: ndarray[tuple[Any, ...], dtype[float64]], mass_density_time: ndarray[tuple[Any, ...], dtype[float64]], iron_group_fraction_per_shell: ndarray[tuple[Any, ...], dtype[float64]], inner_velocities: ndarray[tuple[Any, ...], dtype[float64]], outer_velocities: ndarray[tuple[Any, ...], dtype[float64]], dt_array: ndarray[tuple[Any, ...], dtype[float64]], times: ndarray[tuple[Any, ...], dtype[float64]], effective_time_array: ndarray[tuple[Any, ...], dtype[float64]], energy_bins: ndarray[tuple[Any, ...], dtype[float64]], energy_out: ndarray[tuple[Any, ...], dtype[float64]], energy_out_cosi: ndarray[tuple[Any, ...], dtype[float64]], total_energy: ndarray[tuple[Any, ...], dtype[float64]], energy_deposited_gamma: ndarray[tuple[Any, ...], dtype[float64]], packets_info_array: ndarray[tuple[Any, ...], dtype[float64]]) → tuple[ndarray[tuple[Any, ...], dtype[float64]], ndarray[tuple[Any, ...], dtype[float64]], ndarray[tuple[Any, ...], dtype[float64]], ndarray[tuple[Any, ...], dtype[float64]], ndarray[tuple[Any, ...], dtype[float64]]]

Propagate gamma-ray packets through the simulation.

Parameters:

packetslist of GXPacket

Packets to propagate through the ejecta.

grey_opacityfloat

Grey opacity value in cm^2/g. Negative values trigger detailed opacity calculations.

photoabsorption_opacity_typestr

Method used to calculate photoabsorption opacity.

pair_creation_opacity_typestr

Method used to calculate pair creation opacity.

electron_number_density_timearray float64

Electron number densities indexed by shell and time.

mass_density_timearray float64

Mass densities indexed by shell and time.

iron_group_fraction_per_shellarray float64

Iron-group mass fraction for each shell.

inner_velocitiesarray float64

Inner shell velocities.

outer_velocitiesarray float64

Outer shell velocities.

dt_arrayarray float64

Simulation delta-time steps.

timesarray float64

Simulation time-step boundaries.

effective_time_arrayarray float64

Effective simulation times for opacity and geometry calculations.

energy_binsarray float64

Energy bins for escaping gamma-rays.

energy_outarray float64

Escaped energy array updated in-place.

energy_out_cosiarray float64

Escaped photon count-rate array updated in-place.

total_energyarray float64

Total deposited energy array updated in-place.

energy_deposited_gammaarray float64

Gamma-ray deposited energy array updated in-place.

packets_info_arrayarray float64

Packet diagnostic output array updated in-place.

Returns:

energy_outarray float64

Escaped energy array.

energy_out_cosiarray float64

Escaped photon count-rate array.

packets_info_arrayarray float64

Packet diagnostic output array.

energy_deposited_gammaarray float64

Gamma-ray deposited energy array.

total_energyarray float64

Total deposited energy array.

Raises:

ValueError

Packet time index less than zero

tardis.energy_input.transport.gamma_packet_loop.process_packet_path(packet: GXPacket) → tuple[GXPacket, float]

Move a packet through interactions.

Parameters:

packetGXPacket

Packet to process.

Returns:

packetGXPacket

Packet after processing.

ejecta_energy_gainedfloat

Energy injected into the ejecta.