Provided by: libhyantes-dev_1.3.0-2ubuntu1_amd64 
NAME
/home/serge/sources/hyantes/src/hyantes.h -
hyantes.c header
SYNOPSIS
Data Structures
struct hs_config_t
configuration structure to use custom settings in hyantes fuctions
struct hs_potential
structure containing the coordinate of a potential all coordiante are given in radians which means
that
struct hs_coord
structure containing the coordinates of an area all coordinate are given in degree which means that
-90 <= latitude <= 90 and -180 <= longitude <= +180
Defines
#define INPUT_FORMAT '%lf%*[ ]%lf%*[ ]%lf'
#define OUTPUT_FORMAT '%lf %lf %lf0
#define COS cos
#define SIN sin
#define ACOS acos
Typedefs
typedef double data_t
typedef struct hs_potential hs_potential_t
structure containing the coordinate of a potential all coordiante are given in radians which means
that
typedef struct hs_coord hs_coord_t
structure containing the coordinates of an area all coordinate are given in degree which means that
-90 <= latitude <= 90 and -180 <= longitude <= +180
Enumerations
enum smoothing_fun_t { F_DISK, F_AMORTIZED_DISK, F_GAUSSIAN, F_EXPONENTIAL, F_PARETO }
enumeration of all available smoothing functions
enum hs_option_t { HS_PARSE_ONLY, HS_THRESHOLD, HS_LOAD_RAW, HS_LOAD_PRECOMPUTED, HS_SMOOTH_FUNC,
HS_MODULE_OPT }
enumeration of various options for hyantes
Functions
void hs_display (size_t rangex, size_t rangey, hs_potential_t pt[rangex][rangey])
int hs_set_r (hs_config_t *, hs_option_t,...)
sets the given option to the given parameters in the given configuration
int hs_set (hs_option_t,...)
sets the given option to the given parameters in the default configuration (deprecated, you should
use your own configuration structure)
hs_potential_t * hs_smooth (int _reoLat, int _resoLon, hs_coord_t visu, FILE *pFileReference)
performs the smoothing of target area inside visu, using potentials from pFileReference 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_smooth_r (int _reoLat, int _resoLon, hs_coord_t visu, FILE *pFileReference,
hs_config_t *config)
performs the smoothing of target area inside visu, using potentials from pFileReference and using
given hs_config the smoothing is performed using smoothing method acording to the configuration given
in the arguments 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 (obsolete function, use hs_smmoth_r instead)
unsigned long hs_status ()
observer of the execution of the computation
const char ** hs_list_smoothing (size_t *sz)
list all available smoothing methods that can be configured using hs_config
Detailed Description
hyantes.c header
Author:
Sebastien Martinez and Serge Guelton
Date:
2011-06-01
This file is part of hyantes.
hyantes is free software; you can redistribute it and/or modify it under the terms of the CeCILL-C
License
You should have received a copy of the CeCILL-C License along with this program. If not, see
<http://www.cecill.info/licences>.
Definition in file hyantes.h.
Typedef Documentation
typedef struct hs_potential hs_potential_t
structure containing the coordinate of a potential all coordiante are given in radians which means that
-90 <= latitude <= +90 and -180 <= longitude <= +180
Enumeration Type Documentation
enum hs_option_t
enumeration of various options for hyantes
Enumerator:
HS_PARSE_ONLY
(deprecated) only require generation of precomputed quadtree, extra arg : 'char *filename'
HS_THRESHOLD
(deprecated) set the threshold used for ignoring some area, extra arg: 'double threshold'
HS_LOAD_RAW
(deprecated) tells the library to consider input file as a raw data file, no extra arg
HS_LOAD_PRECOMPUTED
(deprecated) tells the library to consider input file as a precomputed file, no extra arg
HS_SMOOTH_FUNC
tells the library to use given function and param to perform smoothing, extra arg: "char
*funcname, double extra param, ...
HS_MODULE_OPT
(deprecated) pass option to module
Definition at line 61 of file hyantes.h.
enum smoothing_fun_t
enumeration of all available smoothing functions
Enumerator:
F_DISK Disk smoothing method
F_AMORTIZED_DISK
smoothing method amortizing potential
F_GAUSSIAN
smoothing method using gaussian distribution
F_EXPONENTIAL
smoothing method using exponential distribution
F_PARETO
smoothing method using pareto distribution
Definition at line 48 of file hyantes.h.
Function Documentation
const char** hs_list_smoothing (size_t *sz)
list all available smoothing methods that can be configured using hs_config Parameters:
pointer to the number of smoothing methods
Returns:
array of string constant of size *sz. Memory is still owned by hyantes
Definition at line 219 of file hyantes.c.
References func_names.
Referenced by vhs_set_r().
int hs_set (hs_option_topt, ...)
sets the given option to the given parameters in the default configuration (deprecated, you should use
your own configuration structure) Parameters:
opt option to set
... list of arguments
Returns:
1 if setting went well, 0 otherwise
Definition at line 96 of file options.c.
References vhs_set_r().
int hs_set_r (hs_config_t *config, hs_option_topt, ...)
sets the given option to the given parameters in the given configuration Parameters:
config pointer to the configuration to use
opt option to set
... list of arguments
Returns:
1 if setting went well, 0 otherwise
Definition at line 82 of file options.c.
References vhs_set_r().
Referenced by hs_smoothing().
hs_potential_t* hs_smooth (int_resoLat, int_resoLon, hs_coord_tvisu, FILE *pFileReference)
performs the smoothing of target area inside visu, using potentials from pFileReference 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 a struct (lat, lon, pot) or NULL if an error
occured
Definition at line 209 of file hyantes.c.
References hs_smooth_r().
hs_potential_t* hs_smooth_r (int_resoLat, int_resoLon, hs_coord_tvisu, FILE *pFileReference, hs_config_t
*configuration)
performs the smoothing of target area inside visu, using potentials from pFileReference and using given
hs_config the smoothing is performed using smoothing method acording to the configuration given in the
arguments 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
configuration configuration to use
Returns:
an allocated array of size resoLat x resoLon containing structs (lat, lon, pot) or NULL if an error
occured
Definition at line 252 of file hyantes.c.
References do_run(), hs_config_t::herrno, hs_read_towns(), hs_coord::mLat, hs_coord::MLat,
hs_coord::mLon, and hs_coord::MLon.
Referenced by hs_smooth(), and hs_smoothing().
hs_potential_t* hs_smoothing (int_resoLat, int_resoLon, const char *function_name, doublefunction_param,
hs_coord_tvisu, 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 (obsolete function, use hs_smmoth_r instead) 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
parameter (in kilometers) of the smoothing method
visu visualization window
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 structs (lat, lon, pot)
Definition at line 302 of file hyantes.c.
References hs_set_r(), HS_SMOOTH_FUNC, and hs_smooth_r().
unsigned long hs_status ()
observer of the execution of the computation Returns:
number of computed input potential points from the beginning of the computation
Definition at line 228 of file hyantes.c.
References hs_config_t::status.
Author
Generated automatically by Doxygen for Hyantes from the source code.