2.3.3.1.51. NXsource¶
Status:
base class, extends NXobject
Description:
Radiation source emitting a beam. ...
Radiation source emitting a beam.
Examples include particle sources (electrons, neutrons, protons) or sources for electromagnetic radiation (photons). This base class can also be used to describe neutron or x-ray storage ring/facilities.
Symbols:
No symbol table
- Groups cited:
NXaperture, NXdata, NXdeflector, NXfabrication, NXgeometry, NXlens_em, NXnote, NXoff_geometry, NXtransformations
Structure:
@default: (optional) NX_CHAR
Declares which child group contains a path leading ...
Declares which child group contains a path leading to a NXdata group.
It is recommended (as of NIAC2014) to use this attribute to help define the path to the default dataset to be plotted. See https://www.nexusformat.org/2014_How_to_find_default_data.html for a summary of the discussion.
distance: (optional) NX_FLOAT {units=NX_LENGTH}
Effective distance from sample ...
Effective distance from sample Distance as seen by radiation from sample. This number should be negative to signify that it is upstream of the sample.
name: (optional) NX_CHAR
type: (optional) NX_CHAR
type of radiation source (pick one from the enumerated list and spell exactly) ...
type of radiation source (pick one from the enumerated list and spell exactly)
Any of these values:
Spallation Neutron Source
Pulsed Reactor Neutron Source
Reactor Neutron Source
Synchrotron X-ray Source
Pulsed Muon Source
Rotating Anode X-ray
Fixed Tube X-ray
UV Laser
Free-Electron Laser
Optical Laser
Ion Source
UV Plasma Source
Metal Jet X-ray
Laser
Dye-Laser
Broadband Tunable Light Source
Halogen lamp
LED
Mercury Cadmium Telluride
Deuterium Lamp
Xenon Lamp
Globar
othertype_other: (optional) NX_CHAR
Specification of type, may also go to name.
probe: (optional) NX_CHAR
type of radiation probe (pick one from the enumerated list and spell exactly) ...
type of radiation probe (pick one from the enumerated list and spell exactly)
Any of these values:
neutron
photon
x-ray
muon
electron
ultraviolet
visible light
positron
protonpower: (optional) NX_FLOAT {units=NX_POWER}
Source power
emittance_x: (optional) NX_FLOAT {units=NX_EMITTANCE}
Source emittance (nm-rad) in X (horizontal) direction.
emittance_y: (optional) NX_FLOAT {units=NX_EMITTANCE}
Source emittance (nm-rad) in Y (horizontal) direction.
sigma_x: (optional) NX_FLOAT {units=NX_LENGTH}
particle beam size in x
sigma_y: (optional) NX_FLOAT {units=NX_LENGTH}
particle beam size in y
flux: (optional) NX_FLOAT {units=NX_FLUX}
Source intensity/area (example: s-1 cm-2)
energy: (optional) NX_FLOAT {units=NX_ENERGY}
Source energy. Typically, this would be the energy of ...
Source energy. Typically, this would be the energy of the emitted beam. For storage rings, this would be the particle beam energy.
current: (optional) NX_FLOAT {units=NX_CURRENT}
Accelerator, X-ray tube, or storage ring current
voltage: (optional) NX_FLOAT {units=NX_VOLTAGE}
Accelerator voltage
frequency: (optional) NX_FLOAT {units=NX_FREQUENCY}
Frequency of pulsed source
period: (optional) NX_FLOAT {units=NX_PERIOD}
Period of pulsed source
target_material: (optional) NX_CHAR
Pulsed source target material ...
Pulsed source target material
Any of these values:
Ta
W
depleted_U
enriched_U
Hg
Pb
Cnumber_of_bunches: (optional) NX_INT
For storage rings, the number of bunches in use.
bunch_length: (optional) NX_FLOAT {units=NX_TIME}
For storage rings, temporal length of the bunch
bunch_distance: (optional) NX_FLOAT {units=NX_TIME}
For storage rings, time between bunches
pulse_width: (optional) NX_FLOAT {units=NX_TIME}
temporal width of source pulse
mode: (optional) NX_CHAR
top_up: (optional) NX_BOOLEAN
Is the synchrotron operating in top_up mode?
last_fill: (optional) NX_NUMBER {units=NX_CURRENT}
For storage rings, the current at the end of the most recent injection.
@time: (optional) NX_DATE_TIME
date and time of the most recent injection.
wavelength: (optional) NX_FLOAT {units=NX_WAVELENGTH}
The wavelength of the radiation emitted by the source.
pulse_energy: (optional) NX_FLOAT {units=NX_ENERGY}
For pulsed sources, the energy of a single pulse.
peak_power: (optional) NX_FLOAT {units=NX_POWER}
For pulsed sources, the pulse energy divided ...
For pulsed sources, the pulse energy divided by the pulse duration
anode_material: (optional) NX_CHAR
Material of the anode (for X-ray tubes).
filament_current: (optional) NX_FLOAT {units=NX_CURRENT}
Filament current (for X-ray tubes).
emission_current: (optional) NX_FLOAT {units=NX_CURRENT}
Emission current of the generated beam.
gas_pressure: (optional) NX_FLOAT {units=NX_PRESSURE}
Gas pressure inside ionization source.
previous_source: (optional) NX_CHAR
Single instance or list of instances of NXsource pointing to the sources from ...
Single instance or list of instances of NXsource pointing to the sources from which a beam originated to reach this source. This can be used, for example, for secondary sources to describe which other source(s) they are derived from.
An example is the white light source in transient absorption spectroscopy, which is a supercontinuum crystal that is pumped by a another laser.
In case of a primary source, this field should not be filled.
depends_on: (optional) NX_CHAR
NeXus positions components by applying a set of translations and rotations ...
NeXus positions components by applying a set of translations and rotations to apply to the component starting from 0, 0, 0. The order of these operations is critical and forms what NeXus calls a dependency chain. The depends_on field defines the path to the top most operation of the dependency chain or the string “.” if located in the origin. Usually these operations are stored in a NXtransformations group. But NeXus allows them to be stored anywhere.
The reference point of the source plane is its center in the x and y axis. The source is considered infinitely thin in the z axis.
notes: (optional) NXnote
bunch_pattern: (optional) NXdata
pulse_shape: (optional) NXdata
source pulse shape
geometry: (optional) NXgeometry
DEPRECATED: Use the field depends_on and NXtransformations to position the source and NXoff_geometry to describe its shape instead
“Engineering” location of source.
APERTURE: (optional) NXaperture
The size and position of an aperture inside the source.
DEFLECTOR: (optional) NXdeflector
Deflectors inside the source.
LENS_EM: (optional) NXlens_em
Individual electromagnetic lenses inside the source.
FABRICATION: (optional) NXfabrication
OFF_GEOMETRY: (optional) NXoff_geometry
This group describes the shape of the beam line component
distribution: (optional) NXdata
The wavelength or energy distribution of the source
TRANSFORMATIONS: (optional) NXtransformations
This is the group recommended for holding the chain of translation ...
This is the group recommended for holding the chain of translation and rotation operations necessary to position the component within the instrument. The dependency chain may however traverse similar groups in other component groups.
Hypertext Anchors¶
List of hypertext anchors for all groups, fields, attributes, and links defined in this class.
