vocSesame.c File Reference

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <signal.h>
#include <errno.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <dirent.h>
#include "VOClient.h"

Classes
struct	Object
Defines
#define	_VOCLIENT_LIB_
#define	MAX_OBJECTS   128
#define	SZ_TARGET   128
Typedefs
typedef struct Object *	ObjectPtr
Functions
Sesame	voc_nameResolver (char *target)
	Query the CDS Sesame name resolver service.
char *	voc_resolverPos (Sesame sr)
	Return the (ra,dec) position for the object.
char *	voc_resolverOtype (Sesame sr)
	Return a string containing the object type description.
double	voc_resolverRA (Sesame sr)
	Return the RA as a double precision value.
double	voc_resolverRAErr (Sesame sr)
	Return the RA error as a double precision value.
double	voc_resolverDEC (Sesame sr)
	Return the DEC as a double precision value.
double	voc_resolverDECErr (Sesame sr)
	Return the Dec error as a double precision value.
char *	voc_getCacheDir (char *subdir)
Variables
Object	clientCache [MAX_OBJECTS]
int	cacheTop = 0
VOClient *	vo

---

Detailed Description

VOCSESAME.C -- Interface to the Sesame name resolver service.

DESCRIPTION

Sesame Name Resolver Interface: -------------------------------

sr = voc_nameResolver (target) pos_str = voc_resolverPos (sr) radeg = voc_resolverRA (sr) decdeg = voc_resolverDEC (sr) ra_err = voc_resolverRAErr (sr) dec_err = voc_resolverDECErr (sr) typ_str = voc_resolverOtype (sr)

Client programs may be written in any language that can interface to C code. Sample programs using the interface are provided as is a SWIG interface definition file. This inferface is based closely on the DAL client code produced for the 2005 NVOSS, as that interface evolves

Author:

Michael Fitzpatrick

Version:

June 2006

---

Function Documentation

Sesame voc_nameResolver

(

char *

target

)

Query the CDS Sesame name resolver service.

NAMERESOLVER -- Query the CDS Sesame service to resolve the target name to coordinates. The query is done when creating the Sesame object, thereafter we simply query the object data.

Parameters:

target

name of target to be resolved

Returns:

Sesame Sesame object handle

double voc_resolverDEC

(

Sesame

sr

)

Return the DEC as a double precision value.

RESOLVERDEC -- Return the DEC as a double precision value.

Parameters:

sr

handle to previus query return

Returns:

object Declination (decimal degrees)

double voc_resolverDECErr

(

Sesame

sr

)

Return the Dec error as a double precision value.

RESOLVERDECERR -- Return the Dec error as a double precision value.

Parameters:

sr

handle to previus query return

Returns:

object DEC error (decimal degrees)

char* voc_resolverOtype

(

Sesame

sr

)

Return a string containing the object type description.

RESOLVEROTYPE -- Return a string containing the object type description

Parameters:

sr

handle to previus query return

Returns:

string to object type description

char* voc_resolverPos

(

Sesame

sr

)

Return the (ra,dec) position for the object.

RESOLVERPOS -- Return a string containing the (ra,dec) position as sexagesimal strings.

Parameters:

sr

handle to previus query return

Returns:

string containing (ra,dec) position

double voc_resolverRA

(

Sesame

sr

)

Return the RA as a double precision value.

RESOLVERRA -- Return the RA as a double precision value.

Parameters:

sr

handle to previus query return

Returns:

object RA (decimal degrees)

double voc_resolverRAErr

(

Sesame

sr

)

Return the RA error as a double precision value.

RESOLVERRAERR -- Return the RA error as a double precision value.

Parameters:

sr

handle to previus query return

Returns:

object RA error (decimal degrees)