Difference between revisions of "Man DataExport"

From Open Tech Dental Wiki 4.0
Jump to: navigation, search
Line 6: Line 6:
  
 
<!--T:7-->
 
<!--T:7-->
Acquiring, aligning and converting data have no use if this information can not be sent to other softwares. The export functions can be used to create files that can later on be imported in other softwares.  
+
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.  
  
 
<!--T:8-->
 
<!--T:8-->
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 project specific.
+
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 of a project.
 
The automatic export's functions can be configured in the [[Dental_Options|Options]] dialog.
 
The automatic export's functions can be configured in the [[Dental_Options|Options]] dialog.
  
Line 15: Line 15:
  
 
<!--T:10-->
 
<!--T:10-->
OpticalRevEng Dental supports the following formats
+
OpticalRevEng Dental supports the following formats:
  
 
<!--T:11-->
 
<!--T:11-->
 
* Acquisitions
 
* Acquisitions
** 'Scan' : This export function will create one 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 togheter
+
** '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 but compressing everything in only one file
+
** 'ZScan' : this export function saves the same information as the Scan export function, but compressing everything in one single file.
 
* Meshes
 
* Meshes
** 'STL ASCII/Binary' : The STL file format is the most used, quite every 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 work on every software
+
** '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 the 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 softwares
+
** '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, can keep the most informaton about the 3D data, even the color, and is quite compatible with most softwares
+
** 'OBJ' : The OBJ format is only ASCII, it can keep the mostn number of informaton about the 3D data, even the color, and is compatible with most of the software.
  
 
<!--T:2-->
 
<!--T:2-->
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.
+
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 = <!--T:3-->
 
= Manual Export = <!--T:3-->
  
 
<!--T:12-->
 
<!--T:12-->
There are two ways to save the Acquisitions and the Meshes on disk
+
There are two ways to save the Acquisitions and the Meshes on disk.
  
 
== Single Object Export == <!--T:13-->
 
== Single Object Export == <!--T:13-->
Line 43: Line 43:
 
# Right click on the element in the ''Project Tree''  
 
# Right click on the element in the ''Project Tree''  
 
# Select ''Export..'' from the [[Project_Tree#Context_Menu|Context Menu]]  
 
# Select ''Export..'' from the [[Project_Tree#Context_Menu|Context Menu]]  
# From the dialog that will pop up, select where to save the file, its name and format for the data.
+
# From the dialog that will pop up, select where to save the file, its name and format for the data.
  
 
== Multi Object Export == <!--T:16-->
 
== Multi Object Export == <!--T:16-->
Line 51: Line 51:
  
 
<!--T:18-->
 
<!--T:18-->
# Select from the project tree all the data to be export togheter
+
# Select from the Project Tree all the data that have to be exported together
# From the ''File menu'' select the [[Support_Toolbars_And_Menus#Project_Tools|Export Visible]] function
+
# From the ''File menu'', select the [[Support_Toolbars_And_Menus#Project_Tools|Export Visible]] function
# From the dialog that will pop up select where to save the file, its name and format for the data.
+
# From the dialog that will pop up, select where to save the file, its name and format for the data.
  
 
= Automatic Export = <!--T:4-->
 
= Automatic Export = <!--T:4-->
  
 
<!--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 current project.
  
== Protesis Project == <!--T:20-->
+
== Prosthesis Project == <!--T:20-->
  
 
<!--T:21-->
 
<!--T:21-->
When starting the ''Protesis 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.   
+
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 search for an export folder and an export base name:
+
Then, it will look for an export folder and an export base name:
  
 
<!--T:22-->
 
<!--T:22-->
* If the project was 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 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 was created manually 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
+
* 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-->
 
<!--T:23-->
The system will then export all the surfaces as meshes and, if working with exocad, the implants position in the ''.implantPos'' format. </br>
+
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:
+
To allow Exocad and other CAD systems to recognize the exported surfaces, all the files will follow the same name scheme:
  
 
  <!--T:24-->
 
  <!--T:24-->
Line 90: Line 90:
 
  2099-13-32-0001-002-lowerjaw.stl
 
  2099-13-32-0001-002-lowerjaw.stl
  
