HOW TO: Quick start on ConvertCMD

HOW TO: Quick start on ConvertCMD

Converting files with ConvertCMD

ConvertCMD Overview

udStreamConvertCMD should be part of the files you downloaded with udStream. Alternatively, you also convert using the udStream Desktop.

 
You can run this via command line or any terminal/shell program you are currently using with the following command:   

 

For multiple files, you can opt to add multiple -i <File URL> or create a txt file with the list of the URLs that you want converted. Then replace -i with - ilist :  
 


Option
Description
-i <inputFile>
Add an input to the convert job. More files can be specified immediately after, folders will be searched for supported files recursively 
-ilist <file> 
Add inputs from a text file that has 1 input file per line 
 -isrid <file>Override the input srid code for geolcation for any input files that come AFTER this setting is set
-resolution <res>  
Override the resolution (0.01 = 1cm, 0.001 = 1mm)
-srid <sridCode> 
Override the srid code for geolocation 
-globalOffset <x,y,z> 
Add an offset to all points, no spaces allowed in the x,y,z value
-pause
Require enter key to be pressed before exiting
-pauseOnError
 If any error occurs, require enter key to be pressed before exiting
-procyURL <url>
Set the proxy URL
-proxyUsername <username>
Set the username to use with the proxy
-proxyPassword <password>
Set the password to use with the proxy
-copyright <details>
Adds the copyright information to the "Copyright" metadata field
-quicktest
Does a small test to test if positioning/geolocation is correct
-region
Parameters to export the region. Example: -region 0.0 0.0 0.0 1.0 1.0 1.0
-retainprimitives
Include the primitives (triangles etc) from supported file formats
-ignore <attribute 1> <attribute 2>
Ignore the specified UDS Attribute when exporting, add one space between attributes
-accessToken
Token to access private cloud-based files
-o <outputfile.uds>
UDS output file path and file name

You need go to the Command Prompt to do the conversion. Type CMD in the search area, change directory to the folder of udStreamConvertCMD, eg:  

C:\Users\Username CD C:\Program Files\Euclideon\udStream1.4>udStreamConvertCMD.exe https://udstream.euclideon.com <username> <password> -i “E:\demo files\sample dataset.las” - resolution 0.001 -ignore udGPSTime  udReturnNumber -o “E:\demo data\sample dataset.uds”   

The output file location should be in your local computer/external HD. Additionally, it will need to create a temp folder (this defaults to the location where you run the command) to store temp files. This gets deleted after conversion is done. Make sure you have enough space for both the temporary files and output file, a rule of thumb is to have at least 10-50 times of the original data size.     

Using an ilist

As mentioned above, as an alternative to manually inputting files, you can create an ilist to load all input files. an ilist is a txt file that contain all of the input destination files. ConvertCMD allows input from either local storage as well as public files in cloud storage.


    • Related Articles

    • udStream Quick Start Guide

      Registering an account Before downloading and installing udStream you will need to go to  https://udstream.euclideon.com to register an account. When you navigate to the site, click  Register . Enter your name and email. You will be sent an email ...

    • HOW TO: Convert my models to UDS (Unlimited Detail Format)

      Converting my models to UDS For a list of supported file types, see the Knowledge Base article 'Supported File Types'. Introduction The real power of udStream lies in converting all Supported point cloud and 3D data types into our proprietary format ...

    • HOW TO: Supported Data Formats for Conversion

      SUPPORTED FORMATS FOR CONVERSION The Euclideon udStream enables users to import 3D models and convert them to Euclideon’s Unlimited Detail format (UDS). Euclideon’s UDS format enables you to stream and load massive point cloud data sets. Euclideon ...

    • How to Geolocate A 3D Model Using udStream

       OVERVIEW This guide provides the steps to geolocate a 3D polygon (OBJ or FBX) model so that is appears in the correct location within a larger point cloud model, eg. Placing an .obj building within a geolocated city model. udStream is a dynamic ...

    • udStream Browser: Guide to Getting Started

      Getting Started with udStream - Browser udStream can run in a Browser with the ability to view hosted Projects and already-converted .uds models anywhere in the world, on any machine. We currently support Google Chrome, Microsoft Edge and Mozilla ...