v.ellipse

Computes the best-fitting ellipse for given vector data.

Command linePython (grass.script)

v.ellipse input=name output=name [step=float] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.ellipse input=name output=name

grass.script.run_command("v.ellipse", input, output, step=4, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.ellipse", input="name", output="name")

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input vector map
    Or data source for direct OGR access
output=name [required]
    Name for output vector map
step=float
    Step size in degrees
    Default: 4
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input vector map
    Or data source for direct OGR access
    Used as: input, vector, name
output : str, required
    Name for output vector map
    Used as: output, vector, name
step : float, optional
    Step size in degrees
    Default: 4
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
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

v.ellipse computes the best-fitting ellipse for input vector map and creates new output vector map with ellipse. Input vector data might be 2D points, lines, or areas.

Fig: Fitting ellipse created with v.ellipse

The parameters of ellipse are printed on output if --verbose flag is given.

EXAMPLE

Example of v.ellipse created around set of points (using data points_of_interest, North Carolina sample data set). Ellipse is is approximated by linestring with point distance 1 degree (step).

v.ellipse input=points_of_interest output=ellipse step=1

REFERENCES

• Charles F. Van Loan: Using the Ellipse to Fit and Enclose Data Points.

SEE ALSO

v.hull

AUTHOR

Tereza Fiedlerova, OSGeoREL, Czech Technical University in Prague, Czech Republic

SOURCE CODE

Available at: v.ellipse source code (history)
Latest change: Friday Feb 21 10:10:05 2025 in commit 7d78fe3