mrtk_antenna.h File Reference

MRTKLIB Antenna Module — Antenna phase center model and parameter I/O. More...

#include "mrtklib/mrtk_nav.h"

Include dependency graph for mrtk_antenna.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	readpcv (const char *file, pcvs_t *pcvs)
	Read antenna parameters from file (ANTEX or NGS format).
pcv_t *	searchpcv (int sat, const char *type, gtime_t time, const pcvs_t *pcvs)
	Search antenna parameter by satellite number or antenna type.
void	antmodel (const pcv_t *pcv, const double *del, const double *azel, int opt, double *dant)
	Compute receiver antenna offset by antenna phase center parameters.
void	antmodel_s (const pcv_t *pcv, double nadir, double *dant)
	Compute satellite antenna phase center parameters.

Detailed Description

MRTKLIB Antenna Module — Antenna phase center model and parameter I/O.

This header provides antenna phase center variation (PCV) model computation and antenna parameter file reading functions, extracted from rtkcmn.c with zero algorithmic changes.

Note

Functions declared here are implemented in mrtk_antenna.c.

Definition in file mrtk_antenna.h.

Function Documentation

antmodel()

void antmodel	(	const pcv_t *	pcv,
		const double *	del,
		const double *	azel,
		int	opt,
		double *	dant )

Compute receiver antenna offset by antenna phase center parameters.

Parameters

[in]	pcv	Antenna phase center parameters
[in]	del	Antenna delta {e,n,u} (m)
[in]	azel	Azimuth/elevation for receiver {az,el} (rad)
[in]	opt	Option (0:only offset, 1:offset+pcv)
[out]	dant	Range offsets for each frequency (m)

Note

Current version does not support azimuth dependent terms

Definition at line 481 of file mrtk_antenna.c.

References dot(), interpvar(), NFREQPCV, pcv_t::off, R2D, trace(), and pcv_t::var.

Referenced by clas_osr_corrmeas(), zdres(), and zdres().

Here is the call graph for this function:

Here is the caller graph for this function:

antmodel_s()

void antmodel_s	(	const pcv_t *	pcv,
		double	nadir,
		double *	dant )

Compute satellite antenna phase center parameters.

Parameters

[in]	pcv	Antenna phase center parameters
[in]	nadir	Nadir angle for satellite (rad)
[out]	dant	Range offsets for each frequency (m)

Definition at line 507 of file mrtk_antenna.c.

References interpvar(), NFREQPCV, R2D, trace(), and pcv_t::var.

Here is the call graph for this function:

readpcv()

int readpcv	(	const char *	file,
		pcvs_t *	pcvs )

Read antenna parameters from file (ANTEX or NGS format).

Parameters

[in]	file	Antenna parameter file
[in,out]	pcvs	Antenna parameters

Returns

Status (1:ok, 0:file open error)

Note

File with extension .atx/.ATX is recognized as ANTEX format; other files are recognized as NGS format. Only supports non-azimuth-dependent parameters.

Definition at line 255 of file mrtk_antenna.c.

References pcv_t::code, matcpy(), pcvs_t::n, NFREQPCV, norm(), pcv_t::off, pcvs_t::pcv, readantex(), readngspcv(), pcv_t::sat, trace(), pcv_t::type, and pcv_t::var.

Referenced by openses(), and readsap().

Here is the call graph for this function:

Here is the caller graph for this function:

searchpcv()

pcv_t * searchpcv	(	int	sat,
		const char *	type,
		gtime_t	time,
		const pcvs_t *	pcvs )

Search antenna parameter by satellite number or antenna type.

Parameters

[in]	sat	Satellite number (0: receiver antenna)
[in]	type	Antenna type for receiver antenna
[in]	time	Time to search parameters (GPST)
[in]	pcvs	Antenna parameters

Returns

Antenna parameter (NULL: no antenna found)

Definition at line 416 of file mrtk_antenna.c.

References MAXANT, pcvs_t::n, pcvs_t::pcv, pcv_t::sat, pcv_t::te, gtime_t::time, timediff(), trace(), pcv_t::ts, and pcv_t::type.

Referenced by readsap(), and setpcv().

Here is the call graph for this function:

Here is the caller graph for this function: