Engines Home  |  POINT CLOUD

Point Cloud Import/Export Library

The Point Cloud Converter can be executed from the command line as an MSX tool.  The syntax for using the Point Cloud Import/Export Library from the command line is described below.

 

NOTES:   

  • In regards to using multiple input source files, blank space cannot be placed after a semicolon (though this can be done in the user interface inside MS3D).   Otherwise the convert will not work properly.

Multiple CSV files that are delimited by a semicolon can be entered as input source files in the Command Line version of Point Cloud.  No space between files is allowed, otherwise:

  • If "-o" is used, only the first file will be converted.

  • If no "-o", the second source file will be overwritten by the output result.

  • In regards to using Riegl RiSCAN PRO project files (*.rsp), there is no way to select individual scans (*.rxp) with a scan position using the Command Line version.  Only the first scan for each position will be converted.  

Use the syntax “msx pointcloud –h” to display this help:

 

 

Point Cloud Import/Export Library

 

Usage:

   msx pointcloud [-i] <inputfile> [-o] <outputfile> [OPTIONS]

 

   <inputfile>

      Full path of file to be converted.  Can be specified

      as first argument or following the "-i" option. Input should

      be an ASCII file (.csv, .xyz, etc) unless using the "-hpc" option.

      If multiple files are being imported, seperate them with semicolons.

 

   <outputfile>

      Full path of file to be exported to.  Can be specified

      as second argument or following the "-o" option.

 

Options:

 

   -h, -help

      Display this help.

 

   -v <size>, -voxel_size <size>

      Specify the voxel size (resolution) of the output Point Cloud file

      (default is 1.0).

 

   -xyz <x_index> <y_index> <z_index>, -xyz_index <x_index> <y_index> <z_index>

      Specify the column indeces for x,y and z (defaults are 1,2 and 3).

 

   -rgb [<r_index> <g_index> <b_index>]

      To read RGB colors from the ASCII input file.

      (Default option: read intensity).

      r_index, g_index, and b_index are the column indices for

      RED,     GREEN,   and BLUE, respectively. (Defaults are 4,5,and 6).

 

   -rgbsolid [<r_value> <g_value> <b_value>],

   -rgbs [<r_value> <g_value> <b_value>]

      Set all read points to the same solid color.

      r_value, g_value, and b_value are the 0-255 color values for

      RED,     GREEN,   and BLUE, respectively. (Defaults is white).

 

   -int <value>, -intensity_index <value>

      Specify the column index for INTENSITY if input type is INTENSITY

      (default index value = 4).

 

   -intl <value>, -intensity_lower <value>

      Specify the lower limit for INTENSITY if input type is INTENSITY

     (default value = 0).

 

   -intu <value>, -intensity_upper <value>

      Specify the upper limit for INTENSITY if input type is INTENSITY

      (default value = 1).

 

   -to_meter <value>

     Convert coordinate unit of input file to METER in output file.

     value - is the rescaling parameter (eg. 0.3048 for feet to meter).

 

   -s, -space

     Change the delimiter type of the ASCII input file to space. The

     conversion assumes comma-seperated values by default.  This option

     directs it to expect space instead.

 

   -filters [<filter1>;<filter2>; ... <filtern>;],

     Specifies the filter names used for extracting classes of interest

     from LAS/LAZ files when classification exists.

     Valid filters:

     <Ground>;<Low Vegetation>;<Medium Vegetation>;<High Vegetation>;<Building>;<Water>

 

   -i-ascii, -o-ascii, -i-hpc, -o-hpc, -i-rxp, -i-rsp, -i-las, -i-laz

     Forces the input and output filetypes. Command can only include one

     input(i) and one output(o). By default, input is ASCII and output is HPC.

     If these options are not specified, the types will be detected from the

     file extensions.

 

     RIEGL NOTE: RXP are raw scan files and RSP is a RiSCAN PRO Project.

                 For RSP, provide either the full project.rsp path or else

                 simply the path to the project folder.