m.measure
Measures the lengths and areas of features.
m.measure [-g] coordinates=east,north [,east,north,...] [units=string] [--verbose] [--quiet] [--qq] [--ui]
Example:
m.measure coordinates=east,north
grass.script.parse_command("m.measure", coordinates, units=None, flags=None, verbose=False, quiet=False, superquiet=False)
Example:
gs.parse_command("m.measure", coordinates=east,north)
Parameters
coordinates=east,north [,east,north,...] [required]
Coordinates
units=string
Units
Default: project map units
Allowed values: miles, feet, meters, kilometers, acres, hectares
-g
Shell script style
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
coordinates : list[tuple[float, float]] | tuple[float, float] | list[float] | str, required
Coordinates
Used as: input, coords, east,north
units : str, optional
Units
Default: project map units
Allowed values: miles, feet, meters, kilometers, acres, hectares
flags : str, optional
Allowed values: g
g
Shell script style
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
m.measure provides the user with a way to measure the lengths and areas of lines and polygons. Areas can be stated in acres, hectares, square miles, square feet, square meters and square kilometers.
EXAMPLES
Distance example in a latitude-longitude coordinate reference system (on great circle, i.e. an orthodrome):
Bonn_DE="7.09549,50.73438"
Philadelphia_US="-75.16379,39.95233"
m.measure coordinates="$Bonn_DE,$Philadelphia_US" units=kilometers
Length: 6217.916452 kilometers
Visualization (with d.geodesic) of m.measure
distance example
As an example for the North Carolina sample dataset, here four points describing a square of 1000m side length:
m.measure units=meters \
coordinates=922000,2106000,923000,2106000,923000,2107000,922000,2107000
Length: 3000.000000 meters
Area: 1000000.000000 square meters
# script style output:
m.measure -g units=hectares \
coordinates=922000,2106000,923000,2106000,923000,2107000,922000,2107000
units=meters,square meters
length=3000.000000
area=1000000.000000
SEE ALSO
AUTHORS
Glynn Clements
Some updates by Martin Landa, CTU in Prague, Czech Republic
Derived from d.measure by James Westervelt, Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
SOURCE CODE
Available at: m.measure source code
(history)
Latest change: Wednesday Feb 12 23:02:46 2025 in commit 9c11460