== Orthodontic/Scheletric/Impression Project == <!--T:27-->
+
== Orthodontic/Scheletric/Impression Projects == <!--T:27-->
  
 
<!--T:28-->
 
<!--T:28-->
For the other kinds of project the export is simplier because there are only at most 2 files to export, one for every jaw.
+
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:
+
Choose in the [[Dental_Options|Options]] where and how to export the data for every project type. It is possible to choose:
  
 
<!--T:29-->
 
<!--T:29-->
# An export folder: Selecting an export folder all the exported files will be automatically saved in the choosen folder, if not the software will export the data in the Scan Project folder
+
# An export folder: selecting an export folder, all the exported files will be automatically saved in the choosen folder; if not, the software will export the data in the Scan Project folder
# A file name format : Choose how the software will create the file name of the files using the data in the project.
+
# A file name format: chooses how the software will create the file name of the files using the data in the project.
  
 
== Final transformation == <!--T:30-->
 
== Final transformation == <!--T:30-->
  
 
<!--T:31-->
 
<!--T:31-->
Working with 3D Objects needs some spacial reference. The scanner system uses the following:
+
While working with 3D Objects, it's necessary to give some spacial references. The scanner system uses the following references:
  
 
<!--T:32-->
 
<!--T:32-->
Line 111: Line 111:
  
 
<!--T:33-->
 
<!--T:33-->
Other softwares may use different spacial reference. To better integrate with other systems we provide, in the [[Dental_Options|Options]], a Final Transormation, a movement that will be applied to all the project data togheter just before the export. Therefore it is possible to adapt the spacial reference to the CAD system to be used without changing how the OpticalRevEng Dental software works.
+
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 software works.
  
 
<!--T:5-->
 
<!--T:5-->
For example to work with orthodontic softwares that need the occlusion axis to be the Y Axis: in the Orthodontic Options page select ''Occlusion On Y''
+
For example, to work with orthodontic software that need the occlusion axis to be the Y Axis: in the Orthodontic Options page select ''Occlusion On Y''
  
 
=Next= <!--T:6-->
 
=Next= <!--T:6-->
  
 
<!--T:34-->
 
<!--T:34-->
Now that you know how to export files to be used in other software you can return to the [[Main_Page|Main Page]] or continue to read about [[Man_ModelTrimming|Model Base Trimming]]
+
It's possible to return to the [[Main_Page|Main Page]] or continue to read about [[Man_ModelTrimming|Model Base Trimming]]
 
</translate>
 
</translate>

Revision as of 10:03, 1 September 2015

Other languages:
العربية • ‎Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎日本語 • ‎português do Brasil • ‎română • ‎русский • ‎Türkçe • ‎中文(繁體)‎


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 of 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/Binary' : the OFF format is a really simple file format as described here [OFF Format]. It keeps more information than the STL format but the binary version may not be readable by all the 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 mostn number of informaton about the 3D data, even the color, and is compatible with most of the software.

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 current project.

Prosthesis Project

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:

  • 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

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:

[Project Name]-[Object Name]-[Object Attribute].[File Format]

So for example:

Project: 3 Element bridge over 2 implants on the upper jaw with separate gingiva and antagonist
Project Name : 2099-13-32-0001-002
Files:
2099-13-32-0001-002-uppwejaw.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

For other kinds of project, the export is easier because there are only 2 files to export, one for each jaw. Choose in the Options where and how to export the data for every project type. It is possible to choose:

  1. An export folder: selecting an export folder, all the exported files will be automatically saved in the choosen folder; if not, the software will export the data in the Scan Project folder
  2. A file name format: chooses how the software will create the file name of the files using the data in the project.

Final transformation

While working with 3D Objects, it's necessary to give some spacial references. The scanner system uses the following references:

Z Axis -> Occlusion Direction (From Lower To Upper)
X Axis -> Coronal Direction (From Left To Right)
Y Axis -> Sagittal Direction (From Back To Front)

Other software may use different references. To better integrate data with other systems we provide, in the 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 software works.

For example, to work with orthodontic software that need the occlusion axis to be the Y Axis: in the Orthodontic Options page select Occlusion On Y

Next

It's possible to return to the Main Page or continue to read about Model Base Trimming