/home/serge/sources/hyantes/src/hyantes.h(3) | Library Functions Manual | /home/serge/sources/hyantes/src/hyantes.h(3) |
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:
Date:
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:
Returns:
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:
... list of arguments
Returns:
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:
opt option to set
... list of arguments
Returns:
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:
_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:
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:
_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:
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:
_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:
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:
Definition at line 228 of file hyantes.c.
References hs_config_t::status.
Author¶
Generated automatically by Doxygen for Hyantes from the source code.
Sun May 20 2012 | Hyantes |