spxprm Struct Reference

Spectral variables and their derivatives. More...

#include <spx.h>

Data Fields
double	restfrq
double	restwav
int	wavetype
int	velotype
double	freq
double	afrq
double	ener
double	wavn
double	vrad
double	wave
double	vopt
double	zopt
double	awav
double	velo
double	beta
double	dfreqafrq
double	dafrqfreq
double	dfreqener
double	denerfreq
double	dfreqwavn
double	dwavnfreq
double	dfreqvrad
double	dvradfreq
double	dfreqwave
double	dwavefreq
double	dfreqawav
double	dawavfreq
double	dfreqvelo
double	dvelofreq
double	dwavevopt
double	dvoptwave
double	dwavezopt
double	dzoptwave
double	dwaveawav
double	dawavwave
double	dwavevelo
double	dvelowave
double	dawavvelo
double	dveloawav
double	dvelobeta
double	dbetavelo
struct wcserr *	err
void *	padding

Detailed Description

Spectral variables and their derivatives.

The spxprm struct contains the value of all spectral variables and their derivatives. It is used solely by specx() which constructs it from information provided via its function arguments.

This struct should be considered read-only, no members need ever be set nor should ever be modified by the user.

Field Documentation

restfrq

double spxprm::restfrq

(Returned) Rest frequency [Hz].

restwav

double spxprm::restwav

(Returned) Rest wavelength [m].

wavetype

int spxprm::wavetype

(Returned) True if wave types have been computed, and ...

velotype

int spxprm::velotype

(Returned) ... true if velocity types have been computed; types are defined below.

If one or other of spxprm::restfrq and spxprm::restwav is given (non-zero) then all spectral variables may be computed. If both are given, restfrq is used. If restfrq and restwav are both zero, only wave characteristic xor velocity type spectral variables may be computed depending on the variable given. These flags indicate what is available.

freq

double spxprm::freq

(Returned) Frequency [Hz] (wavetype).

afrq

double spxprm::afrq

(Returned) Angular frequency [rad/s] (wavetype).

ener

double spxprm::ener

(Returned) Photon energy [J] (wavetype).

wavn

double spxprm::wavn

(Returned) Wave number [/m] (wavetype).

vrad

double spxprm::vrad

(Returned) Radio velocity [m/s] (velotype).

wave

double spxprm::wave

(Returned) Vacuum wavelength [m] (wavetype).

vopt

double spxprm::vopt

(Returned) Optical velocity [m/s] (velotype).

zopt

double spxprm::zopt

(Returned) Redshift [dimensionless] (velotype).

awav

double spxprm::awav

(Returned) Air wavelength [m] (wavetype).

velo

double spxprm::velo

(Returned) Relativistic velocity [m/s] (velotype).

beta

double spxprm::beta

(Returned) Relativistic beta [dimensionless] (velotype).

dfreqafrq

double spxprm::dfreqafrq

(Returned) Derivative of frequency with respect to angular frequency [/rad] (constant, ), and ...

dafrqfreq

double spxprm::dafrqfreq

(Returned) ... vice versa [rad] (constant, , always available).

dfreqener

double spxprm::dfreqener

(Returned) Derivative of frequency with respect to photon energy [/J/s] (constant, ), and ...

denerfreq

double spxprm::denerfreq

(Returned) ... vice versa [Js] (constant, , Planck's constant, always available).

dfreqwavn

double spxprm::dfreqwavn

(Returned) Derivative of frequency with respect to wave number [m/s] (constant, , the speed of light in vacuo), and ...

dwavnfreq

double spxprm::dwavnfreq

(Returned) ... vice versa [s/m] (constant, , always available).

dfreqvrad

double spxprm::dfreqvrad

(Returned) Derivative of frequency with respect to radio velocity [/m], and ...

dvradfreq

double spxprm::dvradfreq

(Returned) ... vice versa [m] (wavetype && velotype).

dfreqwave

double spxprm::dfreqwave

(Returned) Derivative of frequency with respect to vacuum wavelength [/m/s], and ...

dwavefreq

double spxprm::dwavefreq

(Returned) ... vice versa [m s] (wavetype).

dfreqawav

double spxprm::dfreqawav

(Returned) Derivative of frequency with respect to air wavelength, [/m/s], and ...

dawavfreq

double spxprm::dawavfreq

(Returned) ... vice versa [m s] (wavetype).

dfreqvelo

double spxprm::dfreqvelo

(Returned) Derivative of frequency with respect to relativistic velocity [/m], and ...

dvelofreq

double spxprm::dvelofreq

(Returned) ... vice versa [m] (wavetype && velotype).

dwavevopt

double spxprm::dwavevopt

(Returned) Derivative of vacuum wavelength with respect to optical velocity [s], and ...

dvoptwave

double spxprm::dvoptwave

(Returned) ... vice versa [/s] (wavetype && velotype).

dwavezopt

double spxprm::dwavezopt

(Returned) Derivative of vacuum wavelength with respect to redshift [m], and ...

dzoptwave

double spxprm::dzoptwave

(Returned) ... vice versa [/m] (wavetype && velotype).

dwaveawav

double spxprm::dwaveawav

(Returned) Derivative of vacuum wavelength with respect to air wavelength [dimensionless], and ...

dawavwave

double spxprm::dawavwave

(Returned) ... vice versa [dimensionless] (wavetype).

dwavevelo

double spxprm::dwavevelo

(Returned) Derivative of vacuum wavelength with respect to relativistic velocity [s], and ...

dvelowave

double spxprm::dvelowave

(Returned) ... vice versa [/s] (wavetype && velotype).

dawavvelo

double spxprm::dawavvelo

(Returned) Derivative of air wavelength with respect to relativistic velocity [s], and ...

dveloawav

double spxprm::dveloawav

(Returned) ... vice versa [/s] (wavetype && velotype).

dvelobeta

double spxprm::dvelobeta

(Returned) Derivative of relativistic velocity with respect to relativistic beta [m/s] (constant, , the speed of light in vacuo), and ...

dbetavelo

double spxprm::dbetavelo

(Returned) ... vice versa [s/m] (constant, , always available).

err

struct wcserr * spxprm::err

(Returned) If enabled, when an error status is returned, this struct contains detailed information about the error, see wcserr_enable().

padding

void * spxprm::padding

(An unused variable inserted for alignment purposes only.)

Global variable: const char *spx_errmsg[] - Status return messages Error messages to match the status value returned from each function.