Vector library - topology level functions. More...

#include <stdlib.h>
#include <grass/vector.h>
#include <grass/glocale.h>

Include dependency graph for level_two.c:

Functions
plus_t	Vect_get_num_nodes (const struct Map_info *Map)
	Get number of nodes in vector map. More...

plus_t	Vect_get_num_primitives (const struct Map_info *Map, int type)
	Get number of primitives in vector map. More...

plus_t	Vect_get_num_lines (const struct Map_info *Map)
	Fetch number of features (points, lines, boundaries, centroids) in vector map. More...

plus_t	Vect_get_num_areas (const struct Map_info *Map)
	Get number of areas in vector map. More...

plus_t	Vect_get_num_kernels (const struct Map_info *Map)
	Fetch number of kernels in vector map. More...

plus_t	Vect_get_num_faces (const struct Map_info *Map)
	Get number of faces in vector map. More...

plus_t	Vect_get_num_volumes (const struct Map_info *Map)
	Fetch number of volumes in vector map. More...

plus_t	Vect_get_num_islands (const struct Map_info *Map)
	Get number of islands in vector map. More...

plus_t	Vect_get_num_holes (const struct Map_info *Map)
	Fetch number of holes in vector map. More...

int	Vect_get_num_dblinks (const struct Map_info *Map)
	Get number of defined dblinks. More...

int	Vect_get_num_updated_lines (const struct Map_info *Map)
	Get number of updated features. More...

int	Vect_get_updated_line (const struct Map_info *Map, int idx)
	Get updated line by index. More...

off_t	Vect_get_updated_line_offset (const struct Map_info *Map, int idx)
	Get updated line offset by index. More...

int	Vect_get_num_updated_nodes (const struct Map_info *Map)
	Get number of updated nodes. More...

int	Vect_get_updated_node (const struct Map_info *Map, int idx)
	Get updated (modified) node by index. More...

int	Vect_get_line_type (const struct Map_info *Map, int line)
	Get line type. More...

int	Vect_get_node_coor (const struct Map_info Map, int num, double x, double y, double z)
	Get node coordinates. More...

int	Vect_get_line_nodes (const struct Map_info Map, int line, int n1, int *n2)
	Get line nodes. More...

int	Vect_get_line_areas (const struct Map_info Map, int line, int left, int *right)
	Get area id on the left and right side of the boundary. More...

int	Vect_get_node_n_lines (const struct Map_info *Map, int node)
	Get number of lines for node. More...

int	Vect_get_node_line (const struct Map_info *Map, int node, int line)
	Get line id for node line index. More...

float	Vect_get_node_line_angle (const struct Map_info *Map, int node, int line)
	Angle of segment of the line connected to the node. More...

int	Vect_get_centroid_area (const struct Map_info *Map, int centroid)
	Get area id the centroid is within. More...

void	Vect_set_updated (struct Map_info *Map, int enable)
	Enable/disable maintanance of list of updated lines/nodes. More...

void	Vect_reset_updated (struct Map_info *Map)
	Reset list of updated lines/nodes. More...

Detailed Description

Vector library - topology level functions.

This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.

Author: Original author CERL, probably Dave Gerdes or Mike Higgins.; Update to GRASS 5.7 Radim Blazek and David D. Gray.; Update to GRASS 7 by Martin Landa <landa.martin gmail.com>

Definition in file level_two.c.

Function Documentation

◆ Vect_get_centroid_area()

int Vect_get_centroid_area	(	const struct Map_info *	Map,
		int	centroid
	)

Get area id the centroid is within.

Parameters

Map	pointer to Map_info struct
centroid	centroid id

Returns: area id the centroid is within; 0 for not in area; negative id if centroid is duplicated in the area

Definition at line 434 of file level_two.c.

Referenced by Vedit_delete_area_centroid().

◆ Vect_get_line_areas()

int Vect_get_line_areas	(	const struct Map_info *	Map,
		int	line,
		int *	left,
		int *	right
	)

Get area id on the left and right side of the boundary.

Negative area id indicates an isle.

Parameters

	Map	pointer to Map_info struct
	line	line id
[out]	left,right	area id on the left and right side

Returns: 1 on success; -1 on failure (topology not available, line is not a boundary)

Definition at line 350 of file level_two.c.

◆ Vect_get_line_nodes()

int Vect_get_line_nodes	(	const struct Map_info *	Map,
		int	line,
		int *	n1,
		int *	n2
	)

Get line nodes.

Parameters

Map	pointer to Map_info struct
line	line id
n1	(start node), n2 (end node) ids of line nodes (or NULL)

Returns: 1

Definition at line 307 of file level_two.c.

◆ Vect_get_line_type()

int Vect_get_line_type	(	const struct Map_info *	Map,
		int	line
	)

Get line type.

Parameters

Map	pointer to Map_info struct
line	line id

Returns: line type

Definition at line 258 of file level_two.c.

◆ Vect_get_node_coor()

int Vect_get_node_coor	(	const struct Map_info *	Map,
		int	num,
		double *	x,
		double *	y,
		double *	z
	)

Get node coordinates.

Parameters

	Map	pointer to Map_info struct
	num	node id (starts at 1)
[out]	x,y,z	coordinates values (for 2D coordinates z is NULL)

Returns: 0 on success; -1 on error

Definition at line 278 of file level_two.c.

References _, G_warning(), Plus_head::n_nodes, Plus_head::Node, NULL, Map_info::plus, P_node::x, P_node::y, and P_node::z.

Referenced by Vect_find_node().

◆ Vect_get_node_line()

int Vect_get_node_line	(	const struct Map_info *	Map,
		int	node,
		int	line
	)

Get line id for node line index.

Parameters

Map	pointer to Map_info struct
node	node id
line	line index (range: 0 - Vect_get_node_n_lines())

Returns: line id

Definition at line 401 of file level_two.c.

◆ Vect_get_node_line_angle()

float Vect_get_node_line_angle	(	const struct Map_info *	Map,
		int	node,
		int	line
	)

Angle of segment of the line connected to the node.

Parameters

Map	pointer to Map_info struct
node	node number
line	line index (range: 0 - Vect_get_node_n_lines())

Returns: angle of segment of the line connected to the node

Definition at line 417 of file level_two.c.

◆ Vect_get_node_n_lines()

int Vect_get_node_n_lines	(	const struct Map_info *	Map,
		int	node
	)

Get number of lines for node.

Parameters

Map	pointer to Map_info struct
node	node id

Returns: numbers of lines

Definition at line 384 of file level_two.c.

◆ Vect_get_num_areas()

plus_t Vect_get_num_areas ( const struct Map_info * Map )

Get number of areas in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of areas

Definition at line 86 of file level_two.c.

References Plus_head::n_areas, and Map_info::plus.

Referenced by vector2perimeters(), and Vedit_delete_areas_cat().

◆ Vect_get_num_dblinks()

int Vect_get_num_dblinks ( const struct Map_info * Map )

Get number of defined dblinks.

Parameters

Map	pointer to Map_info struct

Returns: number of dblinks

Definition at line 163 of file level_two.c.

References Map_info::dblnk, and dblinks::n_fields.

Referenced by Vect_copy_map_dblinks(), Vect_get_field2(), and Vect_get_field_number().

◆ Vect_get_num_faces()

plus_t Vect_get_num_faces ( const struct Map_info * Map )

Get number of faces in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of faces

Definition at line 111 of file level_two.c.

References Plus_head::n_flines, and Map_info::plus.

◆ Vect_get_num_holes()

plus_t Vect_get_num_holes ( const struct Map_info * Map )

Fetch number of holes in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of holes

Definition at line 150 of file level_two.c.

References Plus_head::n_holes, and Map_info::plus.

◆ Vect_get_num_islands()

plus_t Vect_get_num_islands ( const struct Map_info * Map )

Get number of islands in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of islands

Definition at line 137 of file level_two.c.

References Plus_head::n_isles, and Map_info::plus.

◆ Vect_get_num_kernels()

plus_t Vect_get_num_kernels ( const struct Map_info * Map )

Fetch number of kernels in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of kernels

Definition at line 98 of file level_two.c.

References Plus_head::n_klines, and Map_info::plus.

◆ Vect_get_num_lines()

plus_t Vect_get_num_lines ( const struct Map_info * Map )

Fetch number of features (points, lines, boundaries, centroids) in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of features

Definition at line 74 of file level_two.c.

References Plus_head::n_lines, and Map_info::plus.

Referenced by NetA_initialise_varray(), and Vect_fidx_dump().

◆ Vect_get_num_nodes()

plus_t Vect_get_num_nodes ( const struct Map_info * Map )

Get number of nodes in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of nodes

Definition at line 34 of file level_two.c.

References Plus_head::n_nodes, and Map_info::plus.

