Functions
DLL_EXPORT double	vlbi_astro_mean_speed (double speed)
	Obtain or set the reference constant speed of the radiation to measure. More...

DLL_EXPORT void	vlbi_astro_alt_az_from_ra_dec (double J2000time, double Ra, double Dec, double Lat, double Long, double Alt, double Az)
	Obtain the altitude and azimuth coordinate of a celestial coordinate at a specific time. More...

DLL_EXPORT double	vlbi_astro_get_local_hour_angle (double local_sideral_time, double ra)
	Returns local hour angle of an object. More...

DLL_EXPORT void	vlbi_astro_get_alt_az_coordinates (double hour_angle, double dec, double latitude, double alt, double az)
	Returns alt-azimuth coordinates of an object. More...

DLL_EXPORT dsp_stream_p	vlbi_astro_load_spectrum (char *filename)
	Load a spectrum file. More...

DLL_EXPORT int	vlbi_astro_load_spectra_catalog (char path, dsp_stream_p catalog, int catalog_size)
	Load a spectrum file catalog. More...

DLL_EXPORT dsp_stream_p	vlbi_astro_create_reference_catalog (dsp_stream_p *catalog, int catalog_size)
	Create a dsp_stream_p containing all the spectral lines of all elements of a catalog. More...

DLL_EXPORT void	vlbi_astro_save_spectrum (dsp_stream_p stream, char *filename)
	Save a spectrum stream into a file. More...

DLL_EXPORT void	vlbi_astro_scan_spectrum (dsp_stream_p stream, int sample_size)
	Scan a dsp_stream_p and detect the relevant spectral lines. More...

DLL_EXPORT dsp_align_info	vlbi_astro_align_spectra (dsp_stream_p spectrum, dsp_stream_p catalog, int max_lines, double decimals, double min_score)
	Align a spectrum to a reference catalog. More...

DLL_EXPORT double	vlbi_astro_diff_spectra (dsp_stream_p spectrum0, dsp_stream_p spectrum, double decades)
	Compare a spectrum to a reference one. More...

DLL_EXPORT double	vlbi_astro_flux_ratio (double flux0, double flux, double delta_spectrum)
	Returns the flux ratio of two objects. More...

DLL_EXPORT double	vlbi_astro_estimate_brightness_temperature (double wavelength, double flux)
	Estimate the brightness temperature from a flux. More...

DLL_EXPORT double	vlbi_astro_estimate_temperature (double wavelength, double flux)
	Estimate the physical temperature with a given flux. More...

DLL_EXPORT double	vlbi_astro_estimate_flux (double wavelength, double temperature)
	Estimate the flux from a physical temperature. More...

DLL_EXPORT double	vlbi_astro_estimate_temperature_ratio (double rad_ratio, double flux_ratio)
	Returns the temperature ratio of two objects. More...

DLL_EXPORT double	vlbi_astro_estimate_size_ratio (double luminosity_ratio, double temperature_ratio)
	Returns the size ratio of two objects. More...

DLL_EXPORT double	vlbi_astro_estimate_luminosity_ratio (double size_ratio, double flux_ratio)
	Returns the luminosity ratio between two celestial objects. More...

DLL_EXPORT double	vlbi_astro_estimate_distance_ratio (double luminosity_ratio, double flux_ratio)
	Returns the distance ratio of two celestial object. More...

DLL_EXPORT double	vlbi_astro_estimate_distance_parallax (double rad, double baseline)
	Returns the distance of an object from its parallax. More...

DLL_EXPORT double	vlbi_astro_estimate_redshift (double wavelength0, int wavelength)
	Returns the redshift of an object. More...

DLL_EXPORT double	vlbi_astro_estimate_size_transient (double transient_object_velocity, double transit_time)
	Returns the size of an object by the observation of a transient body. More...

DLL_EXPORT double	vlbi_astro_redshift_adjust (double distance, double redshift)
	Returns the distance of a far object adjusted with its measured redshift. More...

DLL_EXPORT dsp_stream_p	vlbi_file_read_fits (char *filename)
	Returns the distance of a far object adjusted with its measured redshift. More...

DLL_EXPORT dsp_stream_p *	vlbi_file_read_sdfits (char filename, long n)
	Returns the distance of a far object adjusted with its measured redshift. More...

Detailed Description

Function Documentation

◆ vlbi_astro_align_spectra()

DLL_EXPORT dsp_align_info vlbi_astro_align_spectra	(	dsp_stream_p	spectrum,
		dsp_stream_p	catalog,
		int	max_lines,
		double	decimals,
		double	min_score
	)

Parameters

spectrum	The spectrum to analyze
catalog	A catalog of spectra to compare
max_lines	The perfomance-needed limit of lines used for comparison
decimals	The number of decimals used in comparison
min_score	The trigger matching score percent to reach

