v.out.ply

Exports a vector map to a PLY file.

Command linePython (grass.script)

v.out.ply [-r] input=name [layer=string] [output=name] [columns=name [,name,...]] [dp=integer] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.out.ply input=name

grass.script.run_command("v.out.ply", input, layer="1", output="-", columns=None, dp=6, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.out.ply", input="name")

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input vector map
    Or data source for direct OGR access
layer=string
    Layer number or name
    Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    Default: 1
output=name
    Name for output PLY file
    '-' for standard output
    Default: -
columns=name [,name,...]
    Name of attribute column(s) to be exported
dp=integer
    Number of significant digits (floating point only)
    Allowed values: 0-32
    Default: 6
-r
    Only export points falling within current 3D region (points mode)
--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
layer : str, optional
    Layer number or name
    Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    Used as: input, layer
    Default: 1
output : str, optional
    Name for output PLY file
    '-' for standard output
    Used as: output, file, name
    Default: -
columns : str | list[str], optional
    Name of attribute column(s) to be exported
    Used as: input, dbcolumn, name
dp : int, optional
    Number of significant digits (floating point only)
    Allowed values: 0-32
    Default: 6
flags : str, optional
    Allowed values: r
    r
        Only export points falling within current 3D region (points mode)
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.out.ply converts a GRASS vector map in binary format to an ASCII file in PLY format. Currently supported is points export only. v.out.ply is designed for large point clouds and fairly fast if only coordinates are exported. The export of attributes with the option columns can slow down the export considerably.

If the output parameter is not given then the coordinates of any point data within the vector map is sent to stdout.

REFERENCES

https://paulbourke.net/dataformats/ply
https://sites.cc.gatech.edu/projects/large_models/ply.html

AUTHOR

Markus Metz
based on v.out.ascii

SOURCE CODE

Available at: v.out.ply source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819