Table of Content
1. Important – be sure to read this BEFORE you process your model
2. Export your TWINSPECT® model
3. Create your Twinsity Account and login
4. Upload your TWINSPECT® model
1. Important – be sure to read this BEFORE you process your model
Make sure that all the required files are included in the upload:
Files |
Format | Other specifications |
OBJ and MTL Files | Wavefront OBJ | Local coordinate system, maximum 400 million polygons |
Textures | *.jpg or *.png | Resolution not more than 8192 x 8192 pixel, not more than 100 pieces |
Camera parameter file | *.csv | Local coordinate system |
Original images | *.jpg or *.png |
- Make sure that the import and export of the model happens in a LOCAL COORDINATE SYSTEM. TWINSPECT can NOT handle georeferenced coordinate systems (e.g. WGS84) yet. The model must be exported in WAVEFRONT OBJ format and must not exceed a size of 400 million polygons.
- The camera file must also be exported in a LOCAL COORDINATE SYSTEM. It must also be exported in Block Exchange XML format.
- The textures must always have a power of two as the number of pixels. Here, the highest resolution of a texture may be 8192 x 8192 pixels. The textures must be in *.jpg or *.png format. The number of textures must not exceed 100.
- Check your camera file (CSV) again before uploading. Make sure that all images you want to see in TWINPSECT are in this camera file. During the upload your data will be validated again. Check the number of images in the validation overview.
- Please read the step-by-step instructions carefully. The red marked parts are very important and determine the success of your project upload.
2. Export your TWINSPECT® model
Build and export mesh
At first, the produced 3D model needs to be exported from RealityCapture. For this, please go to the Reconstruction tab in RC and click "Model" in the Export section (highlighted in green).
This will open the following dialog. Here you can specify the filename of the mesh model. Please make sure to choose the Wavefront obj (*.obj) option as the file type. To change the file type, please open the drop-down menu like shown below.
The following option dialog will show up. Use these options and parameters to export your 3D mesh model into the Wavefront obj format.
Click OK to export the 3D mesh model, along with the corresponding texture files. In the next step, the camera alignment file (i.e., the registration) needs to be exported.
Export Camera
In the next step, the camera alignment file (i.e., the registration of RC) needs to be exported. For this, please go to the Alignment tab in RC and click "Registration" in the Export section (highlighted in green).
This will open the following dialog for choosing the filename of the exported alignment file. Please make sure to select Internal/External camera parameters as the file type. To change the file type, open the drop-down menu like shown below.
The following export options dialog will show up. Use these options and parameters to export the registration into the CSV file.
Notes
You can add as many original images to your TWINSPECT project as you like. It is not necessary to import all the original images used to create the model. You can just skip the alignment images and import the inspection images only.
There are two ways to choose a subset of your original images:
- define an image selection in RC before exporting the camera alignment CSV file, or
- choose an image folder containing only a subset of your original images when specifying the root folder of the images to be imported into TWINSPECT.
3. Create your Twinsity Account and login
To create an account, please visit the TWINSPECT Dashboard:
Log in with an existing account on the start page or register a new one.
Tick the checkbox "Keep me signed in" to stay logged in after leaving the application. You will have to log in anew, if you actively log out in your previous session.
To register a new account, click "Sign In" to open the registration window. Click "Create an Account" and follow the instructions.
4. Upload your TWINSPECT® model
To upload the project to TWINSPECT®, press the "Create" button in our dashboard.
Now there are 5 steps to upload your project:
- Enter the name of your project, the asset type, and choose “Reality Capture” reconsturction software.
- Under "Select Source Folder", select the folder containing all project data files. Depending on the browser, select "View files" to display the images. Important: Our upload only works with Google Chrome or Microsoft Edge internet browsers.
- We validate your data before you can upload the data to avoid any problems. If there are errors in your data, they will be displayed here.
- Your project will be uploaded.
- Your project is uploaded.
When your project is uploaded, you will see it under the "Project Draft" item in our dashboard.
Once the project is processed, the model will be displayed under the "Projects" item.