Returns: An dsp_align_info structure containing the calculated offset and scale ratio

◆ vlbi_astro_alt_az_from_ra_dec()

DLL_EXPORT void vlbi_astro_alt_az_from_ra_dec	(	double	J2000time,
		double	Ra,
		double	Dec,
		double	Lat,
		double	Long,
		double *	Alt,
		double *	Az
	)

Parameters

J2000time	Current time offset in seconds from J2000
Ra	Right ascension coordinate of the object
Dec	Declination coordinate of object
Lat	Latitude of the observatory
Long	Longitude of the observatory
Alt	Altitude pointer
Az	Azimuth pointer

◆ vlbi_astro_create_reference_catalog()

DLL_EXPORT dsp_stream_p vlbi_astro_create_reference_catalog	(	dsp_stream_p *	catalog,
		int	catalog_size
	)

Parameters

catalog	A catalog of spectra
catalog_size	The size of the catalog

Returns: A dsp_stream_p structure containing all the spectral lines of the catalog spectra

◆ vlbi_astro_diff_spectra()

DLL_EXPORT double vlbi_astro_diff_spectra	(	dsp_stream_p	spectrum0,
		dsp_stream_p	spectrum,
		double	decades
	)

Parameters

spectrum0	The reference spectrum
spectrum	The spectrum to analyze
decades	The number of decades used in comparison

Returns: An estimation of the temperature difference between the two spectra

◆ vlbi_astro_estimate_brightness_temperature()

DLL_EXPORT double vlbi_astro_estimate_brightness_temperature	(	double	wavelength,
		double	flux
	)

Parameters

wavelength	The radiation wavelength in meters
flux	The measured radiation flux

Returns: An estimation of the brightness temperature in Kelvin

◆ vlbi_astro_estimate_distance_parallax()

DLL_EXPORT double vlbi_astro_estimate_distance_parallax	(	double	rad,
		double	baseline
	)

Parameters

rad	The angular distances from the baselines edges
baseline	The baseline

Returns: The distance of the object in same baseline's measure units

◆ vlbi_astro_estimate_distance_ratio()

DLL_EXPORT double vlbi_astro_estimate_distance_ratio	(	double	luminosity_ratio,
		double	flux_ratio
	)

Parameters

luminosity_ratio	The luminosity ratio
flux_ratio	The ratio between their fluxes

Returns: The ratio of the distance of the two objects

◆ vlbi_astro_estimate_flux()

DLL_EXPORT double vlbi_astro_estimate_flux	(	double	wavelength,
		double	temperature
	)

Parameters

wavelength	The radiation wavelength in meters
temperature	The measured temperature in Kelvin

Returns: An estimation of the temperature the flux on the indicated wavelength

◆ vlbi_astro_estimate_luminosity_ratio()

DLL_EXPORT double vlbi_astro_estimate_luminosity_ratio	(	double	size_ratio,
		double	flux_ratio
	)

Parameters

size_ratio	The size ratio between the two references
flux_ratio	The ratio of their fluxes

Returns: Their luminosity ratio

◆ vlbi_astro_estimate_redshift()

DLL_EXPORT double vlbi_astro_estimate_redshift	(	double	wavelength0,
		int	wavelength
	)

Parameters

wavelength0	The laboratory reference wavelength
wavelength	The same wavelength observed on the object

Returns: The redshift error amount

◆ vlbi_astro_estimate_size_ratio()

DLL_EXPORT double vlbi_astro_estimate_size_ratio	(	double	luminosity_ratio,
		double	temperature_ratio
	)

Parameters

luminosity_ratio	The luminosity ratio
temperature_ratio	The temperature ratio

Returns: The ratio of the two objects' sizes

◆ vlbi_astro_estimate_size_transient()

DLL_EXPORT double vlbi_astro_estimate_size_transient	(	double	transient_object_velocity,
		double	transit_time
	)

Parameters

transient_object_velocity	The velocity of the transient body
transit_time	The duration of the transition

Returns: The distance ran by the object during the transit time

◆ vlbi_astro_estimate_temperature()

DLL_EXPORT double vlbi_astro_estimate_temperature	(	double	wavelength,
		double	flux
	)

Parameters

wavelength	The radiation wavelength in meters
flux	The measured radiation flux

Returns: An estimation of the physical temperature in Kelvin

◆ vlbi_astro_estimate_temperature_ratio()

DLL_EXPORT double vlbi_astro_estimate_temperature_ratio	(	double	rad_ratio,
		double	flux_ratio
	)

Parameters

rad_ratio	The angular sizes ratio
flux_ratio	The flux ratio

Returns: The ratio of the two objects' temperatures

◆ vlbi_astro_flux_ratio()

DLL_EXPORT double vlbi_astro_flux_ratio	(	double	flux0,
		double	flux,
		double	delta_spectrum
	)

