Materialise Auto Label Eliminating Repetitive Tasks with Protolabs User Manual

June 15, 2024
Materialise

Materialise Auto Label Eliminating Repetitive Tasks with Protolabs User Manual
Materialise Auto Label Eliminating Repetitive Tasks with
Protolabs

Copyright Information

Materialise, the Materialise logo, Magics, Streamics and 3-matic are trademarks of Materialise NV in the EU, US and/or other countries.
Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
© 2023 Materialise NV. All rights reserved.

Installation

This chapter describes how to install the “Auto Label” function.

Minimum System Requirements

The Magics Automation Module must be installed to execute the “Auto Label” function. The Magics Automation Module is a Magics plug-in that is compatible with Magics RP version 25.03 or higher or Magics Print version 25.2 or higher.

Installing the “Auto Label” function

To install the “Auto Label” function, start the Magics RP or Magics Print software.

After starting Magics, switch to the “PLUG INS” menu tab”:
Installing the "Auto Label" function

To install the wf-package press the button “Manage Scripts”:
Installing the "Auto Label" function

Then press the “Import package…” button in the “Manage Scripts” dialog:
Installing the "Auto Label" function

Browse to the location of the wfpackage you want to install, select the package you want to install and press the “Open” button:
Installing the "Auto Label" function

The selected package is now installed and validated:
Installing the "Auto Label" function

After the installation is finished, an overview of the validation results is given. Close the dialog by pressing the “OK” button:
Installing the "Auto Label" function

The “Auto Label” function appears in the “Manage Scripts” window. Close the dialog by pressing the “CLOSE” button:
Installing the "Auto Label" function

The way “Auto Label” works

With “Auto Label”, you can apply label content to platforms with parts that have label planning.

A label plan consists of a placeholder at a specified area of a part surface where the label content is to be applied. The size of the area determines the size of the label content to be applied. The placeholder has a text template (e.g. {Label_A}), which is replaced by the label content to be applied by “Auto Label”. A label schedule can be created on a part by using the “Label” function. Please refer to the corresponding section in the Magics manual for more detailed information:
"Auto Label" works

The “Auto Label” requires the label content to be applied in the form of a list to be able to provide the label planning of the part on the platform with the corresponding label content. The first entry in the list must correspond to the text template (without curly brackets!) of the label planning:
"Auto Label" works

This is used to ensure that the correct label content is used for label planning. A list can be created in Excel and can be saved in one or multiple .xlsx. or .csv files.

In the labeling process, the list whose first line matches the text template of the label planning is first determined for each part. Starting with the second entry in this list, the label content is now successively taken from the list and applied to the surface of the part.

The function “Auto Label” therefore needs information about where these lists are to be found.

Execution of the “Auto Label”

This chapter describes how to use the “Auto label” function.

Selection of the function “Auto Label”

Start Magics and switch to the “PLUG INS” menu tab:Execution of the
"Auto Label"

Click on the icon “Auto Label”:
Execution of the "Auto Label"

A dialog appears in which a profile can be selected, and parameters can be adjusted. Select the profile to be used and press the “EXECUTE” button to start automatic labeling.
Execution of the "Auto Label"

Editing parameter profiles

To view or change the parameters of a profile, press the “Auto Label” button. In the Script Parameters dialog, you can set the following parameters:
Editing parameter profiles

Labels-Folder

  • Path to the folder where the (Excel) files with the label contents are located.

Labels files extension

  • Storage format in which the files with the label contents are stored. The file formats “.xlsx” or “.csv” are supported.

Results-Folder

  • Path to the result folder where the output file with the platform and labeled parts will be saved.

Output MatAMX file name

  • Name of the output file for the platform with the labeled parts

Close Magics when finishes

  • If this check box is selected, Magics will close after the script has been executed without error messages. The script checks whether the new output file exists.

Save individual STL files

  • If this check box is activated, individual STL files for each part are saved on the platform. For this purpose, a new STL subfolder is created inside the predefined result folder.

This functionality is intended to avoid having to open complete platforms when, for example, the position of a particular part is needed.

Rename parts

  • If this check box is activated, individual part names in Magics get the label content added as a prefix, which simplifies traceability.

Example

This chapter describes how to use the “Auto Label” function by means of an example.

Demo Platform

On a platform were placed 4 cuboids:

  • The three lower 3 cuboids each have three label plannings arranged one above the other on the top surface of the cuboids.
  • Each of the three label plannings on a top surface has its own text templates ({LabelA}, {LabelB}, {LabelC}).
  • The two lower cuboids also have a support structure.
    Demo Platform
csv files with label contents

For the three label plannings to be correctly supplied with content, three files must be prepared with corresponding content. In this example, three lists were generated with the Excel software and saved as .csv files.

This example also shows the “skip” feature, which prevents the creation of a label content to a part:
Files with label contents

xlsx files with label contents

The approach is the same as for the csv files. The first line must match the text of the text template without curly brackets.

Please note that the supported cell formats are “General”, “Text” and “Number”. Formulas are not supported:
Xlsx files with label contents

Parameter

The following settings were made in the “Script Parameters” dialog:

  • The label contents to be applied are stored in the folder “Documents”.
  • The label contents are saved as .csv files (ALL .csv files in the folder “Documents” are used!).
  • The result is to be stored in the folder “Documents”.
  • The labeled platform shall be named “labeled_platform”.
  • Magics should not be closed after the execution of “Auto Label”.
  • Each labeled part should also be saved into a separate STL file.
    Parameter
Results

In the folder “Documents” the output file “labeled_platform.matamx” is stored, which contains the platform with the labeled parts. Furthermore, the STL files for each part in the subfolder STLs:
Parameter Instruction

Note that the names of the saved STL files have been changed by adding the text from the applied labels to the part name as a prefix.

Labeled Platform (matamx output file)

The output file contains the platform with the labeled parts. According to the “Skip” command NO labeling has been applied to some parts.:
Labeled Platform

Please note that the supports are adopted when the label contents are applied! Make sure that the functionality of the supports is not impaired by the applied label content and the modified part surface.

Known Issues

This chapter describes known problems of the “Auto Label” function.
Currently there are no known issues.

Contact and Technical Support

We want you to have a smooth user experience when working with the Materialise Magics Automation Module. If you do encounter any error, please always try to save your work, and restart your system first.
In urgent cases you can contact our Technical Support for Maintenance Customers via e-mail.

Contact e-mails:
Worldwide: software.support@materialise.be
Korea: software.support@materialise.co.kr
USA: software.support@materialise.com
Germany: software.support@materialise.de
UK: software.support@materialise.co.uk
Japan: support@materialise.co.jp
Asia-Pacific: software.support@materialise.com.my
China: software.support@materialise.com.cn

Materialise nv I Technologielaan 15 I 3001 Leuven I Belgium I info@materialise.com I materialise.com

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals