/home/serge/sources/hyantes/geocode/hyantes.c

Section: C Library Functions (3) Updated: 21 Jul 2008 Local index Up

NAME

/home/serge/sources/hyantes/geocode/hyantes.c - front end part

SYNOPSIS

Defines

#define smoothing_error()
frees allocated memory in case of error in hs_smoothing
#define TIME_VAL_INIT { (time_t)0,(suseconds_t)0 }

Functions

const char ** hs_list_smoothing (size_t *sz)
list all available smoothing methods a smoothing method always take a radius and a distance (in kilometers) as input and returns a new distance (possibly zero)
unsigned long hs_status ()
observer of the execution of the computation
hs_potential_t * hs_smooth (int _resoLat, int _resoLon, hs_coord_t visu, FILE *pFileReference)
perform the smoothing of target area inside visu, using potentials from pFileReference pFileReference is either in raw or precomputed format, as given by hs_set(HS_LOAD_RAW|HS_LOAD_PRECOMPUTED) the smoothing is performed using smoothing method given by hs_set(HS_SMOOTH_FUNC, ... ) the resolution of the output matrix will be resoLat x resoLon
hs_potential_t * hs_smoothing (int _resoLat, int _resoLon, const char *function_name, double function_param, hs_coord_t visu, FILE *pFileReference)
perform the smoothing of target area inside visu, using potentials from pFileReference the smoothing is performed using function_name smoothing method, with a radius of function_param the resolution of the output matrix will be resoLat x resoLon

Detailed Description

front end part

Author:

: serge guelton

Date:

: 2008-02-13

Definition in file hyantes.c.

Define Documentation

#define smoothing_error()

Value:

if( ptrees != NULL ) free(ptrees);  if( pReference != NULL ) free(pReference);  if( out != NULL ) free(out);  return NULL;

frees allocated memory in case of error in hs_smoothing

Returns:

: NULL

Definition at line 42 of file hyantes.c.

Referenced by hs_smooth().

Function Documentation

const char** hs_list_smoothing (size_t * sz)

list all available smoothing methods a smoothing method always take a radius and a distance (in kilometers) as input and returns a new distance (possibly zero)

Parameters:

: sz pointer to the number of smoothing methods

Returns:

: array of string constant of size *sz. Memory is still owned by hyantes

Definition at line 57 of file hyantes.c.

References list_smoothing().

hs_potential_t* hs_smooth (int _resoLat, int _resoLon, hs_coord_t visu, FILE * pFileReference)

perform the smoothing of target area inside visu, using potentials from pFileReference pFileReference is either in raw or precomputed format, as given by hs_set(HS_LOAD_RAW|HS_LOAD_PRECOMPUTED) the smoothing is performed using smoothing method given by hs_set(HS_SMOOTH_FUNC, ... ) the resolution of the output matrix will be resoLat x resoLon

Parameters:

: resoLat number of latitude points computed
resoLon number of longitude points computed
visu visualization window
pFileReference file containg the data in the format latitude longitude potential latitude longitude potential ... latitude longitude potential where latitude and longitude are given in degrees

Returns:

: an allocated array of size resoLat x resoLon containing triplets (lat, lon, pot) or NULL if an error occured

Definition at line 93 of file hyantes.c.

References build_quadtree(), qt::coords, create_planartree(), do_smoothing(), free_quadtree(), hs_potential::lat, hs_potential::lon, hs_coord::MLat, hs_coord::mLat, hs_coord::MLon, hs_coord::mLon, read_input(), ptree::size, and smoothing_error.

Referenced by hs_smoothing().

hs_potential_t* hs_smoothing (int _resoLat, int _resoLon, const char * function_name, double function_param, hs_coord_t visu, FILE * pFileReference)

perform the smoothing of target area inside visu, using potentials from pFileReference the smoothing is performed using function_name smoothing method, with a radius of function_param the resolution of the output matrix will be resoLat x resoLon

Parameters:

: resoLat number of latitude points computed
resoLon number of longitude points computed
function_name name of a smoothing method listed by hs_list_smoothing
function_param parameter (in kilometers) of the smoothing method
visu visualization window
pFileReference file containg the data in the format latitude longitude potential latitude longitude potential ... latitude longitude potential where latitude and longitude are given in degrees

Returns: