Vector library - OGC Simple Features Access. More...

#include <stdio.h>
#include <grass/vector.h>
#include <grass/glocale.h>
#include <ogr_api.h>
#include "pg_local_proto.h"

Include dependency graph for simple_features.c:

Go to the source code of this file.

Functions
SF_FeatureType	Vect_sfa_get_line_type (const struct line_pnts *Points, int type, int with_z)
	Get SF type of given vector feature.

int	Vect_sfa_get_type (SF_FeatureType sftype)
	Get relevant GV type.

int	Vect_sfa_check_line_type (const struct line_pnts *Points, int type, SF_FeatureType sftype, int with_z)
	Check SF type.

int	Vect_sfa_line_dimension (int type)
	Get geometry dimension.

char *	Vect_sfa_line_geometry_type (const struct line_pnts *Points, int type)
	Get geometry type (string)

int	Vect_sfa_line_astext (const struct line_pnts Points, int type, int with_z, int precision, FILE file)
	Export geometry to Well-Known Text.

int	Vect_sfa_is_line_simple (const struct line_pnts *Points, int type, int with_z)
	Check if feature is simple.

int	Vect_sfa_is_line_closed (const struct line_pnts *Points, int type, int with_z)
	Check if feature is closed.

int	Vect_sfa_get_num_features (struct Map_info *Map)
	Get number of simple features.

Detailed Description

Vector library - OGC Simple Features Access.

Higher level functions for reading/writing/manipulating vectors.

Note: In progress! Currently on GV_POINT, GV_LINE, GV_BOUNDARY are supported.

Todo:

Vect_sfa_line_is_simple()
Vect_sfa_line_srid()
Vect_sfa_line_envelope()
Vect_sfa_line_asbinary()
Vect_sfa_line_is_empty()
Vect_sfa_line_is_3d()
Vect_sfa_line_is_measured()
Vect_sfa_line_boundary()

Reference: http://www.opengeospatial.org/standards/sfa

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

Author: Martin Landa <landa.martin gmail.com>

Definition in file simple_features.c.

Function Documentation

◆ Vect_sfa_check_line_type()

int Vect_sfa_check_line_type	(	const struct line_pnts *	Points,
		int	type,
		SF_FeatureType	sftype,
		int	with_z
	)

Check SF type.

E.g. if type is GV_LINE with two or more segments and the start node is identical with the end node, and sftype is SF_LINEARRING, functions returns 1, otherwise 0.

Parameters

Points	pointer to line_pnts structure
type	feature type (GV_POINT, GV_LINE, ...)
sftype	SF type to be checked (SF_POINT, SF_LINE, ...)
with_z	non-zero value for 3D data

Returns: 1 if type is sftype; 0 type differs from sftype

Definition at line 111 of file simple_features.c.

◆ Vect_sfa_get_line_type()

SF_FeatureType Vect_sfa_get_line_type	(	const struct line_pnts *	Points,
		int	type,
		int	with_z
	)

Get SF type of given vector feature.

List of supported feature types:

GV_POINT -> SF_POINT
GV_LINE -> SF_LINESTRING
GV_LINE (closed) -> SF_LINEARRING
GV_BOUNDARY -> SF_POLYGON

Parameters

Points	pointer to line_pnts structure
type	feature type (see supported types above)
with_z	WITH_Z for 3D data

Returns: SF type identificator (see list of supported types); -1 on error

Definition at line 62 of file simple_features.c.

Referenced by Vect_sfa_line_astext(), and Vect_sfa_line_geometry_type().

◆ Vect_sfa_get_num_features()

int Vect_sfa_get_num_features ( struct Map_info * Map )

Get number of simple features.

For native format or PostGIS Topology returns -1

Parameters

Map	vector map

Returns: number of features; -1 on error

Definition at line 298 of file simple_features.c.

References _, DB_SQL_MAX, G_fatal_error(), G_free(), G_warning(), GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, TRUE, Vect__execute_get_value_pg(), and Vect_get_full_name().

◆ Vect_sfa_get_type()

int Vect_sfa_get_type ( SF_FeatureType sftype )

Get relevant GV type.

