Difference between revisions of "Man DataExport"

From Open Tech Dental Wiki 4.0
Jump to: navigation, search
Line 23: Line 23:
 
* Meshes
 
* Meshes
 
** 'STL ASCII/Binary' : the STL file format is the most used. Most of the 3D software can read/save STL files. It does not save all the information of the 3D Objects. Colors and the connection between every single face are not saved so two different software can read the same STL file and show different results.
 
** 'STL ASCII/Binary' : the STL file format is the most used. Most of the 3D software can read/save STL files. It does not save all the information of the 3D Objects. Colors and the connection between every single face are not saved so two different software can read the same STL file and show different results.
−
** 'OFF ASCII/Binary' : the OFF format is a really simple file format as described here [[http://segeval.cs.princeton.edu/public/off_format.html OFF Format]]. It keeps more information than the STL format but the binary version may not be readable by all software.
+
** 'OFF ASCII' : the OFF format is a really simple file format as described here [[http://segeval.cs.princeton.edu/public/off_format.html OFF Format]]. It keeps more information than the STL format.
 
** 'PLY ASCII/Binary' : the PLY format, as the OFF format, can contain more information about the 3D data but is not so well supported by other software.
 
** 'PLY ASCII/Binary' : the PLY format, as the OFF format, can contain more information about the 3D data but is not so well supported by other software.
−
** 'OBJ' : The OBJ format is only ASCII, it can keep the most information about the 3D data, even the color, and is compatible with most software.
+
** 'OBJ' : The OBJ format is only ASCII, it can keep the most information about the 3D data, even the color, and is compatible with most softwares.
  
 
<!--T:2-->
 
<!--T:2-->
Line 58: Line 58:
  
 
<!--T:19-->
 
<!--T:19-->
−
To use the automatic export function, click on the ''Export To CAD'' button in the [[Main_Toolbar|Main Toolbar]]. The software will then export all the project data, according to the current project.
+
To use the automatic export function, click on the ''Export To CAD'' button in the [[Main_Toolbar|Main Toolbar]]. The software will then export all the project data, according to the selected "Exporter Profile".
  
−
== Prosthesis Project == <!--T:20-->
+
== Exporter Profile ==
  
−
<!--T:21-->
+
An exporter profile is a set of parameters that tells the software how to export the data for a specific Cad system.
−
When starting the ''Prosthesis Export'', the software will first check that all the meshes are ready to be exported and all the implants have been aligned to the implant library.
 
−
Then, it will look for an export folder and an export base name:
 
  
−
<!--T:22-->
+
You can modify, add or rename exporter profiles in the [[Dental_Options|Options]].
−
* If the project has been created by Exocad, the export folder will be the one created by the Exocad DentalDB and the name will be the Exocad project name
 
−
* If the project has been manually created by the user, the software will show a dialog to choose where to export and the export name will be the same as the folder name
 
  
−
<!--T:23-->
+
If you have only one profile called "default" it will be used automatically when you click the ''Export To CAD'' button.
−
Then, the system will export all the surfaces as meshes and, if working with Exocad, the implants position in the ''.implantPos'' format. </br>
 
−
To allow Exocad and other CAD systems to recognize the exported surfaces, all the files will follow the same name scheme:
 
  
−
<!--T:24-->
+
If you have more than one profile, a pop up will ask you to select what profile you want to use.
−
[Project Name]-[Object Name]-[Object Attribute].[File Format]
 
  
−
<!--T:25-->
+
If you keep pressed {{Inline button|Key shift.png}} the ''Export Dialog'' will open and let you change the export profile only for that specific export.
−
So for example:
 
  
−
<!--T:26-->
+
{{Screenshot|Exporter-dialog.JPG}}
−
Project: 3 Element bridge over 2 implants on the upper jaw with separated gingiva and antagonist
 
−
Project Name : 2099-13-32-0001-002
 
−
Files:
 
−
2099-13-32-0001-002-upperjaw.stl
 
−
2099-13-32-0001-002-15.implantPos
 
−
2099-13-32-0001-002-17.implantPos
 
−
2099-13-32-0001-002-upperjaw-gingiva.stl
 
−
2099-13-32-0001-002-lowerjaw.stl
 
  
−
== Orthodontic/Scheletric/Impression Projects == <!--T:27-->
+
=== Formats ===
  
−
<!--T:28-->
+
The software exports 3d shapes of the acquired data, 2d images to document the articulation and can export a thumbnail for every 3d object.
−
For other kinds of project, the export is easier because there are only 2 files to export, one for each jaw.
 
−
Choose in the [[Dental_Options|Options]] where and how to export the data for every project type. It is possible to choose:
 
  
−
<!--T:29-->
+
In this section you can select which format to use.
−
# An export folder: selecting an export folder, all the exported files will be automatically saved in the chosen folder; if not, the software will export the data in the Scan Project folder
 
−
# A file name format: chooses how the software will create the file names
 
  
−
== Final transformation == <!--T:30-->
+
Check with the cad system you use what format is better.
  
−
<!--T:31-->
+
=== Options ===
−
While working with 3D Objects, it's necessary to give some spacial references. The scanner system uses the following references:
 
  
−
<!--T:32-->
+
; Merge dies with healthy parts : If this option is enabled the software will merge all the dies and the healthy parts and export only one file for the entire jaw, if it's disabled the software will export one file for every die and one file for the healthy parts of the jaw
−
; Z Axis -> Occlusion Direction (Upwards)
+
; Export implantPosition files : If this option is enabled the software will export a special "implantPosition" file with the information about the alignment of an implant that can be imported by Exocad.
−
; X Axis -> Coronal Direction (From Left To Right)
 
−
; Y Axis -> Sagittal Direction (From Back To Front)
 
  
−
<!--T:33-->
+
=== Cad Integration ===
−
Other software may use different references. To better integrate data with other systems we provide, in the [[Dental_Options|Options]], a Final Transformation, a movement that will be applied to all the project data together, just before the export. Therefore, it is possible to adapt the spacial references to the chosen CAD system, without changing the way OpticalRevEng Dental works.
 
  
−
<!--T:5-->
+
; Executable Path : Here you can select the path to the Cad software to automatically start after the export of the data
−
For example, some orthodontic software need the occlusion axis to be the Y Axis. In this case, select ''Occlusion On Y'' in the Orthodontic Options page.  
+
; Cad project extension : Here you can put the extension of the Cad project so the software can invoke the cad with the right project file
 +
; Auto Start Cad : Check this box if you want to start the Cad automatically after the export of the data
 +
; Auto Close Software : Check this box if you want to automatically close the scan software after the export of the data
 +
 
 +
=== Export Path ===
 +
 
 +
This section let you choose where the exported files will be. There are 3 different path selections
 +
 
 +
; Automatic : The software will choose automatically the export folder. This can work in 2 ways. If you've selected a Cad project extension the file will be exported in the folder with the cad project if available. If no cad project extension is selected the file will be exported in the scan project folder
 +
; Ask : The software will ask you for the export folder every time
 +
; Fixed Folder : The software will export to the same folder every time.
 +
 
 +
If you check "Auto Open Export Folder" the software will automatically open the export folder after the export of the data
 +
 
 +
=== File Name Generator ===
 +
 
 +
This section let you choose how the software will name the exported files. There are 2 different generators
 +
 
 +
; Default : This generator will use the "Exocad" name format "projec name-reference jaw-item name-teeth.extension"
 +
; User Pattern : This generator will let you choose how the name will be created using some special tag that will be replaced for every item
 +
 
 +
An example of a user pattern is "%m/%p/%d/%j-%k-%t"
 +
 
 +
In a project with 2 stump on the lower jaw and an antagonist the exporter will:
 +
* Create a folder with the name of the doctor
 +
* Create a sub-folder with the name of the patient
 +
* Create a sub-folder with the actual date
 +
* Save the stumps as lowerjaw-stump-36.stl and lowerhaw-stump-35.stl
 +
* Save the healthy parts as lowerjaw-healthy.stl
 +
* Save the antagonist as upperjaw.stl
 +
 
 +
=== Export Final Translation ===
 +
 
 +
Every system need to choose a reference in the space for the position of the objects. Our system use this reference:
 +
* XY Plane as the Occlusion Plane.
 +
* YZ plane as the Symmetric Plane.
 +
 
 +
This is the same reference system used by Exocad.
 +
 
 +
Many orthodontic software use the following reference:
 +
* XZ Plane as the Occlusion Plane
 +
* XY Plane as the Symmetric Plane
 +
 
 +
Here you can select the reference system used by you scan system and the exported file will be in the selected reference position.
  
 
</translate>
 
</translate>
 
{{Navigation|Man_ImplantAlign|Man_ModelTrimming}}
 
{{Navigation|Man_ImplantAlign|Man_ModelTrimming}}

Revision as of 09:27, 27 November 2015


Export

It's useless to acquire, align and convert data if this information can not be sent to other software. The export functions can be used to create files that can then be imported in other software.

OpticalRevEng Dental offers 2 different export types: Manual and Automatic. Manual exports can be used anytime and in any kind of project; Automatic exports are specific to a project. The automatic export's functions can be configured in the Options dialog.

Formats

OpticalRevEng Dental supports the following formats:

  • Acquisitions
    • 'Scan' : this export function will create a file (.cri) for every 3D image taken by the scanner and an additional file (.scan) with a data description. It can be used only by OpticalRevEng Dental and all the files need to be kept together.
    • 'ZScan' : this export function saves the same information as the Scan export function, but compressing everything in one single file.
  • Meshes
    • 'STL ASCII/Binary' : the STL file format is the most used. Most of the 3D software can read/save STL files. It does not save all the information of the 3D Objects. Colors and the connection between every single face are not saved so two different software can read the same STL file and show different results.
    • 'OFF ASCII' : the OFF format is a really simple file format as described here [OFF Format]. It keeps more information than the STL format.
    • 'PLY ASCII/Binary' : the PLY format, as the OFF format, can contain more information about the 3D data but is not so well supported by other software.
    • 'OBJ' : The OBJ format is only ASCII, it can keep the most information about the 3D data, even the color, and is compatible with most softwares.

If maximum compatibility is needed, the best format to use is the STL. If the objective is to keep the most accurate 3D data, the OBJ format is better.

Manual Export

There are two ways to save the Acquisitions and the Meshes on disk.

Single Object Export

To export a single element from the project:

  1. Right click on the element in the Project Tree
  2. Select Export.. from the Context Menu
  3. From the dialog that will pop up, select where to save the file, its name and format for the data.

Multi Object Export

To export more than one element of the project in the same file:

  1. Select from the Project Tree all the data that have to be exported together
  2. From the File menu, select the Export Visible function
  3. From the dialog that will pop up, select where to save the file, its name and format for the data.

Automatic Export

To use the automatic export function, click on the Export To CAD button in the Main Toolbar. The software will then export all the project data, according to the selected "Exporter Profile".

Exporter Profile

An exporter profile is a set of parameters that tells the software how to export the data for a specific Cad system.

You can modify, add or rename exporter profiles in the Options.

If you have only one profile called "default" it will be used automatically when you click the Export To CAD button.

If you have more than one profile, a pop up will ask you to select what profile you want to use.

If you keep pressed Key shift.png the Export Dialog will open and let you change the export profile only for that specific export.

Exporter-dialog.JPG

Formats

The software exports 3d shapes of the acquired data, 2d images to document the articulation and can export a thumbnail for every 3d object.

In this section you can select which format to use.

Check with the cad system you use what format is better.

Options

Merge dies with healthy parts 
If this option is enabled the software will merge all the dies and the healthy parts and export only one file for the entire jaw, if it's disabled the software will export one file for every die and one file for the healthy parts of the jaw
Export implantPosition files 
If this option is enabled the software will export a special "implantPosition" file with the information about the alignment of an implant that can be imported by Exocad.

Cad Integration

Executable Path 
Here you can select the path to the Cad software to automatically start after the export of the data
Cad project extension 
Here you can put the extension of the Cad project so the software can invoke the cad with the right project file
Auto Start Cad 
Check this box if you want to start the Cad automatically after the export of the data
Auto Close Software 
Check this box if you want to automatically close the scan software after the export of the data

Export Path

This section let you choose where the exported files will be. There are 3 different path selections

Automatic 
The software will choose automatically the export folder. This can work in 2 ways. If you've selected a Cad project extension the file will be exported in the folder with the cad project if available. If no cad project extension is selected the file will be exported in the scan project folder
Ask 
The software will ask you for the export folder every time
Fixed Folder 
The software will export to the same folder every time.

If you check "Auto Open Export Folder" the software will automatically open the export folder after the export of the data

File Name Generator

This section let you choose how the software will name the exported files. There are 2 different generators

Default 
This generator will use the "Exocad" name format "projec name-reference jaw-item name-teeth.extension"
User Pattern 
This generator will let you choose how the name will be created using some special tag that will be replaced for every item

An example of a user pattern is "%m/%p/%d/%j-%k-%t"

In a project with 2 stump on the lower jaw and an antagonist the exporter will:

  • Create a folder with the name of the doctor
  • Create a sub-folder with the name of the patient
  • Create a sub-folder with the actual date
  • Save the stumps as lowerjaw-stump-36.stl and lowerhaw-stump-35.stl
  • Save the healthy parts as lowerjaw-healthy.stl
  • Save the antagonist as upperjaw.stl

Export Final Translation

Every system need to choose a reference in the space for the position of the objects. Our system use this reference:

  • XY Plane as the Occlusion Plane.
  • YZ plane as the Symmetric Plane.

This is the same reference system used by Exocad.

Many orthodontic software use the following reference:

  • XZ Plane as the Occlusion Plane
  • XY Plane as the Symmetric Plane

Here you can select the reference system used by you scan system and the exported file will be in the selected reference position.

Dental 2 5 wiz prev.png Homebutton.png Dental 2 5 wiz next.png
Retrieved from "https://wiki.opentechdental.com/w/index.php?title=Man_DataExport&oldid=8009"