Simple Inversion (Format Specification)¶
Legend
Bolded datasets / attributes are required to meet the format spec. Italicized are optional.
HDF5 Datasets¶
| Name | Description | Array Shape | Units |
|---|---|---|---|
| phi1 | Deflection potential in the object plane, the gradient of which gives the deflection angles. Omit only if the solution is not representable by a potential -- in which case specifying the deflection angles is required. | M x N | meters |
| defl_ax11 | Deflection angle along axis-1 (= grad phi, axis 1 component). Values can be positive (for deflection in +ax1 direction) or negative (for deflection in -ax1 direction). | M x N | rad |
| defl_ax21 | Deflection angle along axis-2 (= grad phi, axis 2 component). Values can be positive (for deflection in +ax2 direction) or negative (for deflection in -ax2 direction). | M x N | rad |
HDF5 Attributes¶
| Name | Description | Example | Units |
|---|---|---|---|
| object_type | Specification of the HDF5 object type | "inversion" (always this value) | |
| inversion_type | Specification of the inversion sub-type | "simple" (always this value) | |
| pradformat_version | HDF5 pradformat file format version followed (see above for current version) | "0.1.0" | |
| dr | Bin spacing along axis-1, in the object plane | 2.50E-06 | meters |
| source_object_dist | Approximate distance from the particle source to the object plane (the E & M structures). Used to estimate image magnification. | 0.11 | meters |
| object_image_dist | Approximate distance from the object plane (the E & M structures) to the image plane (the radiograph). Used to estimate image magnification. | 1.43 | meters |
| spec_name | Shortname for the particle species2 | "p+" | |
| spec_mass | Particle mass | 1.67E-27 | kilograms |
| spec_charge | Particle charge | 1.60E-19 | Coulombs |
| spec_energy | Particle energy | 1.47E+07 | eV |
| dr_ax2 | Bin spacing along axis-2, in the object plane (not needed if bin spacings are equal along both dimensions) | 2.50E-06 | meters |
| source_radius | Approximate characteristic radius of the particle source (set as zero for a point source). Helpful in estimating image resolution. | 5.00E-05 | meters |
| label | Short, identifying label for this file (with no spaces or crazy characters). This can be stamped onto plots, etc. | "PROBLEM_inversion_shot3" | |
| description | Longer description of this file. This can be read by people trying to figure out where this file came from. | "Inversion using PROBLEM of a CR39 radiograph from shot 3 on the February 2021 NIF DISC run." | |
| file_date | Date this file was created, in the format "YYYY-MM-DD" | "2021-04-06" | |
| radiograph_filename | If this is an inversion, the SimpleRadiograph pradformat file from which this data was inverted | "/home/scott/prad/myradiograph.h5" | |
| fields_filename | If this is an exact solution, the SimpleFields pradformat file from which this data was projected | "/home/scott/synth/myfields.h5" |
Footnotes¶
-
Deflection angle datasets defl_ax1 and defl_ax2 are derived from the 2D-gradient of phi with respect to spacing dr and dr_ax2, so are optional. If phi is omitted, however, then defl_ax1 and defl_ax2 must be specified. ↩↩↩
-
For best compatibility, consider using the PlasmaPy particle symbol conventions. For example, protons can be specified as just “p+”, and electrons by "e-". Any arbitrary isotope of Hydrogen can be specified “ H-I q+” where I is the mass number and q is the charge. ↩