840D SL ONE CMVM 3d Builder Config Man 0324 en-US

Download as pdf or txt
Download as pdf or txt
You are on page 1of 88

Introduction 1

Fundamental safety
instructions 2

Overview 3
SINUMERIK
System requirements and
installation 4
SINUMERIK ONE
Configuring Create MyVirtual Product description and
Machine /3D Builder features 5

Configuration Manual
Kinematic tree and nodes 6

Axis simulation 7

Collision groups 8

Layers 9
Export/import machine
models 10

Valid for
Create MyVirtual Machine /3D Builder V1.4

03/2024
A5E53138809B AC
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.

DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.

WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.

CAUTION
indicates that minor personal injury can result if proper precautions are not taken.

NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:

WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended or
approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance
are required to ensure that the products operate safely and without any problems. The permissible ambient
conditions must be complied with. The information in the relevant documentation must be observed.

Trademarks
All names identified by ® are registered trademarks of Siemens Aktiengesellschaft. The remaining trademarks in
this publication may be trademarks whose use by third parties for their own purposes could violate the rights of
the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.

Siemens Aktiengesellschaft A5E53138809B AC Copyright © Siemens 2023 - 2024.


Digital Industries Ⓟ 04/2024 Subject to change All rights reserved
Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents

1 Introduction ........................................................................................................................................... 5
1.1 About SINUMERIK ................................................................................................................ 5
1.2 About this documentation ................................................................................................... 5
1.2.1 Structure, content, target group, ... ...................................................................................... 5
1.3 Documentation on the internet ............................................................................................ 6
1.3.1 Documentation overview SINUMERIK ONE ........................................................................... 6
1.3.2 Documentation overview SINUMERIK operator components ................................................. 7
1.4 Feedback on the technical documentation ........................................................................... 7
1.5 mySupport documentation .................................................................................................. 7
1.6 Service and Support............................................................................................................. 8
1.7 OpenSSL ............................................................................................................................ 10
1.8 Compliance with the General Data Protection Regulation.................................................... 10
2 Fundamental safety instructions......................................................................................................... 11
2.1 General safety instructions................................................................................................. 11
2.2 Warranty and liability for application examples ................................................................... 11
2.3 Cybersecurity information .................................................................................................. 11
3 Overview.............................................................................................................................................. 13
3.1 Overview ........................................................................................................................... 13
4 System requirements and installation................................................................................................. 15
4.1 System requirements ......................................................................................................... 15
4.2 Prerequisite software ......................................................................................................... 16
4.3 Installing CMVM /3D Builder ............................................................................................... 16
4.4 Uninstalling CMVM /3D Builder........................................................................................... 17
4.5 Check file integrity ............................................................................................................. 18
4.6 Checking the signature of the installed files ........................................................................ 19
5 Product description and features ........................................................................................................ 21
5.1 Managing machine model projects..................................................................................... 21
5.1.1 Project overview ................................................................................................................ 21
5.1.2 Sample machine models .................................................................................................... 23
5.1.3 Create new machine model................................................................................................ 25
5.2 Features and functions....................................................................................................... 27
5.2.1 Layers on preview with toggle button................................................................................. 27
5.2.2 Setting camera angle ......................................................................................................... 30
5.2.3 Smart measure .................................................................................................................. 31

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 3
Table of contents

5.2.4 Undo/redo ......................................................................................................................... 34


6 Kinematic tree and nodes.................................................................................................................... 37
6.1 Kinematic tree overview..................................................................................................... 37
6.2 Working with the "Kinematic Tree"...................................................................................... 38
6.3 Nodes and properties......................................................................................................... 41
6.3.1 Machine definition node .................................................................................................... 41
6.3.2 Translational axis node....................................................................................................... 42
6.3.3 Rotational axis node........................................................................................................... 43
6.3.4 Turret/magazine node ........................................................................................................ 44
6.3.4.1 Turret/magazine node ........................................................................................................ 44
6.3.4.2 Active Tool Location on NC................................................................................................. 45
6.3.4.3 Driven Tool ........................................................................................................................ 46
6.3.4.4 Parametric tool generation................................................................................................. 48
6.3.5 Geometry node.................................................................................................................. 53
6.3.5.1 Geometry node.................................................................................................................. 53
6.3.5.2 Single geometry STEP support............................................................................................ 54
6.3.5.3 Multiple geometries STEP support ...................................................................................... 55
6.3.5.4 Creation of primitive shapes............................................................................................... 56
6.3.5.5 Future position visualization............................................................................................... 57
6.3.6 Tool slot node .................................................................................................................... 59
6.3.7 Mount station node ........................................................................................................... 64
6.3.8 Group node ....................................................................................................................... 65
6.3.9 Signal node ....................................................................................................................... 65
6.3.10 Switch node....................................................................................................................... 66
7 Axis simulation .................................................................................................................................... 69
7.1 Axis simulation .................................................................................................................. 69
8 Collision groups ................................................................................................................................... 71
8.1 Collision groups overview .................................................................................................. 71
8.2 Creating collision groups.................................................................................................... 73
8.3 Editing collision groups ...................................................................................................... 75
8.4 Bounding box and groups .................................................................................................. 76
9 Layers................................................................................................................................................... 77
9.1 Layers overview ................................................................................................................. 77
9.2 Creating layers ................................................................................................................... 79
9.3 Editing layers ..................................................................................................................... 81
10 Export/import machine models ........................................................................................................... 83
10.1 Export /3D File ................................................................................................................... 83
10.2 Import /3D File................................................................................................................... 83
10.3 Restrictions........................................................................................................................ 84
10.3.1 Naming restrictions for mount station ................................................................................ 84
10.3.2 Turret restrictions............................................................................................................... 84
Index .................................................................................................................................................... 87

Configuring Create MyVirtual Machine /3D Builder


