====== Manage Mapping Resources ======

This page describes the desktop administration procedures to manage your mapping resources. \\ 
It is strongly recommended to read first [[201:technology:3d_mapping:about_resources|]]. 

{{orbitgis:how_to_find.png?25&nolink |}} Procedures > Administration > Aerial, Mobile or Oblique Mapping > XXX

===== Open Run =====

==== Open an available Orbit Mapping Resource ====

  * A previously opened Mapping Resource will be closed and the selected Mapping Resource is opened.
  * Search and filter the list of available Mapping Resources.
  * Open the selected Mapping Resource via the according button or just double click the name in the list.

===== Add Mapping Resource ====

==== Add a ready to use Orbit Mapping Resource as available Mapping Resource ====

  * Add one or folder containing multiple ready to use Orbit Mapping Resources to the application's list of available Mapping Resources.
  * The original data doesn't need to be re-processed.
  * The Add Mapping Resource procedure is the only way to get mobile mapping data into an Orbit MM Explorer.

==== Add Mapping Resource Procedure ====

  * **Mapping Resource** \\ Browse and select the orbit_mm_run.omr file in the root directory of the Orbit Mapping Resource folder. \\ For Mapping Resources of version 1, select the select the panorama_positions.ovf
  * **Name** \\ The name of the Mapping Resource as on disk is used automatically after selecting the omr file. This name can no longer be changed to avoid any confusion or mistakes due to a different names on disk and in Orbit.

===== Import Mapping Resource  =====

==== Import a raw set of data into an Orbit Mapping Resource ====

  * The import procedure differs depending the selected import template representing the Mapping resources to import. \\ All import configurations like available resources, sensors, sensor specifications and coordinate system are configured and defined by this import template.
  * It is required to prepare the data properly according the template specifications, see [[201:desktop_ext:mapping:manage_import:templates|]]. 

==== Import Mapping Resource Procedure ====

Complete documentation on the Import Mapping Resource procedure, see [[201:desktop_ext:mapping:manage_import:index|]].

===== Import & Process Mapping Resource  =====

==== Import available original data ====
  * Import & Process Mapping Resource is activated when original data is available in the mapping run and the corresponding mapping resource hasn't been imported yet. 
  * Every mapping resource has specific conditions to import & process: 
=== Point Cloud ===

(1) No point_cloud.opc file in the pointcloud directory\\
(2) One or more original files in the pointcloud\original directory. A priority list defines in which order formats are checked: las, pod, laszip, e57, txt. The link.ini file can be used to direct to another directory including the original pointcloud files. 

=== Camera Photo Positions ===

(1) No locations.ovt file in the camera directory\\
(2) import_locations.csv in the <camera>\import directory

=== Trajectory ===

(1) No trajectory.ovf file in the trajectory directory\\
(2) A csv or xml in the trajectory\original directory

=== DTM ===

(1) No dtm.omi file in the dtm directory \\
(2) One or more image files in the dtm/original directory

=== Ortho ===

(1) No ortho.omi file in the ortho directory \\
(2) One or more image files in the ortho/original directory 

=== Textured Mesh ===

(1) A mesh.json file in the mesh directory\\
(2) Missing ord, ini or 3dtiles files in the mesh directory


=== Trajectory Simplified === 

(1) No trajectory_simplified.ovt file in the simplified_trajectory directory

=== Envelope ===

(1) No envelope.ovf file in the envelope directory

=== Metadata ===

(1) No metadata.xml file in the metadata directory

===== Edit Mapping Resource =====

=== Re-import data into the opened Run ===

  * Update mapping resources of the opened Mapping Resource by re-importing original data files.
  * The initially imported mapping resources are replaced upon importing the new files. If only the photo positions file is re-imported, then the initial point cloud resources aren't replaced and visa versa. 
  * This procedure is inactive if no Mapping Resource is opened. 

=== Edit Mapping Resource Procedure ===

For more information, review the documentation on Import Mapping Resource above. 

=== Note for version 17.x ===

A bug prevents update of a point cloud via this procedure. \\
To do so apply following workaround. \\
Delete the existing ''<Orbit Run>/pointcloud/point_cloud.opc'' manually prior to Open and Edit Run. \\
This issue is fixed by version 18.0.

===== Close Mapping Resource  =====

=== Close an opened Mapping Resource ===
  * Close the Mapping Resource and remove the corresponding mapping resources from the datasetlist. 
  * This procedure is inactive if no run is opened.

===== Remove Mapping Resource =====

=== Remove an available Mapping Resource from list of available Mapping Resources ===

  * The selected Mapping Resource is removed from the application's list of available Mapping Resources.
  * The removed Mapping Resource is deleted from all Projects it belongs.
  * The data files as stored on disk is not deleted, no data is removed from disk.