GRASS Programmer's Manual  6.5.svn(2014)-r66266
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
area_sphere.c File Reference

GIS Library - Sphereical area calculation routines. More...

#include <math.h>
#include <grass/gis.h>
#include "pi.h"
Include dependency graph for area_sphere.c:

Go to the source code of this file.

Functions

int G_begin_zone_area_on_sphere (double r, double s)
 Initialize calculations for sphere. More...
 
double G_darea0_on_sphere (double lat)
 Calculates integral for area between two latitudes. More...
 
double G_area_for_zone_on_sphere (double north, double south)
 Calculates area between latitudes. More...
 

Detailed Description

GIS Library - Sphereical area calculation routines.

(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.

Author
GRASS GIS Development Team
Date
1999-2008

Definition in file area_sphere.c.

Function Documentation

double G_area_for_zone_on_sphere ( double  north,
double  south 
)

Calculates area between latitudes.

This routine shows how to calculate area between two lats, but isn't efficient for row by row since G_darea0_on_sphere() will be called twice for the same lat, once as a south then again as a north.
Returns the area between latitudes north and south scaled by the factor s passed to G_begin_zone_area_on_sphere().

Parameters
[in]north
[in]south
Returns
double

Definition at line 78 of file area_sphere.c.

References G_darea0_on_sphere().

int G_begin_zone_area_on_sphere ( double  r,
double  s 
)

Initialize calculations for sphere.

Initializes raster area calculations for a sphere. The radius of the sphere is r and s is a scale factor to allow for calculations of a part of the zone (see G_begin_zone_area_on_ellipsoid()).

Parameters
[in]rradius of sphere
[in]sscale factor
Returns
int

Definition at line 42 of file area_sphere.c.

Referenced by G_begin_cell_area_calculations().

double G_darea0_on_sphere ( double  lat)

Calculates integral for area between two latitudes.

Parameters
[in]latlatitude
Returns
double

Definition at line 55 of file area_sphere.c.

References Radians.

Referenced by G_area_for_zone_on_sphere(), and G_begin_cell_area_calculations().