4 Configuration Manual, 03/2024, A5E53138809B AC
Introduction 1
1.1 About SINUMERIK
From simple, standardized CNC machines to premium modular machine designs – the
SINUMERIK CNCs offer the right solution for all machine concepts. Whether for individual parts
or mass production, simple or complex workpieces – SINUMERIK is the highly dynamic
automation solution, integrated for all areas of production. From prototype construction and
tool design to mold making, all the way to large-scale series production.
Visit our website for more information SINUMERIK (https://www.siemens.com/sinumerik).

1.2 About this documentation

1.2.1 Structure, content, target group, ...

Target group
This document is intended for commissioning engineers and machine tool manufacturers. The
documentation provides a detailed description of of the Create MyVirtual Machine /3D Builder
software.

Benefits
The manual instructs the target group on how to install and uninstall the software correctly. It
helps users to familiarize themselves by creating and simulating a kinematic machine model.

Standard scope
This documentation only describes the functionality of the standard version. This may differ
from the scope of the functionality of the system that is actually supplied. Please refer to the
ordering documentation only for the functionality of the supplied drive system.
It may be possible to execute other functions in the system which are not described in this
documentation. This does not, however, represent an obligation to supply such functions
with a new control or when servicing.
For reasons of clarity, this documentation cannot include all of the detailed information
on all product types. Further, this documentation cannot take into consideration every
conceivable type of installation, operation and service/maintenance.
The machine manufacturer must document any additions or modifications they make to the
product themselves.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 5
Introduction
1.3 Documentation on the internet

Websites of third-party companies


This document may contain hyperlinks to third-party websites. Siemens is not responsible for
and shall not be liable for these websites and their content. Siemens has no control over the
information which appears on these websites and is not responsible for the content and
information provided there. The user bears the risk for their use.

1.3 Documentation on the internet

1.3.1 Documentation overview SINUMERIK ONE


Comprehensive documentation about the functions provided in SINUMERIK ONE Version 6.13
and higher is provided in the Documentation overview SINUMERIK ONE (https://
support.industry.siemens.com/cs/ww/en/view/109768483).

You can display documents or download them in PDF and HTML5 format.
The documentation is divided into the following categories:
• User: Operating
• User: Programming
• Manufacturer/Service: Functions
• Manufacturer/Service: Hardware
• Manufacturer/Service: Configuration/Setup
• Manufacturer/Service: Safety Integrated
• Information and training
• Manufacturer/Service: SINAMICS

Configuring Create MyVirtual Machine /3D Builder


6 Configuration Manual, 03/2024, A5E53138809B AC
Introduction
1.5 mySupport documentation

1.3.2 Documentation overview SINUMERIK operator components


Comprehensive documentation about the SINUMERIK operator components is provided in the
Documentation overview SINUMERIK operator components (https://
support.industry.siemens.com/cs/document/109783841/technische-dokumentation-zu-
sinumerik-bedienkomponenten?dti=0&lc=en-WW).
You can display documents or download them in PDF and HTML5 format.
The documentation is divided into the following categories:
• Operator Panels
• Machine control panels
• Machine Pushbutton Panel
• Handheld Unit / Mini handheld devices
• Further operator components
An overview of the most important documents, entries and
links to SINUMERIK is provided at SINUMERIK Overview - Topic
Page (https://support.industry.siemens.com/cs/document/109766201/sinumerik-an-overview-
of-the-most-important-documents-and-links?dti=0&lc=en-WW).

1.4 Feedback on the technical documentation


If you have any questions, suggestions or corrections regarding the technical documentation
which is published in the Siemens Industry Online Support, use the link "Provide feedback"
which appears at the end of the entry.

1.5 mySupport documentation


With the "mySupport documentation" web-based system you can compile your own individual
documentation based on Siemens content, and adapt it for your own machine documentation.
To start the application, click on the "My Documentation" tile on the mySupport homepage
(https://support.industry.siemens.com/cs/ww/en/my):

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 7
Introduction
1.6 Service and Support

The configured manual can be exported in RTF, PDF or XML format.

Note
Siemens content that supports the mySupport documentation application can be identified by
the presence of the "Configure" link.

1.6 Service and Support

Product support
You can find more information about products on the internet:
Product support (https://support.industry.siemens.com/cs/ww/en/)
The following is provided at this address:
• Up-to-date product information (product announcements)
• FAQs (frequently asked questions)
• Manuals
• Downloads
• Newsletters with the latest information about your products
• Global forum for information and best practice sharing between users and specialists
• Local contact persons via our Contacts at Siemens database (→ "Contact")
• Information about field services, repairs, spare parts, and much more (→ "Field Service")

Configuring Create MyVirtual Machine /3D Builder


8 Configuration Manual, 03/2024, A5E53138809B AC
Introduction
1.6 Service and Support

Technical support
Country-specific telephone numbers for technical support are provided on the internet at
address (https://support.industry.siemens.com/cs/ww/en/sc/4868) in the "Contact" area.
If you have any technical questions, please use the online form in the "Support Request" area.

Training
You can find information on SITRAIN at the following address (https://www.siemens.com/
sitrain).
SITRAIN offers training courses for automation and drives products, systems and solutions from
Siemens.

Siemens support on the go

With the award-winning "Industry Online Support" app, you can access more than 300,000
documents for Siemens Industry products – any time and from anywhere. The app can
support you in areas including:
• Resolving problems when implementing a project
• Troubleshooting when faults develop
• Expanding a system or planning a new system
Furthermore, you have access to the Technical Forum and other articles from our experts:
• FAQs
• Application examples
• Manuals
• Certificates
• Product announcements and much more
The "Industry Online Support" app is available for Apple iOS and Android.

Digital product information as QR code


The ID link according to IEC 61406 provides you with digital information about your product.
The ID link is a globally unique identifier and is located as a QR code on the product.
You can recognize the ID link by the frame with a black corner at the bottom right.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 9
Introduction
1.8 Compliance with the General Data Protection Regulation

*%-JOL

In addition to the digital nameplate you will find the following product information:
• Technical specifications
• FAQs
• Manuals
• Certificates
• Product announcements
• Application examples

1.7 OpenSSL

Using OpenSSL
This product can contain the following software:
• Software developed by the OpenSSL project for use in the OpenSSL toolkit
• Cryptographic software created by Eric Young.
• Software developed by Eric Young
You can find more information on the internet:
• OpenSSL (https://www.openssl.org)
• Cryptsoft (https://www.cryptsoft.com)

1.8 Compliance with the General Data Protection Regulation


Siemens observes standard data protection principles, in particular the data minimization rules
(privacy by design).
For this product, this means:
The product does not process or store any personal data, only technical function data (e.g.
time stamps). If the user links this data with other data (e.g. shift plans) or if he/she stores
person-related data on the same data medium (e.g. hard disk), thus personalizing this data,
he/she must ensure compliance with the applicable data protection stipulations.

Configuring Create MyVirtual Machine /3D Builder


10 Configuration Manual, 03/2024, A5E53138809B AC
Fundamental safety instructions 2
2.1 General safety instructions

WARNING
Danger to life if the safety instructions and residual risks are not observed
If the safety instructions and residual risks in the associated hardware documentation are not
observed, accidents involving severe injuries or death can occur.
• Observe the safety instructions given in the hardware documentation.
• Consider the residual risks for the risk evaluation.

WARNING
Malfunctions of the machine as a result of incorrect or changed parameter settings
As a result of incorrect or changed parameterization, machines can malfunction, which in turn
can lead to injuries or death.
• Protect the parameterization against unauthorized access.
• Handle possible malfunctions by taking suitable measures, e.g. emergency stop or
emergency off.

2.2 Warranty and liability for application examples


Application examples are not binding and do not claim to be complete regarding configuration,
equipment, or any eventuality which may arise. Application examples do not represent
customer-specific solutions, but merely serve to provide assistance with typical tasks.
As the user you yourself are responsible for ensuring that the products described are
operated correctly. Application examples do not relieve you of your responsibility for safe
handling when using, installing, operating and maintaining the equipment.

2.3 Cybersecurity information


Siemens provides products and solutions with industrial cybersecurity functions that support
the secure operation of plants, systems, machines and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is
necessary to implement – and continuously maintain – a holistic, state-of-the-art industrial
cybersecurity concept. Siemens’ products and solutions constitute one element of such a
concept.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 11
Fundamental safety instructions
2.3 Cybersecurity information

Customers are responsible for preventing unauthorized access to their plants, systems,
machines and networks. Such systems, machines and components should only be connected
to an enterprise network or the internet if and to the extent such a connection is necessary
and only when appropriate security measures (e.g. firewalls and/or network segmentation)
are in place.
For additional information on industrial cybersecurity measures that may be implemented,
please visit
https://www.siemens.com/cybersecurity-industry.
Siemens’ products and solutions undergo continuous development to make them more
secure. Siemens strongly recommends that product updates are applied as soon as they are
available and that the latest product versions are used. Use of product versions that are no
longer supported, and failure to apply the latest updates may increase customer’s exposure
to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Cybersecurity
RSS Feed under
https://new.siemens.com/cert.
Further information is provided on the Internet:
Industrial Security Configuration Manual (https://support.industry.siemens.com/cs/ww/en/
view/108862708)

WARNING
Unsafe operating states resulting from software manipulation
Software manipulations, e.g. viruses, Trojans, or worms, can cause unsafe operating states in
your system that may lead to death, serious injury, and property damage.
• Keep the software up to date.
• Incorporate the automation and drive components into a state-of-the-art, integrated
industrial cybersecurity concept for the installation or machine.
• Make sure that you include all installed products in the integrated industrial cybersecurity
concept.
• Protect files stored on exchangeable storage media from malicious software by with suitable
protection measures, e.g. virus scanners.
• Carefully check all cybersecurity-related settings once commissioning has been completed.

Configuring Create MyVirtual Machine /3D Builder


12 Configuration Manual, 03/2024, A5E53138809B AC
Overview 3
3.1 Overview

Introduction
Create MyVirtual Machine /3D Builder is a windows application to define, create and simulate a
kinematic machine model in an easy way. This document explains installation, usage and
features served by CMVM /3D Builder.

2
1

3 4 6

① Manage the machine model projects and settings.


② Save and close projects, export/import STEP files and machine models and display/hide the window areas.
③ The "Kinematic Tree" displays the nodes of the machine model in a hierarchical manner. You can manage nodes in the
tree view.
④ The "3D preview" shows the machine model and highlights the marked nodes of the kinematic tree.
⑤ Use the buttons to switch between the camera views.
⑥ The Simulation panel displays all the translation and rotation axes defined in the current machine model.
⑦ Displays the properties of the node marked in the "Kinematic Tree".
Figure 3-1 Create MyVirtual Machine /3D Builder with sample machine model at standard view

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 13
Overview
3.1 Overview

Note
In this documentation, "Create MyVirtual Machine /3D Builder" is abbreviated as "CMVM /3D
Builder".

Use of the machine model


You can use the created kinematic machine model as a 3D machine model in Create MyVirtual
Machine /3D or Protect MyMachine /3D Twin.

Configuring Create MyVirtual Machine /3D Builder


14 Configuration Manual, 03/2024, A5E53138809B AC
System requirements and installation 4
4.1 System requirements

Requirement
You require administrator rights to install Create MyVirtual Machine /3D Builder. Only one
version of Create MyVirtual Machine /3D Builder can be installed on a single computer.
After installation, use a user account without administrator rights when working with Create
MyVirtual Machine /3D Builder, in order to protect the system against security risks and
unauthorized manipulation.

Supported operating systems


• Microsoft Windows 10 Professional/Enterprise/IoT Enterprise/Home (64 Bit)
• Restricted compatibility for Microsoft Windows 11 Home/Pro/Pro Education/Pro for
Workstations/Enterprise/Education (64 Bit)

Hardware requirements
• Processor:
At least 4 processor cores
(Intel® Core i5 class or comparable)
• RAM:
4 GB memory (minimum)
• Hard disk (available memory):
6 GB (minimum)
• Graphic card:
Intel HD graphic 4000 (or comparable) with the current graphic driver
• Screen:
Resolution 1680x1050 or higher, 15.6"
• Input devices:
Mouse, keyboard

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 15
System requirements and installation
4.3 Installing CMVM /3D Builder

4.2 Prerequisite software

Preinstalled software
The following software is required to run Create MyVirtual Machine /3D Builder.
• Microsoft Windows Desktop Runtime
• Microsoft Visual C++

Note
Install necessary software
Running the Create MyVirtual Machine/3D Builder setup file will also install this required
software. If there is an older version of this software, it will be updated with Microsoft Windows
Desktop Runtime – 6.0.10 (x64) and Microsoft Visual C++ 2015-2022 Redistributable (x64 and
x86) 14.34.31938.

4.3 Installing CMVM /3D Builder

Description
The Create MyVirtual Machine /3D Builder installation package is located on the installation
medium supplied.

Note
The term "installation medium" is synonymous with DVD, download or other supplied media.

Requirement
The hardware and software of the PC meet the system requirements.
• The hardware and software of the PC meet the system requirements.
• You have administrator rights on your computer.
• All running programs are closed.
• Only one version of Create MyVirtual Machine /3D Builder can be installed on a single
computer.

Note
Uninstall older versions before installing
The installation program cannot update an installed version of CMVM /3D Builder to the new
version. Uninstall older versions of CMVM /3D Builder before installing a new version.

Configuring Create MyVirtual Machine /3D Builder


16 Configuration Manual, 03/2024, A5E53138809B AC
System requirements and installation
4.4 Uninstalling CMVM /3D Builder

How to install Create MyVirtual Machine /3D Builder


1. Navigate to the setup files on the installation medium of Create MyVirtual Machine /3D
Builder.
2. Double-click "Start.exe". The installation wizard opens.
3. Follow the wizard's instructions and confirm the prompts.
Note
Updating during the Setup
If existing installation requirements are updated during the Setup, an additional restart may
be necessary. In this case, the Setup prompts you to restart and then continues with the
installation process.

4. You must restart the computer once the installation has been completed.
Create MyVirtual Machine /3D Builder is now installed and ready to use.

4.4 Uninstalling CMVM /3D Builder

Introduction
Software packages are uninstalled automatically by the Setup program. Once started, the Setup
program guides you step-by-step through the entire uninstallation.

Uninstalling selected components using the Windows settings


To uninstall selected software packages, follow these steps:
1. Open "Windows settings" with "Start > Settings".
2. Double-click on the "Apps" entry in the settings.
The "Apps Select Features" window is opened.
3. Select the "Create MyVirtual Machine /3D Builder" software package to be uninstalled and
click on "Uninstall".
4. Confirm the displayed message with "Uninstall".
The dialog for selecting the setup language opens.
5. Select the language in which you want the dialogs of the Setup program to be displayed and
click the "Next" button.
The dialog for selecting the products you want to uninstall opens.
6. Activate the checkboxes for the products you want to uninstall and click the "Next" button.
The next dialog displays an overview of the installation settings.
7. Check the list with the products to be uninstalled. If you want to make any changes, click the
"Back" button.
8. Click the "Uninstall" button.
Uninstalling begins.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 17
System requirements and installation
4.5 Check file integrity

9. The computer may need to be restarted. Activate the "Yes, restart computer now" checkbox.
Then click the "Restart" button.
10.If the computer does not need to be restarted, click the "Exit" button.

Uninstalled components
• RegKey Path:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Siemens\Automation\_Inst
alledSW\CreateMyVirtualMachine3DBuilder
• 3D Builder Folder: C:\Users\Z004BPAC\AppData\Local\Siemens\Automation\Create
MyVirtual Machine 3D Builder
• 3D Builder Installer Folder: C:\Program Files (x86)\Common
Files\Siemens\Automation\Siemens Installer Assistant\406
• Installer Log Path: C:\ProgramData\Siemens\Automation\Logfiles\Setup

4.5 Check file integrity


File integrity is a crucial aspect of ensuring the trustworthiness and reliability of the software
being in use. In Protect MyMachine /3D Twin application all the executable files (*.swu & *.exe)
and Dynamic-link library files (*.dll) are signed with SIEMENS AG signature. This can be ensured
by checking each SWU, EXE and DLL files.

In order to check the signature (*.EXE & *.DLL)


1. Right-click on the DLL or EXE file.
2. Select "Properties" from the context menu.
3. In the "Properties" window, go to the "Digital Signatures" tab.
4. You will see signatures associated with the file. Select the SIEMENS AG signature and click the
"Details" button.
5. In the "Digital Signature Details" window, you can inspect the certificate information,
including the certificate issuer and validity. You can also click the "View Certificate" button to
get more details about the certificate.

In order to check the signature (*.SWU)


1. Right-click on the SWU file.
2. Select " 7zip" from the context menu and then “Open Archive”.
3. You will see the “sw-description.sig” file.
4. You can inspect the certificate information, including the certificate issuer and validity via this
file.

Configuring Create MyVirtual Machine /3D Builder


18 Configuration Manual, 03/2024, A5E53138809B AC
System requirements and installation
4.6 Checking the signature of the installed files

4.6 Checking the signature of the installed files


After installing the software, you can check whether the installed files ("*.dll", "*.exe") have a
signature of the publisher SIEMENS AG. By checking the signature you can identify if the files
have been manipulated. When signing software, executable files and scripts are digitally signed
to confirm and guarantee that since the signature, the code has neither been changed nor
corrupted. With this process, cryptographic hashes are employed to check authenticity and
integrity.
To check the authenticity and integrity of the installed Windows software, you can manually
check the corresponding files under Microsoft Windows or use suitable verification programs
for automated verification.

More information
In the SINUMERIK ONE Industrial Security Configuration Manual, you will find more information
on checking options in the section "Checking software signatures".

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 19
System requirements and installation
4.6 Checking the signature of the installed files

Configuring Create MyVirtual Machine /3D Builder


20 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features 5
5.1 Managing machine model projects

5.1.1 Project overview

Introduction
The machine model projects (*.kin) are managed in the Create MyVirtual Machine /3D Builder
project management. In this view, you create, open, duplicate and delete machine model
projects. The application starts with the project view.

Managing machine model projects


1. On the desktop, double-click the "Create MyVirtual Machine /3D Builder" icon, or select
"C:\Program Files (x86)\Siemens\Automation\Create MyVirtual Machine 3D Builder\3D
Builder.exe" . The Create MyVirtual Machine /3D Builder start page appears.

Note
Multiple instances and data loss
Multiple application instances can be used. Do not open same machine model project with
different applications at the same time, in this case a data loss might occur.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 21
Product description and features
5.1 Managing machine model projects

Functions of the start page

3 4 5 6

① Open machine model


In this view you manage your machine model projects.
② List
This list is for the created, edited and opened machine models in the computer. In this list user can see project and last
update date of the machine model with the name of the model.
③ Remove
This button removes the machine model from the list but not from the container.
④ Duplicate
User can create a copy from listed machine models in list.
⑤ Browse
When user wants to import a machine model which exists in the computer but not listed, user needs to click browse
button. This button will open a file dialog and user will select the ("*.kin") machine folder.
⑥ Open machine model
This will open the selected machine model from the list.
⑦ Create new machine model
This will change the page and user can create a new model from scratch.
Figure 5-1 Create MyVirtual Machine /3D Builder project management

See also
Create new machine model (Page 25)

Configuring Create MyVirtual Machine /3D Builder


22 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.1 Managing machine model projects

5.1.2 Sample machine models


CMVM /3D Builder comes with 2 sample machine model project files.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 23
Product description and features
5.1 Managing machine model projects

You can find them under: "C:\Program Files (x86)\Siemens\Automation\Create MyVirtual


Machine 3D Builder\Samples".
• Turning machine SinuTurn-DT (SinuTurn-DT.kin)

Figure 5-2 Turning machine SinuTurn DT

• Milling machine SinuMill5-AC (SinuMill5-AC.kin)

Figure 5-3 Milling machine SinuMill5 AC

Configuring Create MyVirtual Machine /3D Builder


24 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.1 Managing machine model projects

5.1.3 Create new machine model

Description
Create machine model projects in the project overview.

This is how you create a new machine model project


CMVM /3D Builder must be opened in the project overview before you can create a new project.
1. Click on the "Create new machine model" button.
2. Enter a "Project name"
3. Select the "Project path".

Figure 5-4 Create new machine model

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 25
Product description and features
5.1 Managing machine model projects

4. Confirm with "Create new machine model". The machine model opens.

Figure 5-5 Empty machine model project

5. Click on the button to display or hide the appropriate panes.

Figure 5-6 Display/hide the window areas

6. Create the nodes for the machine model in the "Kinematic Tree".

Configuring Create MyVirtual Machine /3D Builder


26 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.2 Features and functions

5.2 Features and functions

5.2.1 Layers on preview with toggle button


The user can turn the visibility of the layers previously created in the layer page on and off with
this feature.

Open layers
To see the layers, first click the button in the upper left corner of the "3D Preview". To close the
layer Panel, it is sufficient to press the button on the top left of the "3D Preview" again.

Figure 5-7 View the layers

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 27
Product description and features
5.2 Features and functions

Visibility of layers
User can turn the visibility of the layers in that panel (like picture below) on or off as desired.

Figure 5-8 Set layer visibility

Configuring Create MyVirtual Machine /3D Builder


28 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.2 Features and functions

Example layer
For example, in the picture below, the visibility of 2 layers has been turned off and only some
geometries remain in the simulation.

Figure 5-9 Example of a layer setting

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 29
Product description and features
5.2 Features and functions

5.2.2 Setting camera angle


With the buttons on the "3D Preview", the camera can be set to different viewing angles and also
the panel is movable.

Figure 5-10 Change the camera position

The user can drag the panel anywhere.

Figure 5-11 Move the panel

Configuring Create MyVirtual Machine /3D Builder


30 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.2 Features and functions

5.2.3 Smart measure


Smart Measure is a feature which helps to measure the distance between two points, depth of
geometry according to selected point or radius of selected circle, arc etc.

Activate/deactivate measuring
This feature can be activated with clicking on the ruler icon on the bottom right of the simulation
and then selecting point, arc or circle on geometries. To exit the measuring mode, you can press
the "Esc" button or click on the ruler again.

Figure 5-12 Activate/deactivate measure

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 31
Product description and features
5.2 Features and functions

Example measuring
• Measuring the depth of geometries

Figure 5-13 Depth of geometries

• Measuring the radius of circles

Configuring Create MyVirtual Machine /3D Builder


32 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.2 Features and functions

Figure 5-14 Radius of circles

• Measuring the distance between two points

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 33
Product description and features
5.2 Features and functions

Figure 5-15 Distance between two points

5.2.4 Undo/redo
Changes made can be undone with undo and redo buttons. The buttons look like (picture below)
this when they are active.

Figure 5-16 Button undo and redo

Configuring Create MyVirtual Machine /3D Builder


34 Configuration Manual, 03/2024, A5E53138809B AC
Product description and features
5.2 Features and functions

Example
For example, after the "Axis_A" node was moved under MC1, the "Undo" button was made
active. After pressing "Undo", the "Axis_A" node goes back under MA1 again.

8QGR

Figure 5-17 Example Undo

Undo and redo feature can be used for specified areas


• Kinematic Tree
• Layer Page
• Collision Page
• Property Panel
• Multiple Step Import

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 35
Product description and features
5.2 Features and functions

Configuring Create MyVirtual Machine /3D Builder


36 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes 6
6.1 Kinematic tree overview
This window displays the currently defined kinematic machine model as a graphical "tree"
consisting of "nodes" or objects having specific properties. The "Kinematic Tree" displays the
nodes in a hierarchical manner and the complete list of node types which may appear in the
"tree" is as follows.

Figure 6-1 Example machine model tree

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 37
Kinematic tree and nodes
6.2 Working with the "Kinematic Tree"

Types of nodes
There are 9 different types of nodes that have different features and attributes in the application
which will be explained in the next section (Page 41). When a node is selected in the tree view,
if it has visual items on the simulation (3D Preview) selected node and all of its children are
highlighted.

Note
General info
All names have to be unique, so when the name is changed, the user will not be allowed if the
same name already exists and the border of the textbox there will be red.

6.2 Working with the "Kinematic Tree"


In the "Kinematic Tree", you configure the machine model by inserting and parameterizing
relevant nodes (Page 41).

Node creation menu


When a node on the top side of the tree view window is dragged and dropped into the tree view,
new node is created under target node. If the new node is dropped to the space in tree view, new
node becomes child of the root node. Additionally, structure of the tree can also be changed by
simply dragging and dropping in the tree view.

1 2 3 4 5 6 7 8 9

① Translational Axis
② Rotational Axis
③ Turret/magazine
④ Geometry
⑤ Tool Slot
⑥ Mount Station
⑦ Group
⑧ Signal
⑨ Switch
Figure 6-2 Node creation menu

Configuring Create MyVirtual Machine /3D Builder


38 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.2 Working with the "Kinematic Tree"

Multi selection
The multi selectiom function can be used on the kinematic tree. Nodes can be deleted, copied,
cut and dragged collectively with multi selection.

Figure 6-3 Multi selection Kinematic Tree

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 39
Kinematic tree and nodes
6.2 Working with the "Kinematic Tree"

Pop-up menu
When clicking the right mouse button within the "Kinematic Tree View" window with one node
selected, a pop-up context-sensitive menu appears providing delete function on the kinematic
tree representing the machine model.

Figure 6-4 Pop-up menu

When clicking the right mouse button within the "Kinematic Tree View" window with one
node or multiple node selected, a pop-up context-sensitive menu appears providing cut,
copy, paste and delete functionality on the kinematic tree representing the machine model.
• Copy
Copy node feature can be used to copy only one node. The copy subtree can be used to copy
the selected node along with its children.
• Cut
Cut subtree works like copy subtree but it’s removing selected nodes from kinematics tree.
After cut operation Undo-Redo feature can be used for getting back removed nodes.
• Paste
Paste button will be active if the selected node is available to receive children and paste
functionality can be used between multiple 3D Builder so user can paste copied or cut nodes
to different 3D Builder.
• Delete
Delete subtree feature allows the selected node to be deleted and, if the selected node is a
parent, its children are also deleted.

Triangle count
There is a information bottom of the tree view about the total mesh triangle count. It shows the
number of triangles that all geometries in total have.

Figure 6-5 Triangle count

Configuring Create MyVirtual Machine /3D Builder


40 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Eye icons left of the tree items


Eye icons have been added to the left side of tree items and thanks to these, the visibility of the
node can be turned on or off. If the node whose visibility is changed is a parent node, the children
nodes' visibilities are also affected.

Figure 6-6 Eye icons left of the tree items

Properties panel
When a node is selected in the "Kinematic Tree" or in the 3D Preview, the "Properties" panel will
display the properties for that node.

6.3 Nodes and properties

6.3.1 Machine definition node


The "root" node in the kinematic tree representing a machine definition.

Figure 6-7 Root node - machine definition

Material removal simulation precision can be adjusted in the machine model by setting the
attribute "Number of Samples" to the needed sample count.
The default precision used in the simulation is depending on the workpiece dimensions. The
workpiece bounding box diagonal is divided by a sample count of 600 and the result defines
the nail distance of the simulation model.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 41
Kinematic tree and nodes
6.3 Nodes and properties

6.3.2 Translational axis node


A node in the kinematic tree that represents a translation axis with bounded axis values in a
machine. Once the node type has been defined as a translation axis type, it cannot be changed
to a rotation axis type. Changing the translation axis value results in the whole subtree moving
accordingly; this means shifting along the translation axis.
Its X, Y and Z values represents the vector direction which axis makes its children nodes
(subtree) move. It can also be selected easily with the combo box in the right side as +X, -X,
+Y, -Y, +Z and -Z directions.
Additionally, thanks to the smart measurement, axis direction can also be set easily by
clicking on "Select face normal" button and selecting a face in the simulation. The selected
face's normal will be set as axis direction vector. It works the same way with "Select two
points" option, if it is clicked on "Select two points" and afterwards two points are selected on
the simulation, the corresponding direction is set as axis vector direction.
Axis name, initial position, min and max value can also be changed. On /3D applications,
machine will be shown in initial axis values on "Setup Manager" view. Initial value of the axes
does not cause any movement to be observed on /3D Builder. Axis translation cannot exceed
the minimum or maximum value.

Figure 6-8 Translational axis

Coupled axis
It is possible to define a coupled axis in CMVM /3D Builder, where the axis is not defined in NC
but driven with an existing axis in NC.
When "Coupled Axis" checkbox is activated, driving axis and gear ratio parts show up. All axes
other than selected axis, can be selected as driving axis. In /3D application, a "Driving Axis"
will make coupled axis move in proportion to gear ratio.
As an example in the images, in /3D application 100 unit movement in MX1("Driving Axis")
will cause a movement in MY1 100 * gear ratio unit. If an axis is coupled axis, it will
not be shown in axis simulation list in 3D Builder.

Configuring Create MyVirtual Machine /3D Builder


42 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-9 Coupled axis

6.3.3 Rotational axis node


Rotational axis node is a node in the kinematic tree which represents a rotary axis. Rotation
occurs around a rotation point and a rotation direction. Rotational axis node creates a rotation
in the simulation for its subtree around a certain rotation point and a rotation direction. Right
hand rule is applied for rotation.
Its X, Y and Z values in the axis section represents the vector direction of the rotation. Its X, Y
and Z values in the rotation point section represents the center of the rotation.
Additionally, thanks to the smart measurement, Rotation point can also be set easily by
clicking on "Select arc center" button and selecting an arc in the simulation. The selected arc's
center will be set as rotation point. It works the same way with "Select point on edge" option,
if it is clicked on "Select point on edge" option and afterwards an edge is selected on the
simulation, the corresponding point is set as rotation point.
Axis name, initial position, min and max value can also be changed. On /3D applications,
machine will be shown in initial axis values on "Setup Manager" view. Initial value of the axes
does not cause any movement to be observed on /3D Builder. Axis translation cannot exceed
the minimum or maximum value.
Rollover enabled option provides a rotational axis to rotate many times and it is mainly used
for spindle axes.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 43
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-10 Rotational axis

Counter spindle
For Protect MyMachine /3D Twin, it is required to set the "Counter-Spindle" to see its spinning
simulation on 3D.
Select the "Main-Spindle" in the combobox, if your axis is a counter spindle axis.

Figure 6-11 Rotational axis is a "Counter-Spindle"

6.3.4 Turret/magazine node

6.3.4.1 Turret/magazine node


A node in the kinematic tree representing a turret/magazine. It has similar attributes to
geometry node, additionally it has parametric tool generation feature.

Configuring Create MyVirtual Machine /3D Builder


44 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Turret/magazine nodes can be used for CNC machines with turrets. A geometry (STEP, STL or
primitive shapes) can be set. A turret node can be created only under a rotational axis node.
Additionally, turret node only can have tool slots as children's nodes.
Combination of tool unit and magazine values should be valid because newly created tools
under a turret node gets its tool unit and magazine.

Figure 6-12 Turret turning machine example

6.3.4.2 Active Tool Location on NC


Of all the tools mounted on a turret, only the active one (in the NCK) should be enabled for
cutting operation. Interferences by other tools should be recognized as collisions. Therefore, It
is possible to limit the "active" tool to a tool location, for enabling the cutting operation. The tool
mount point values should be set for unit, magazine and slot values on part of active tool
location on NC on the turret node.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 45
Kinematic tree and nodes
6.3 Nodes and properties

Only the tool that resides in this place with its current location (non-home) will be able to cut
and will be rotated potentially by a turret spindle.

6.3.4.3 Driven Tool

Driven Tool
It is possible to have a driven tool (by NC Spindle axis) in the turret. The spindle axis name should
be set with the NC axis name of a spindle axis (e.g. MSC3) on the turret node.
Notes/Restrictions
• This spindle axis must not be present as a "RotationAxisNode".
• When using this attribute, "Active Tool Location" must be used.
• Only one tool (the active tool) can spin at a time.
• Configuring these attributes in a way that multiple tools are active when the linked spindle
spins, leads to undefined behavior.
• Turning tools will not be rotated in any case.
• If multiple ancestors of a tool mount station have this attribute configured, this is undefined
behavior.

Configuring Create MyVirtual Machine /3D Builder


46 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-13 Turret node example

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 47
Kinematic tree and nodes
6.3 Nodes and properties

6.3.4.4 Parametric tool generation

Parametric tool generation


Turret/Magazine node has a feature called parametric tool generation. With this feature user can
create multiple tool slots that fit to turret / magazine. If a turret node has a geometry, "parametric
tool generation" button in the turret node properties, is activated.

Figure 6-14 Turret node parametric tool generation

After clicking above button parametric tool generation popup is opened with the geometry
of turret node.

Configuring Create MyVirtual Machine /3D Builder


48 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-15 Parametric tool generation window

Firstly, user should define the orientation of the center point. Center point stands for the line
which will be used to rotate first tool around to create other tools. If it's not defined, default
is origin point and default direction is +Z axis. And user must specify the distance of first tool
location from the center point based on global coordinate system. Finally, user must enter
slot count which stands for number of tool slots that will be created.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 49
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-16 Tool slots

With A, B and C values of "First Tool Location" user can change the orientation of the tools in
any direction.

Configuring Create MyVirtual Machine /3D Builder


50 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-17 Orientation of the tools

By clicking on "Add Holder Transform", holder transform is added to all tools.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 51
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-18 Add holder transform

After clicking "Import" button all tool slots and holder transforms are created.

Figure 6-19 Example turret with transformed holders

Configuring Create MyVirtual Machine /3D Builder


52 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

6.3.5 Geometry node

6.3.5.1 Geometry node


A machine geometry node represents a physical machine part which belongs to the machine
composition. In contrast to the stock node, it is not possible to cut a machine geometry node in
3D application. Instead, a collision is reported if necessary, collision groups are defined.
In simulation coordinates of a geometry node can be changed with position and orientation.
Position values shifts the geometry node along X, Y and Z axes. Orientation values rotates
the geometry around +X, +Y and +Z directions respectively.
Geometry color in the simulation and reflection image can be set on the geometry node. For
actual visualizing, geometry attribute of the geometry node must be set.

Figure 6-20 Geometry node example

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 53
Kinematic tree and nodes
6.3 Nodes and properties

6.3.5.2 Single geometry STEP support


For geometry selection, user can import either STEP or STL file as a CAD file for geometries by
clicking file browsing or "Import STP/STL File" button.

Figure 6-21 Import STP/STL File

After clicking one of these buttons file browser popup is opened. If the selected file is STL
file, CAD file is directly imported. Otherwise, if the selected file is STEP file, a pop up is
shown. User can select any subcomponents of a STEP file and import it.

Figure 6-22 STEP file import example

Configuring Create MyVirtual Machine /3D Builder


54 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

6.3.5.3 Multiple geometries STEP support


Additionally, with multiple geometries STEP support it is possible to create more than one
geometry from a single STEP file.

Figure 6-23 Multiple geometry of one STEP file

If user clicks on "Import STEP File" button under Import menu, file browser window is
opened. User can only select a STEP file and when it is selected, a different pop up shows up.
User can create any number of geometries with different subcomponents of the STEP file and
edit the name of corresponding geometries or delete or highlight them.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 55
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-24 Multiple nodes from one STEP file

6.3.5.4 Creation of primitive shapes


There is also another way to create and import geometries. If user clicks on "Primitive Shapes"
button a different popup is opened.

Figure 6-25 Define parametric shape

After selecting the shape type corresponding shape creation windows are shown. User can
create 4 different types of shapes. Block, cylinder, pipe and N-corner shape.

Configuring Create MyVirtual Machine /3D Builder


56 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-26 Example block parametric shape

If user enters X, Y, Z value in the STL Origin, primitive shape is moved in the world coordinate
system. Moreover, if user enters A, B, C value in the STL Origin, shape is rotated around X, Y,
Z axes respectively.
User can import the primitive shape only if necessary, fields are filled validly. After clicking the
"Import as STL" button, basic shape and its corresponding stl file has been created.

6.3.5.5 Future position visualization


Following attributes are available to configure the look ahead visualization.
• Future Position (JOG) (will apply for JOG mode)
• Future Position (AUTO) (will apply for AUTO mode)
It is the feature used to indicate the node's look ahead state during simulation.
These attributes can be used for geometry, stock, and tools because only they can be
visualized in the simulation. The image below shows a property panel belonging to the
geometry that was clicked as an example.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 57
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-27 Future position visualization

Three different properties can be applied to these attributes. These are:


• "Visible"
• "Hidden"
• "Relative: {node name}"

Figure 6-28 Attribute future position visualization

Visible and hidden properties can be selected over the combo box and applied easily. In order
to use the relative property, press the icon on the right and enter the name of the node
according to which node is desired to be relative.

Configuring Create MyVirtual Machine /3D Builder


58 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-29 Attribute "Relative" future position visualization

NOTICE
In a machine model created in ModuleWorks MachineBuilder, when a transform node
containing 2 or more than 2 geometries is selected as relative and then imported to CMVM /3D
Builder, a random geometry will be selected as relative under the transform node.
If there is stock in the transform node, it will be selected relative to it directly.
⇒This is because only a geometry, stock or tool node can be selected as relative in CMVM /3D
Builder.

6.3.6 Tool slot node


"Tool Slot" represents a tool mounting point in the machine and is defined by way of a mesh color
definition. In /3D application, tools will be mounted to the tool slot node. There are some rules
to mount tools properly to tool slots.
Its insert, shaft and holder color can be assigned differently. In this property of tool slot, the
user can change the position, orientation, future position (the same logic with geometry
node), name, unit, magazine, slot and color data of the tool slot as desired.

Note

The transformation for tools under the rotational axis is not supported because it causes a
positioning problem for the tools. If necessary, the user should use the group node as the parent
of the rotational axis and transform the tool and axis together.

Unit, magazine and slot numbers are important for 3D applications as they will simulate the
tools based on the location information on NC.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 59
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-30 Tool slot node example

Holder transform
It is possible to define a separate mount coordinate system for a Tool Slot. This means the /3D
holder/adapter geometry with their mounting points will be placed based on this coordinate
system.
Holder transformation is a feature for machine which has a turret geometry. Under the tool
properties, there is a property for holder transformation and user can set a transform for
holders rotation.

Note
This feature cannot be used for any tool, there is a restriction that tool has to be under turret node
as a child.

Configuring Create MyVirtual Machine /3D Builder


60 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-31 Add tool holder transform

After clicking add holder transform button, UI will look like picture below. Additionally, an
info text is available when user hovers mouse on info icon.

Figure 6-32 Orientation of the toolholder

For example when the numbers entered like in below picture, small gnomon will be shown
at view and its rotation will be changed according the inputs of user.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 61
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-33 Example tool holder with transformation

Configuring Create MyVirtual Machine /3D Builder


62 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Tool slot and mount station orientation


The orientation of tool slot should match with the mount station orientation. They should be
same. This means that first tool's gnomon's X must point "away from center line" similar to the
X-axis ot the machine.

Parallel case Perpendicular case

Tool slot and mount station orientation - parallel case Tool slot and mount station orientation - perpendicular case

X is as always away from the center line in the examples. In the parallel case the turret is an
upper turret and X points away from the center line. In perpendicular case, the turret is lower
turret and X points away from the center line.

The following applies when creating the parametric tools for the turret:
• parameter values are expressed in the coordinate system known to the NCK ⇒ MCS
coordinate system
• STEP based elements shall be reusable on different turrets without the need to rotate them
additionally
• for parallel type turrets the mount coordinate system is identical to the slot coordinate system
• if the same adapter is to be used on a perpendicular turret, it is required to additionally set a
holder transform for each tool node

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 63
Kinematic tree and nodes
6.3 Nodes and properties

6.3.7 Mount station node


Mount station represents the node where the setups will be mounted. In this property of mount
station, the user can change the position, orientation, future position (the same logic with
geometry node), name and station data of the setup as desired. Station integer number is
important in import and export operations because it stands for which mount station setup will
be mounted. Finally, to use fast protection feature on /3D application, fast protection geometry
must be defined.

Figure 6-34 Mount station node

Configuring Create MyVirtual Machine /3D Builder


64 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

6.3.8 Group node


Group node is used for applying transformation (position and orientation) to all its children
nodes.

Figure 6-35 Group node

6.3.9 Signal node


Signal node provides an easy way to switch nodes to perform differently with different values of
NCK variables in SINUMERIK Operate. Signal node’s children can be only switch nodes.
Alias and Source corresponds to NCK variables in SINUMERIK Operate.
• Source value is used in Protect MyMachine /3D Twin application and should be the BTSS
address of the signal variable on NC. Ex: /Nck/ProtectedArea/kinSwitch[1]
• Alias value is used in Create MyVirtual Machine /3D application and should be the NCK
address of the Signal variable on NC. Ex: NCK.Variable.Channel[0].$NK_SWITCH[0]
Default value of signal node makes the switch node with the corresponding default value
work in default, on 3D application startup.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 65
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-36 Signal node

6.3.10 Switch node


Switch node makes its children nodes functional in 3D application when its parent signal node’s
source or alias value (in above example /Nck/ProtectedArea/kinSwitch[1] or $NK_SWITCH[0]) is
changed to switch node’s trigger value. A switch node can only be dropped to a signal node.
For example, in below image, when "Signal (1)" alias or source value is changed to 1 in
SINUMERIK Operate, all nodes under "Switch (1)" will be activated and the rest switches will
be deactivated in 3D application because "Switch (1)" has trigger value 1 and other switches
have different trigger values.

Configuring Create MyVirtual Machine /3D Builder


66 Configuration Manual, 03/2024, A5E53138809B AC
Kinematic tree and nodes
6.3 Nodes and properties

Figure 6-37 Switch node

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 67
Kinematic tree and nodes
6.3 Nodes and properties

Configuring Create MyVirtual Machine /3D Builder


68 Configuration Manual, 03/2024, A5E53138809B AC
Axis simulation 7
7.1 Axis simulation
The "Simulation" window displays all the translation and rotation axes defined in the current
machine model. The window shows the limit values for each axis and the current value within
the respective limits may be adjusted by means of the control slider and/or typing directly into
the value field.
On adjusting the axis value by way of the window control afforded, the machine model display
is automatically refreshed to reflect the updated value. This allows the kinematic machine model
to be checked ahead of simulations.
The example picture shows MX1, MZ1, MY1, MA1, MC1 and MSP1 axes in the machine model.
And also user can filter the all axes with writing text on the top of window.
With the button which stands near of the textbox, user can reset to initial value for all axes.
And also each axis has reset button, so one by one can be reset.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 69
Axis simulation
7.1 Axis simulation

Figure 7-1 Control panel for simulating the axes

Configuring Create MyVirtual Machine /3D Builder


70 Configuration Manual, 03/2024, A5E53138809B AC
Collision groups 8
8.1 Collision groups overview
The "Collision Checking Window" allows components of the machine model requiring to be
checked for collisions to be defined for simulation purposes.
The nodes to be checked are selected within a "Collision Group" and, any number of such
groups can be created containing the nodes to be collision checked.
The following example shows existing collision groups.

Figure 8-1 Collision group example

Collision groups in the 3D Preview


If user clicks any item on list view, that collision group (nodes in that collision group) will be
colored with different color according to collision group number on "3D Preview".

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 71
Collision groups
8.1 Collision groups overview

Figure 8-2 Collision groups in the 3D Preview

NOTICE
Identical nodes
A collision group cannot be created between 2 identical nodes.

Configuring Create MyVirtual Machine /3D Builder


72 Configuration Manual, 03/2024, A5E53138809B AC
Collision groups
8.2 Creating collision groups

8.2 Creating collision groups

Creating new group


After clicking plus button on right top of window, new add collision group window opens. If
there is no nodes in right box, then "Done" button will be disabled. Also safety distance should
be entered for each collision pair to visualize on the 3D Preview. When playing axis values if there
is lower distance than safety distance between two collision pair, then will be colored with
orange. Default value is 3 for safety distance.

Figure 8-3 Creating new collision group

After dragging nodes to right box, button will be enabled. User can change the new collision
group name and drag nodes from left to right to create new collision group with nodes which
belong to right box. If user thinks, s/he made a mistake about dragging one node to right
box, user can removed from right box with button which stand right of the node name. If
everything is okay, then user should click the "Done" button to save collision group.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 73
Collision groups
8.2 Creating collision groups

Figure 8-4 Add nodes to collision group

Now collision group window with new collision group looks like image below.

Figure 8-5 Collision group example

Configuring Create MyVirtual Machine /3D Builder


74 Configuration Manual, 03/2024, A5E53138809B AC
Collision groups
8.3 Editing collision groups

8.3 Editing collision groups

Editing a group
User can also edit collision groups by clicking two times on list item. User can give a new name
and drag new nodes or remove nodes that already in right box.

Figure 8-6 Collision group changed

After saving the changes, edited collision group is added to list on collision groups window.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 75
Collision groups
8.4 Bounding box and groups

Figure 8-7 Collision group saved

8.4 Bounding box and groups


A bounding box is the smallest box that contains the given geometry in a collision group. An axis
aligned bounding box is a special subtype type that has its surfaces parallel to the XYZ coordinate
planes. Collision detection and avoidance algorithms run when the bounding boxes of 2 groups
intersect, so it is very important to create a minimum bounding box for a collision group to have
a better performance.

Figure 8-8 Bounding box example

Configuring Create MyVirtual Machine /3D Builder


76 Configuration Manual, 03/2024, A5E53138809B AC
Layers 9
9.1 Layers overview
Layers Window enables user some nodes to group by as layers as well as add, remove and edit
function for a particular machine. The defined layers can be shown/hidden in the /3D
application. The following example shows layers user interface.

NOTICE
A node cannot exist in more than one layer.

Figure 9-1 Layers example

If user clicks any item on list view, that layer (nodes in that layer) will be colored on "3D
Preview".

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 77
Layers
9.1 Layers overview

Figure 9-2 Layers in the 3D Preview

Configuring Create MyVirtual Machine /3D Builder


78 Configuration Manual, 03/2024, A5E53138809B AC
Layers
9.2 Creating layers

9.2 Creating layers


After clicking plus button on top right of the window, new add layer window opens. If there is
no nodes in right box, then "Done" button will be disabled. The user must drag and drop the
nodes they want to select.

Figure 9-3 Creating new layers

After dragging nodes to right box, button will be enabled. User can change the new layer
name and drag nodes from left to right to create new layer with nodes which belong to right
box. If user thinks, s/he made a mistake about dragging one node to right box, a node can
be removed from right box with button which stand right of the node name. If everything is
okay, then user should click the "Done" button to save layer.

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 79
Layers
9.2 Creating layers

Figure 9-4 Add nodes to layer

Now layer window looks like added new layer image below.

Figure 9-5 Layers example

Configuring Create MyVirtual Machine /3D Builder


80 Configuration Manual, 03/2024, A5E53138809B AC
Layers
9.3 Editing layers

9.3 Editing layers


User can also edit layer with clicking two times on list item. User can give a new name and drag
new nodes or remove nodes that already in right box.

Figure 9-6 Layers changed

After saving the changes, new edited layer is added to list on layer window.

Figure 9-7 Layers saved

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 81
Layers
9.3 Editing layers

Configuring Create MyVirtual Machine /3D Builder


82 Configuration Manual, 03/2024, A5E53138809B AC
Export/import machine models 10
10.1 Export /3D File
A machine model in CMVM /3D Builder can be exported in /3D format "*.mkc" or "*.zip" file with
the buttons "Export > /3D Export /3D File".

Figure 10-1 Export /3D File

How to export 3D data


1. Click the buttons "Export" and then "/3D Export /3D File".
2. You can choose between the following export variants:
– "*.mkc"
– "*.zip"
The "*.zip" contains the "*.xml" and the "*.stl" files.
3. Select the storage path and confirm with "Save".

Further information
For more information about naming of tool and mount stations and turret structures, see the
"Restrictions (Page 84)" chapter.

10.2 Import /3D File


An existing machine model of /3D application can be imported into CMVM /3D Builder as "*.mkc"
or "*.zip" file with the buttons "Import > /3D Import /3D File".

Figure 10-2 Import /3D File

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 83
Export/import machine models
10.3 Restrictions

How to import 3D data


1. Click the buttons "Import" and then "/3D Import /3D File".
2. Select the import path.
3. You can choose between the following import variants:
– "*.mkc"
– "*.zip"
The "*.zip" contains the "*.xml" and the "*.stl" files. To import, the files “*.stl” and “*.xml”
must first be converted into a zip file.
4. Select the import data and confirm with "Open".

Further information
For more information about naming of tool and mount stations and turret structures, see the
"Restrictions (Page 84)" chapter.

10.3 Restrictions

10.3.1 Naming restrictions for mount station


There are some restrictions on tool and mount station names.

Note
The user does not need to change the tool or stock name in the CMVM /3D Builder user interface
(ex-/import machine model).

Mount station
Each stock has its own unique station integer numbers. This is controlled in the application and
the user is not allowed to create another stock with the same station values.

Figure 10-3 Example node

10.3.2 Turret restrictions


There are some restrictions while importing /3D machine model.

Configuring Create MyVirtual Machine /3D Builder


84 Configuration Manual, 03/2024, A5E53138809B AC
Export/import machine models
10.3 Restrictions

Automatic creation of nodes in /3D Builder


Cases for creation of turret node on CMVM /3D Builder:
1. Tool count must be more than 1 (>1).
2. Tools must be under a rotary axis.
3. If first and second case are valid, and also if there is a geometry under rotary axis, then this
geometry will be assumed turrets geometry.
4. But if there are geometries more than 1, then first geometry will be taken for turrets
geometry.

Figure 10-4 Turret in CMVM /3D Builder

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 85
Export/import machine models
10.3 Restrictions

Configuring Create MyVirtual Machine /3D Builder


86 Configuration Manual, 03/2024, A5E53138809B AC
Index

B P
bounding box, 76 Preinstalled software, 16

C R
Checking the signature, 19 RAM, 15
Collision Group, 71 restrictions, 84
Create MyVirtual Machine /3D Builder, 13 mount station, 84
Creating new collision group, 73 turret, 85
Rotational axis node, 43

E
Editing collision group, 75
S
Export /3D File, 83 Sample machine models, 23
Supported operating systems, 15
System equirement, 15
G
geometry node, 53
future position visualization, 57
T
multiple geometries STEP, 55 Tool slot node, 59
primitive shapes, 56 Translation axis node, 42
single geometriy STEP, 54 Turret/magazine node
Graphic, 15 Active Tool Location on NC, 46
group node, 65 Driven Tool, 46
Parametric tool generation, 48
Turret/magazine nodes, 45
H
Hardware requirements, 15
U
Uninstalling, 17
I
Import /3D File, 83
Installing, 16

K
Kinematic Tree, 38

M
machine definition, 41
machine model projects, 21
mount station node, 64

Configuring Create MyVirtual Machine /3D Builder


Configuration Manual, 03/2024, A5E53138809B AC 87
Index

Configuring Create MyVirtual Machine /3D Builder


88 Configuration Manual, 03/2024, A5E53138809B AC

You might also like