v.in.ply

Creates a vector map from a PLY file.

v.in.ply [-tbp] input=name output=name [x=integer] [y=integer] [z=integer] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.in.ply input=name output=name

grass.script.run_command("v.in.ply", input, output, x=1, y=2, z=3, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

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

Parameters

Command linePython (grass.script)

input=name [required]
    Name of input file to be imported
    '-' for standard input
output=name [required]
    Name for output vector map
x=integer
    Number of vertex property used as x coordinate
    First vertex property is 1
    Default: 1
y=integer
    Number of vertex property used as y coordinate
    First vertex property is 1
    Default: 2
z=integer
    Number of vertex property used as z coordinate
    First vertex property is 1. If 0, z coordinate is not used
    Default: 3
-t
    Do not create attribute table
-b
    Do not build topology
-p
    Only print PLY element types and their properties.
--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 file to be imported
    '-' for standard input
    Used as: input, file, name
output : str, required
    Name for output vector map
    Used as: output, vector, name
x : int, optional
    Number of vertex property used as x coordinate
    First vertex property is 1
    Default: 1
y : int, optional
    Number of vertex property used as y coordinate
    First vertex property is 1
    Default: 2
z : int, optional
    Number of vertex property used as z coordinate
    First vertex property is 1. If 0, z coordinate is not used
    Default: 3
flags : str, optional
    Allowed values: t, b, p
    t
        Do not create attribute table
    b
        Do not build topology
    p
        Only print PLY element types and their properties.
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.in.ply imports a vector map in PLY vector format. A PLY file always holds a number of vertices which are imported as points. PLY vertices can have a number of properties in addition to their coordinates. These properties are stored in an attribute table. For larger PLY files with many vertices (> 1000) it is highly recommended to not use DBF as database driver, but SQLite (default in GRASS GIS 7), PostgreSQL or MySQL, because the DBF driver is rather slow and can consume a lot of memory. The database driver can be set with db.connect.

NOTES

v.in.ply is designed for large point clouds with the possibility to have only coordinates, and no attribute table (for speed reasons).

EXAMPLES

v.in.ply input=myfile.ply output=myfile

REFERENCES

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

AUTHOR

Markus Metz

SOURCE CODE

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