#include <grass/gis.h>
Go to the source code of this file.
Functions | |
int | G_begin_cell_area_calculations (void) |
Begin cell area calculations. | |
double | G_area_of_cell_at_row (int row) |
Cell area in specified row. | |
int | G_begin_polygon_area_calculations (void) |
Begin polygon area calculations. | |
double | G_area_of_polygon (const double *x, const double *y, int n) |
Area in square meters of polygon. |
(C) 2001-2008 by the GRASS Development Team
This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.
Definition in file area.c.
double G_area_of_cell_at_row | ( | int | row | ) |
double G_area_of_polygon | ( | const double * | x, | |
const double * | y, | |||
int | n | |||
) |
Area in square meters of polygon.
Returns the area in square meters of the polygon described by the n pairs of x,y coordinate vertices. It is used both for planimetric and latitude-longitude projections.
Returns the area in coordinate units of the polygon described by the n pairs of x,y coordinate vertices for planimetric grids. If the units for x,y are meters, then the area is in square meters. If the units are feet, then the area is in square feet, and so on.
Note: If the database is planimetric with the non-meter grid, this routine performs the required unit conversion to produce square meters.
[in] | x | array of x coordinates |
[in] | y | array of y coordinates |
[in] | n | number of x,y coordinate pairs |
Definition at line 165 of file area.c.
References G_ellipsoid_polygon_area(), and G_planimetric_polygon_area().
int G_begin_cell_area_calculations | ( | void | ) |
Begin cell area calculations.
This routine must be called once before any call to G_area_of_cell_at_row(). It perform all inititalizations needed to do area calculations for grid cells, based on the current window "projection" field. It can be used in either planimetric projections or the latitude-longitude projection.
If the return value is 1 or 0, all the grid cells in the map have the same area. Otherwise, the area of a grid cell varies with the row.
1 if the projection is planimetric (ie. UTM or SP)
2 if the projection is non-planimetric (ie. latitude-longitude)
Definition at line 50 of file area.c.
References G_begin_zone_area_on_ellipsoid(), G_begin_zone_area_on_sphere(), G_darea0_on_ellipsoid(), G_darea0_on_sphere(), G_database_units_to_meters_factor(), G_get_ellipsoid_parameters(), and G_get_set_window().
int G_begin_polygon_area_calculations | ( | void | ) |
Begin polygon area calculations.
This initializes the polygon area calculation routines. It is used both for planimetric and latitude-longitude projections.
1 if the projection is planimetric (ie. UTM or SP)
2 if the projection is non-planimetric (ie. latitude-longitude)
Definition at line 123 of file area.c.
References G_begin_ellipsoid_polygon_area(), G_database_units_to_meters_factor(), G_get_ellipsoid_parameters(), and G_projection().