wtbarr Struct Reference

Extraction of coordinate lookup tables from BINTABLE. More...

`#include <getwcstab.h>`

## Data Fields

int | i
int | m
int | kind
char | extnam [72]
int | extver
int | extlev
char | ttype [72]
long | row
int | ndim
int * | dimlen
double ** | arrayp

## Detailed Description

Function wcstab(), which is invoked automatically by wcspih(), sets up an array of wtbarr structs to assist in extracting coordinate lookup tables from a binary table extension (BINTABLE) and copying them into the tabprm structs stored in wcsprm. Refer to the usage notes for wcspih() and wcstab() in wcshdr.h, and also the prologue to tab.h.

For C++ usage, because of a name space conflict with the wtbarr typedef defined in CFITSIO header fitsio.h, the wtbarr struct is renamed to wtbarr_s by preprocessor macro substitution with scope limited to wtbarr.h itself, and similarly in wcs.h.

## Field Documentation

## i

int wtbarr::i

(Given) Image axis number.

## m

int wtbarr::m

(Given) wcstab array axis number for index vectors.

## kind

int wtbarr::kind

(Given) Character identifying the wcstab array type:

- c: coordinate array,
- i: index vector.

## extnam

char wtbarr::extnam

(Given) `EXTNAME` identifying the binary table extension.

## extver

int wtbarr::extver

(Given) `EXTVER` identifying the binary table extension.

## extlev

int wtbarr::extlev

(Given) `EXTLEV` identifying the binary table extension.

## ttype

char wtbarr::ttype

(Given) `TTYPEn` identifying the column of the binary table that contains the wcstab array.

## row

long wtbarr::row

(Given) Table row number.

## ndim

int wtbarr::ndim

(Given) Expected dimensionality of the wcstab array.

## dimlen

int * wtbarr::dimlen

(Given) Address of the first element of an array of int of length ndim into which the wcstab array axis lengths are to be written.

## arrayp

double ** wtbarr::arrayp

(Given) Pointer to an array of double which is to be allocated by the user and into which the wcstab array is to be written.