Loop¶

class synthesizAR.Loop(name, coordinate, field_strength: Unit('G') = None, cross_sectional_area: Unit('cm2') = None, model_results_filename=None)[source]¶

Bases: object

Container for geometric and thermodynamic properties of a coronal loop

Parameters:

name (str) –
coordinate (astropy.coordinates.SkyCoord) – Loop coordinates; should be able to transform to HEEQ
field_strength (astropy.units.Quantity) – Scalar magnetic field strength along the loop. If not specified, defaults to NaN with same shape as coordinate.
cross_sectional_area (astropy.units.Quantity, optional) – Cross-sectional area of the loop. If not specified, defaults to \(10^14\) cm:math:^2. This is used to compute the filling factor when computing the line-of-sight intensity.
model_results_filename (str, optional) – Path to file where model results are stored. This will be set by Skeleton when the model results are loaded.

Examples

>>> import astropy.units as u
>>> from astropy.coordinates import SkyCoord
>>> import synthesizAR
>>> coordinate = SkyCoord(x=[1,4]*u.Mm, y=[2,5]*u.Mm, z=[3,6]*u.Mm, frame='heliographic_stonyhurst', representation_type='cartesian')
>>> field_strength = u.Quantity([100,200], 'gauss')
>>> loop = synthesizAR.Loop('coronal_loop', coordinate, field_strength)
>>> loop
synthesizAR Loop
----------------
Name : coronal_loop
Loop full-length, L : 5.196 Mm
Footpoints : (1 Mm,2 Mm,3 Mm),(4 Mm,5 Mm,6 Mm)
Maximum field strength : 200.00 G
Simulation Type: None

Attributes Summary

`coordinate`
`coordinate_center`	The coordinates of the centers of the bins.
`coordinate_direction`	Unit vector indicating the direction of \(s\) in HEEQ
`coordinate_direction_center`	Unit vector indicating the direction of \(s\) in HEEQ evaluated at the center of the grids
`cross_sectional_area`	Cross-sectional area of each field-aligned coordinate grid cell
`cross_sectional_area_center`
`density`	Density as function of loop coordinate and time.
`electron_temperature`	Electron temperature as function of loop coordinate and time.
`field_aligned_coordinate`	Field-aligned coordinate \(s\) such that \(0<s<L\).
`field_aligned_coordinate_center`	Center of the field-aligned coordinate cells
`field_aligned_coordinate_center_norm`	Center of the field-aligned coordinate normalized to the total loop length
`field_aligned_coordinate_edge`	Left cell edge of the field-aligned coordinate cells
`field_aligned_coordinate_norm`	Field-aligned coordinate normalized to the total loop length
`field_aligned_coordinate_width`	Width of each field-aligned coordinate grid cell
`field_strength`
`field_strength_center`
`gravity`	Gravitational acceleration in the field-aligned direction.
`ion_temperature`	Ion temperature as function of loop coordinate and time.
`length`	Loop full-length \(L\), from footpoint to footpoint
`simulation_type`	The model used to produce the field-aligned hydrodynamic quantities
`time`	Simulation time
`velocity`	Velocity as function of loop coordinate and time.
`velocity_xyz`	Cartesian velocity components in HEEQ as function of loop coordinate and time
`zarr_root`	Root object to Zarr filestore for model results

Methods Summary

get_ionization_fraction(ion)

Return the ionization fraction for a particular ion.

Attributes Documentation

coordinate¶

coordinate_center¶: The coordinates of the centers of the bins.

coordinate_direction¶: Unit vector indicating the direction of \(s\) in HEEQ

coordinate_direction_center¶: Unit vector indicating the direction of \(s\) in HEEQ evaluated at the center of the grids

cross_sectional_area¶: Cross-sectional area of each field-aligned coordinate grid cell

cross_sectional_area_center¶

density¶: Density as function of loop coordinate and time.

electron_temperature¶: Electron temperature as function of loop coordinate and time.

field_aligned_coordinate¶

Field-aligned coordinate \(s\) such that \(0<s<L\).

Technically, the first \(N\) cells are the left edges of each grid cell and the \(N+1\) cell is the right edge of the last grid cell.

field_aligned_coordinate_center¶: Center of the field-aligned coordinate cells

field_aligned_coordinate_center_norm¶: Center of the field-aligned coordinate normalized to the total loop length

field_aligned_coordinate_edge¶: Left cell edge of the field-aligned coordinate cells

field_aligned_coordinate_norm¶: Field-aligned coordinate normalized to the total loop length

field_aligned_coordinate_width¶: Width of each field-aligned coordinate grid cell

field_strength¶

field_strength_center¶

gravity¶: Gravitational acceleration in the field-aligned direction.

ion_temperature¶: Ion temperature as function of loop coordinate and time.

length¶: Loop full-length \(L\), from footpoint to footpoint

simulation_type¶: The model used to produce the field-aligned hydrodynamic quantities

time¶: Simulation time

velocity¶: Velocity as function of loop coordinate and time.

velocity_xyz¶: Cartesian velocity components in HEEQ as function of loop coordinate and time

zarr_root¶: Root object to Zarr filestore for model results

Methods Documentation

get_ionization_fraction(ion)[source]¶: Return the ionization fraction for a particular ion.