Parameters

sftype SF geometry type (SF_POINT, SF_LINESTRING, ...)

Returns: GV type; -1 on error

Definition at line 76 of file simple_features.c.

References GV_BOUNDARY, GV_LINE, GV_POINT, SF_LINEARRING, SF_LINESTRING, SF_LINESTRING25D, SF_POINT, SF_POINT25D, SF_POLYGON, and SF_POLYGON25D.

◆ Vect_sfa_is_line_closed()

int Vect_sfa_is_line_closed	(	const struct line_pnts *	Points,
		int	type,
		int	with_z
	)

Check if feature is closed.

Parameters

Points	pointer to line_pnts structure
type	feature type (GV_LINE or GV_BOUNDARY)
with_z

Returns: 1 feature closed; 0 feature not closed; -1 feature type not supported (GV_POINT, GV_CENTROID, ...)

Definition at line 269 of file simple_features.c.

References GV_LINES, Vect_get_num_line_points(), line_pnts::x, line_pnts::y, and line_pnts::z.

◆ Vect_sfa_is_line_simple()

int Vect_sfa_is_line_simple	(	const struct line_pnts *	Points,
		int	type,
		int	with_z
	)

Check if feature is simple.

Parameters

Points	pointer to line_pnts structure (unused)
type	feature type (GV_POINT, GV_LINE, ...) (unused)
with_z	(unused)

Returns: 1 feature simple; 0 feature not simple; -1 feature type not supported (GV_POINT, GV_CENTROID, ...)

Note: Implementation is pending, now always returns 0

Definition at line 245 of file simple_features.c.

◆ Vect_sfa_line_astext()

int Vect_sfa_line_astext	(	const struct line_pnts *	Points,
		int	type,
		int	with_z,
		int	precision,
		FILE *	file
	)

Export geometry to Well-Known Text.

Parameters

	Points	pointer to line_pnts structure
	type	feature type
	with_z	non-zero value for 3D data
	precision	floating number precision
[out]	file	file where to write the output

Returns: 0 on success; -1 unsupported feature type

Definition at line 184 of file simple_features.c.

References _, file, G_warning(), line_pnts::n_points, SF_LINEARRING, SF_LINESTRING, SF_POINT, SF_POLYGON, and Vect_sfa_get_line_type().

Referenced by Vect_write_ascii().

◆ Vect_sfa_line_dimension()

int Vect_sfa_line_dimension ( int type )

Get geometry dimension.

Parameters

type	feature type (GV_POINT, GV_LINE, ...)

Returns: 0 for GV_POINT; 1 for GV_LINE; 2 for GV_BOUNDARY; -1 unsupported feature type

Definition at line 127 of file simple_features.c.

References GV_BOUNDARY, GV_LINE, and GV_POINT.

◆ Vect_sfa_line_geometry_type()

char * Vect_sfa_line_geometry_type	(	const struct line_pnts *	Points,
		int	type
	)

Get geometry type (string)

Supported types:

GV_POINT -> SF_POINT -> "POINT"
GV_LINE -> SF_LINESTRING -> "LINESTRING"
GV_LINE (closed) -> SF_LINEARRING -> "LINEARRING"
GV_BOUNDARY (closed) -> SF_POLYGON -> "POLYGON"

Note: Allocated string should be freed by G_free().

Parameters

Points	pointer to line_pnts structure (feature geometry)
type	feature type (see supported types above)

Returns: geometry type string; NULL unsupported feature type

Definition at line 156 of file simple_features.c.

References G_store(), NULL, SF_LINEARRING, SF_LINESTRING, SF_POINT, SF_POLYGON, and Vect_sfa_get_line_type().

Functions

Detailed Description

Function Documentation

◆ Vect_sfa_check_line_type()

◆ Vect_sfa_get_line_type()

◆ Vect_sfa_get_num_features()

◆ Vect_sfa_get_type()

◆ Vect_sfa_is_line_closed()

◆ Vect_sfa_is_line_simple()

◆ Vect_sfa_line_astext()

◆ Vect_sfa_line_dimension()

◆ Vect_sfa_line_geometry_type()