Best Practices using the Connector for Capella and Simulink®
Best practices
Naming Recommendations for Capella elements
To avoid compilation errors and manual work in the MATLAB environment, here are the recommended naming rules to
apply:
-
Start with a letter, followed by letters, digits, or underscores.
-
Do not use spaces for any element related to interfaces: Functional Exchanges, Exchange Items, Classes,
Physical
Quantities, Enumerations.
-
Avoid two elements having the same name (especially if they are of the same type).
-
Limit the name length to 50 characters (not more than 55).
Rename the mlcore file
After generating the .mlcore file in Capella it is recommended to rename it to make the content more
explicit.
By default, the name is the Capella project name.
Initialize your project before the first import
Although you can use the
command line interface to perform the
first import and this will create a new project automatically for you, it is recommended to first
initialize your project using the project template released with the MATLAB toolbox and then make the first
import.
See
Project template for more details.
Put your project under Git version control
As a general good practice, as soon as the project is created put it under Git source control.
It is highly recommended when you want to work as a team on a single project.
It is highly recommended for iterative transformation.
Even you are working alone on the project, this is a good practice to apply. In this case, it is not required
to link the local repository to a remote repository.