Parameters

flux0	The angular sizes ratio
flux	The flux ratio
delta_spectrum	The two objects' spectrum ratio

Returns: The ratio of the two objects' fluxes

◆ vlbi_astro_get_alt_az_coordinates()

DLL_EXPORT void vlbi_astro_get_alt_az_coordinates	(	double	hour_angle,
		double	dec,
		double	latitude,
		double *	alt,
		double *	az
	)

Parameters

hour_angle	Hour angle in hours (-12 to 12)
dec	DEC of object
latitude	latitude in INDI format (-90 to +90)
alt	ALT of object will be returned here
az	AZ of object will be returned here

◆ vlbi_astro_get_local_hour_angle()

DLL_EXPORT double vlbi_astro_get_local_hour_angle	(	double	local_sideral_time,
		double	ra
	)

Parameters

local_sideral_time	Local Sideral Time
ra	RA of object

Returns: Hour angle in hours (-12 to 12)

◆ vlbi_astro_load_spectra_catalog()

DLL_EXPORT int vlbi_astro_load_spectra_catalog	(	char *	path,
		dsp_stream_p **	catalog,
		int *	catalog_size
	)

Parameters

path	The path of the folder containing index.txt
catalog	A pointer to an array of dsp_stream_p to be allocated and filled
catalog_size	The catalog number of elements passed by reference

Returns: The number of spectra correctly parsed

◆ vlbi_astro_load_spectrum()

DLL_EXPORT dsp_stream_p vlbi_astro_load_spectrum ( char * filename )

Parameters

filename The spectrum file

Returns: a dsp_stream_p containgin the spectral lines in the spectrum file

◆ vlbi_astro_mean_speed()

DLL_EXPORT double vlbi_astro_mean_speed ( double speed )

Parameters

speed The speed constant value (Light meters per second for example)

Returns: if speed is less or equal to zero, return the last set or default value, otherwise the value just passed as argument

◆ vlbi_astro_redshift_adjust()

DLL_EXPORT double vlbi_astro_redshift_adjust	(	double	distance,
		double	redshift
	)

Parameters

distance	The calculated distance to be adjusted
redshift	The redshift measurement

Returns: The distance of the object adjusted by its current redshift

◆ vlbi_astro_save_spectrum()

DLL_EXPORT void vlbi_astro_save_spectrum	(	dsp_stream_p	stream,
		char *	filename
	)

Parameters

stream	The stream containing a spectrum
filename	The file name where to save the acquired spectrum

◆ vlbi_astro_scan_spectrum()

DLL_EXPORT void vlbi_astro_scan_spectrum	(	dsp_stream_p	stream,
		int	sample_size
	)

Parameters

stream	The stream containing a spectrum
sample_size	The sampling size used for detection

◆ vlbi_file_read_fits()

DLL_EXPORT dsp_stream_p vlbi_file_read_fits ( char * filename )

Parameters

filename The file name of the FITS file to open

Returns: A pointer to a dsp_stream filled with the needed data contained into the FITS file

◆ vlbi_file_read_sdfits()

DLL_EXPORT dsp_stream_p* vlbi_file_read_sdfits	(	char *	filename,
		long *	n
	)

Parameters

filename	The file name of the FITS file to open
n	the number of rows extracted and converted into dsp_stream structs

Returns: A pointer array to dsp_stream structs filled with the needed data contained into the SDFITS file rows

Functions

Detailed Description

Function Documentation

◆ vlbi_astro_align_spectra()

◆ vlbi_astro_alt_az_from_ra_dec()

◆ vlbi_astro_create_reference_catalog()

◆ vlbi_astro_diff_spectra()

◆ vlbi_astro_estimate_brightness_temperature()

◆ vlbi_astro_estimate_distance_parallax()

◆ vlbi_astro_estimate_distance_ratio()

◆ vlbi_astro_estimate_flux()

◆ vlbi_astro_estimate_luminosity_ratio()

◆ vlbi_astro_estimate_redshift()

◆ vlbi_astro_estimate_size_ratio()

◆ vlbi_astro_estimate_size_transient()

◆ vlbi_astro_estimate_temperature()

◆ vlbi_astro_estimate_temperature_ratio()

◆ vlbi_astro_flux_ratio()

◆ vlbi_astro_get_alt_az_coordinates()

◆ vlbi_astro_get_local_hour_angle()

◆ vlbi_astro_load_spectra_catalog()

◆ vlbi_astro_load_spectrum()

◆ vlbi_astro_mean_speed()

◆ vlbi_astro_redshift_adjust()

◆ vlbi_astro_save_spectrum()

◆ vlbi_astro_scan_spectrum()

◆ vlbi_file_read_fits()

◆ vlbi_file_read_sdfits()