area.c File Reference

#include <stdlib.h>
#include <grass/gis.h>
#include <grass/Vect.h>

Include dependency graph for area.c:

Go to the source code of this file.

Functions

int Vect_get_area_points (struct Map_info *Map, int area, struct line_pnts *BPoints)
 returns the polygon array of points in BPoints
int Vect_get_isle_points (struct Map_info *Map, int isle, struct line_pnts *BPoints)
 returns the polygon array of points in BPoints
int Vect_get_area_centroid (struct Map_info *Map, int area)
 returns centroid number of area
int Vect_get_area_boundaries (struct Map_info *Map, int area, struct ilist *List)
 creates list of boundaries for area
int Vect_get_isle_boundaries (struct Map_info *Map, int isle, struct ilist *List)
 creates list of boundaries for isle
int Vect_get_area_num_isles (struct Map_info *Map, int area)
 returns number of isles for area
int Vect_get_area_isle (struct Map_info *Map, int area, int isle)
 returns isle for area
int Vect_get_isle_area (struct Map_info *Map, int isle)
 returns area for isle
double Vect_area_perimeter (struct line_pnts *Points)
 calculate area perimeter
int Vect_point_in_area (struct Map_info *Map, int area, double x, double y)
 returns 1 if point is in area
double Vect_get_area_area (struct Map_info *Map, int area)
 returns area of area without areas of isles
int Vect_get_area_cats (struct Map_info *Map, int area, struct line_cats *Cats)
 Get area categories.
int Vect_get_area_cat (struct Map_info *Map, int area, int field)
 Find FIRST category of given field and area.


Function Documentation

double Vect_area_perimeter ( struct line_pnts *  Points  ) 

calculate area perimeter

Returns:
area perimeter
Parameters:
line_pnts * structure

Definition at line 338 of file area.c.

References Vect_line_length().

double Vect_get_area_area ( struct Map_info *  Map,
int  area 
)

returns area of area without areas of isles

Returns:
area of area without areas of isles
Parameters:
Map_info structure
area number

Definition at line 391 of file area.c.

References Vect_destroy_line_struct(), Vect_get_area_points(), Vect_get_isle_points(), and Vect_new_line_struct().

Referenced by Vect_remove_small_areas().

int Vect_get_area_boundaries ( struct Map_info *  Map,
int  area,
struct ilist *  List 
)

creates list of boundaries for area

Returns:
number of boundaries
Parameters:
Map_info structure, area number, List pointer to list

Definition at line 181 of file area.c.

References Vect_list_append(), and Vect_reset_list().

Referenced by Vect_remove_small_areas().

int Vect_get_area_cat ( struct Map_info *  Map,
int  area,
int  field 
)

Find FIRST category of given field and area.

Parameters:
vmap,: Map input
varea,: area number
Returns:
first found category of given field

-1 no centroid or no category found

Definition at line 462 of file area.c.

References Vect_get_area_cats(), Vect_new_cats_struct(), and Vect_reset_cats().

int Vect_get_area_cats ( struct Map_info *  Map,
int  area,
struct line_cats *  Cats 
)

Get area categories.

Parameters:
vmap,: Map input
varea,: area number
Returns:
0 OK centroid found (but may be without categories)

1 no centroid found

Definition at line 437 of file area.c.

References Vect_get_area_centroid(), Vect_read_line(), and Vect_reset_cats().

Referenced by Vect_get_area_cat().

int Vect_get_area_centroid ( struct Map_info *  Map,
int  area 
)

returns centroid number of area

Returns:
centroid number of area or 0
Parameters:
Map_info structure, area number

Definition at line 154 of file area.c.

Referenced by Vect_build_partial(), Vect_get_area_cats(), Vect_overlay_and(), Vect_remove_small_areas(), Vect_set_varray_from_cat_list(), and Vect_set_varray_from_db().

int Vect_get_area_isle ( struct Map_info *  Map,
int  area,
int  isle 
)

returns isle for area

Returns:
isles for area or 0
Parameters:
Map_info structure, area number, island number

Definition at line 284 of file area.c.

Referenced by Vect_get_point_in_area().

int Vect_get_area_num_isles ( struct Map_info *  Map,
int  area 
)

returns number of isles for area

Returns:
number of isles for area or 0
Parameters:
Map_info structure, area number

Definition at line 254 of file area.c.

Referenced by Vect_get_point_in_area().

int Vect_get_area_points ( struct Map_info *  Map,
int  area,
struct line_pnts *  BPoints 
)

returns the polygon array of points in BPoints

Returns:
number of points or -1 on error
Parameters:
Map_info structure, area number, line_pnts structure

Definition at line 32 of file area.c.

References Vect_append_points(), Vect_new_line_struct(), and Vect_read_line().

Referenced by Vect_get_area_area(), Vect_get_point_in_area(), Vect_isle_find_area(), and Vect_tin_get_z().

int Vect_get_isle_area ( struct Map_info *  Map,
int  isle 
)

returns area for isle

Returns:
area or 0
Parameters:
Map vector island number

Definition at line 312 of file area.c.

Referenced by Vect_select_areas_by_polygon().

int Vect_get_isle_boundaries ( struct Map_info *  Map,
int  isle,
struct ilist *  List 
)

creates list of boundaries for isle

Returns:
number of boundaries
Parameters:
Map vector map
isle island number
List pointer to list where boundaries are stored

Definition at line 219 of file area.c.

References Vect_list_append(), and Vect_reset_list().

int Vect_get_isle_points ( struct Map_info *  Map,
int  isle,
struct line_pnts *  BPoints 
)

returns the polygon array of points in BPoints

Returns:
number of points or -1 on error
Parameters:
Map_info structure, island number, line_pnts structure

Definition at line 96 of file area.c.

References Vect_append_points(), Vect_new_line_struct(), and Vect_read_line().

Referenced by Vect_find_island(), Vect_get_area_area(), and Vect_get_point_in_area().

int Vect_point_in_area ( struct Map_info *  Map,
int  area,
double  x,
double  y 
)

returns 1 if point is in area

Returns:
1 if point is in area 0 if not
Parameters:
Map_info structure, area number, xy coordinate of point

Definition at line 354 of file area.c.

References Vect_point_in_area_outer_ring(), and Vect_point_in_island().

Referenced by Vect_find_area().


Generated on Sun Apr 6 17:32:45 2008 for GRASS by  doxygen 1.5.5