◆ Vect_get_num_primitives()

plus_t Vect_get_num_primitives	(	const struct Map_info *	Map,
		int	type
	)

Get number of primitives in vector map.

Parameters

Map	pointer to Map_info struct
type	feature type

Returns: number of primitives

Definition at line 47 of file level_two.c.

◆ Vect_get_num_updated_lines()

int Vect_get_num_updated_lines ( const struct Map_info * Map )

Get number of updated features.

Note: Vect_set_updated() must be called to maintain list of updated features

Parameters

Map	pointer to Map_info struct

Returns: number of updated features

Definition at line 179 of file level_two.c.

References Plus_head::n_uplines, Map_info::plus, and Plus_head::uplist.

◆ Vect_get_num_updated_nodes()

int Vect_get_num_updated_nodes ( const struct Map_info * Map )

Get number of updated nodes.

Parameters

Map	pointer to Map_info struct

Returns: number of updated nodes

Definition at line 223 of file level_two.c.

References Plus_head::n_upnodes, Map_info::plus, and Plus_head::uplist.

◆ Vect_get_num_volumes()

plus_t Vect_get_num_volumes ( const struct Map_info * Map )

Fetch number of volumes in vector map.

Parameters

Map	pointer to Map_info struct

Returns: number of volumes

Definition at line 124 of file level_two.c.

References Plus_head::n_volumes, and Map_info::plus.

◆ Vect_get_updated_line()

int Vect_get_updated_line	(	const struct Map_info *	Map,
		int	idx
	)

Get updated line by index.

Note: Vect_set_updated() must be called to maintain list of updated features

Parameters

Map	pointer to Map_info struct
idx	index

Returns: updated line

Definition at line 195 of file level_two.c.

References Map_info::plus, Plus_head::uplines, and Plus_head::uplist.

◆ Vect_get_updated_line_offset()

off_t Vect_get_updated_line_offset	(	const struct Map_info *	Map,
		int	idx
	)

Get updated line offset by index.

Note: Vect_set_updated() must be called to maintain list of updated features

Parameters

Map	pointer to Map_info struct
idx	index

Returns: updated line

Definition at line 211 of file level_two.c.

References Map_info::plus, Plus_head::uplines_offset, and Plus_head::uplist.

◆ Vect_get_updated_node()

int Vect_get_updated_node	(	const struct Map_info *	Map,
		int	idx
	)

Get updated (modified) node by index.

Note: Vect_set_updated() must be called to maintain list of updated features

Negative id:

if Node[id] is not NULL then the node was added
if Node[id] is NULL then the node was deleted Positive id:
node was updated

Parameters

Map	pointer to Map_info struct
idx	index

Returns: id of modified node

Definition at line 245 of file level_two.c.

References Map_info::plus, Plus_head::uplist, and Plus_head::upnodes.

◆ Vect_reset_updated()

void Vect_reset_updated ( struct Map_info * Map )

Reset list of updated lines/nodes.

Parameters

Map	pointer to Map_info struct

Definition at line 472 of file level_two.c.

◆ Vect_set_updated()

void Vect_set_updated	(	struct Map_info *	Map,
		int	enable
	)

Enable/disable maintanance of list of updated lines/nodes.

See Plus_head.uplist for details.

Parameters

Map	pointer to Map_info struct
enable	TRUE/FALSE to enable/disable

Definition at line 458 of file level_two.c.

References G_debug(), and Map_info::name.

Functions

Detailed Description

Function Documentation

◆ Vect_get_centroid_area()

◆ Vect_get_line_areas()

◆ Vect_get_line_nodes()

◆ Vect_get_line_type()

◆ Vect_get_node_coor()

◆ Vect_get_node_line()

◆ Vect_get_node_line_angle()

◆ Vect_get_node_n_lines()

◆ Vect_get_num_areas()

◆ Vect_get_num_dblinks()

◆ Vect_get_num_faces()

◆ Vect_get_num_holes()

◆ Vect_get_num_islands()

◆ Vect_get_num_kernels()

◆ Vect_get_num_lines()

◆ Vect_get_num_nodes()

◆ Vect_get_num_primitives()

◆ Vect_get_num_updated_lines()

◆ Vect_get_num_updated_nodes()

◆ Vect_get_num_volumes()

◆ Vect_get_updated_line()

◆ Vect_get_updated_line_offset()

◆ Vect_get_updated_node()

◆ Vect_reset_updated()

◆ Vect_set_updated()