====== Optimize Data ======

This page describes the desktop tool “Optimize”. 

{{orbit_desktop:how_to_find.png?25&nolink  |}} Tools > Optimize \\ 
Drag & drop of a resource file that requires to be optimized for display will open this sidebar automatically.

===== Concepts =====

The Convert and Optimize Tools enable import, export, and data optimization of Reference Resources. 

"Optimize Data" optimizes one or more  [[251:technology:supported_formats:index|supported resource files]] into a single Orbit-optimized resource file. \\
"[[251:desktop:tools:convert_data|Convert Data]]" converts any supported resources file into another supported resource file, one on one. 

One sidebar to optimize supported Reference Resources of various types: Image, Vector, Point Cloud, and Mesh.

Optimizing original spherical images of mobile mapping resources to processed OMI images needs to be done using the "Optimize Imagery" procedure, see [[251:desktop_ext:mapping:manage:imagery|Optimize Imagery]] ((Spherical mapping images are optimized and normalized, and this tool cannot be used)). 

===== Source =====

Set the source file or the source directory. 

  * When activating the option source file, it is possible to drag and drop the resource file inside the entry field.
  * When using a source directory, all supported resource files of the specified data type inside the selected source directory and, optionally, its including subfolders will be optimized. 
  * For point cloud data, a source crs is required. If available, the CRS value is derived from the resource header or the accompanied [[251:technology:supported_formats:other:ord|Ord file]], else the [[251:technology:core:crs|Map CRS]] will set as default.

===== Source Options =====

Available when using a source directory:

  * Select the file format of the source files to be optimized. \\ E.g.Filter a main directory of mapping runs to trajectory_simplified.ovt and all corresponding trajectory_simplified.ovt files will be optimized into a single target file. 

For point cloud LAS source files:
  * Optionally ignore the LAS bounds from the LAS header to import points out of bounds. 

===== Target =====

Set the target file and directory. 

  * The source directory and filename are preset as the default target file and directory. 
  * For point cloud data, a target CRS is required. The source CRS is preset as default.
  * Optionally when processing is completed, add optimized resource automatically to the [[251:desktop:dataset:index|dataset list]]. 

===== Target Options =====

Available target options depend on the resource type 

==== Image data ====

Options for Image data, see [[251:technology:supported_formats:image:omi]].
  * Pixel size
  * Image compression 
  * Threshold

==== Point Cloud ====

For options for Point Cloud data, see [[251:technology:supported_formats:pointcloud:opc|]].
The point cloud export options can be very useful when consuming data online or in other Bentley applications. Based on downstream workflow(s), it may be necessary to Filter, Bake RBG Values, or inherit iModel CRS. All options can be one from the Optimize Sidebar.

  * Ascii source files
  * Inherit iModel CRS if available: Data will use the iModel CRS upon upload. 
  * Strip Attributes: Ignore attributes from the Source File when writing the Target file.
  * Filtering: Retain one point per voxel.
  * Classification: Ignore, import, or split the source point cloud by class.
  * RGB Color: Define the target output color with various options: Source color, Current (Active) Legend, By Classification (if available), and to Apply shading. 
  * Block Size: Customize Block size

==== Mesh ====

Download the [[external:ccgeneratelod|Plugin]] to optimize formats into Web-Ready 3D Scalable Mesh (.w3sm).

==== Convert ====

Start process. \\
Upon cancellation, the ongoing process will be interrupted, if possible the preliminary processed target files will be created.