10.3 IDL data structure

The data structure FUL contains the following variables and substructures. Use help,/str,ful, to get this information. See also the short description of the contents of a model file in Sect.8.1 and particularly the man page of the script uiolook in Sect.6.2.6.2 which gives you even more detailed information directly from the file:

** Structure <8287a0c>, 9 tags, length=78404128, refs=1:
   TYPE               STRING    'uio'
   HEAD               STRUCT    -> <Anonymous> Array[1]
   DATASET_ID         STRING    'single_box'
   MODELTIME          FLOAT           10050.1
   MODELITIME         LONG            64088
   DTIME              FLOAT               0.176381
   TIME_OUT_FULL_LAST FLOAT           10050.1
   TIME_OUT_MEAN_LAST FLOAT           10040.0
   Z                  STRUCT    -> <Anonymous> Array[1]

If the command in Sect.10.2.5 has been performed, the following substructures are present:

   EOS                STRUCT    -> <Anonymous> Array[1]
   OPA                STRUCT    -> <Anonymous> Array[1]

The substructure FUL.Z contains the original data arrays from the model file like the spatial axes, density rho, internal energy ei, and the three spatial components of the velocity (v1, v2, v3):

** Structure <8274184>, 16 tags, length=78403900, refs=2:
   TYPE               STRING    'uio'
   BOX_ID             STRING    'z'
   DIMENSION          LONG      Array[2, 3]
   TIME               FLOAT           10050.1
   ITIME              LONG            64088
   XC1                FLOAT     Array[140, 1  , 1  ]
   XC2                FLOAT     Array[1  , 140, 1  ]
   XC3                FLOAT     Array[1  , 1  , 200]
   XB1                FLOAT     Array[141, 1  , 1  ]
   XB2                FLOAT     Array[1  , 141, 1  ]
   XB3                FLOAT     Array[1  , 1  , 201]
   RHO                FLOAT     Array[140, 140, 200]
   EI                 FLOAT     Array[140, 140, 200]
   V1                 FLOAT     Array[140, 140, 200]
   V2                 FLOAT     Array[140, 140, 200]
   V3                 FLOAT     Array[140, 140, 200]

The spatial axes are: XC1, XC2, XC3, XB1, XB2, XB3:

The indices stand for 1:$x$, 2:$y$, 3:$z$ (or $h$) C for the grid cell centre, B for the boundaries. Most of the quantities are defined for the cell centres. In case of doubt, this can be found out by checking the array dimensions: the number of cell boundaries is one larger than the number of cell centers.

The substructure FUL.Z can contain additional arrays in case of dust formation, chemical reaction networks, or time-dependent hydrogen ionization:

   QUC001          FLOAT     Array[140, 140, 200]
   QUC002          FLOAT     Array[140, 140, 200]
   QUC003          FLOAT     Array[140, 140, 200]
   QUC004          FLOAT     Array[140, 140, 200]

The meaning of the quantities depends on the used source-term module. The magnetic field components are also stored in this substructure:

   BB1             FLOAT     Array[141, 140, 200]
   BB2             FLOAT     Array[140, 141, 200]
   BB3             FLOAT     Array[140, 140, 201]

The magnetic field is defined on the cell boundaries in the direction of the spatial components, e.g. BB1 in direction 1, and in the cell-centres for the other directions. The resulting array dimensions differ from the cell-centred quanties like, e.g., rho. The array values must be multiplied with a factor $\sqrt{4\pi}$ in order to obtain the field strength in Gauss.

The substructure FUL.EOS (which is present only after a call of, e.g., eosbox.pro) contains important quantities like the temperature T, gas pressure P, entropy S:

** Structure <826a03c>, 6 tags, length=109760000, refs=2:
   P                  FLOAT     Array[140, 140, 200]
   DPDRHO             FLOAT     Array[140, 140, 200]
   DPDEI              FLOAT     Array[140, 140, 200]
   T                  FLOAT     Array[140, 140, 200]
   DTDEI              FLOAT     Array[140, 140, 200]
   S                  FLOAT     Array[140, 140, 200]

The substructure FUL.OPA only contains the opacity KAPPA:

** Structure <826a5b4>, 1 tags, length=15680000, refs=2:
   KAPPA              FLOAT     Array[140, 140, 200]