Customizing supercomponents > Example 2: 2-level customized supercomponent with global parameters
Constructing the customized supercomponent
Step 1: Load the generic supercomponent in Component Customization
Hide all variables and parameters.
Step 2: The original external variable names have very inappropriate names
Change them to those indicated.
Figure 49: Alter the external variable names
For the time being, only external variables of the supercomponent are visible. We must decide on what else is to be visible. There are many pairs of submodels in this supercomponent. In order to demonstrate the use of global parameters, we will assign the same values to many parameters from the intake side and from the exhaust side. This symmetry is of course not necessary and may not be desirable from a design point of view, but this is not the point of the exercise.
It would be convenient to have the following parameters to set in Simcenter Amesim:
valve spring preload
valve spring stiffness
valve clearance
valve mass
maximum possible valve lift
Results
We set these parameters once and they are applied to both the intake and the exhaust side. To do this we introduce customized supercomponent global parameters in Component Customization. These are like global parameters in Simcenter Amesim but their scope is solely the customized supercomponent.
The table below shows the global parameters we will use and an indication of where they will be used. They are all Real parameters but we could also use Integer and Text parameters.
| Global type and name | Title [units] | Min./Default/Max. | Submodel, parameter/variable and title |
|---|---|---|---|
| Real VPRELOAD | valve spring preload [N] | 200/300/800 | SPR000A, real parameter, free length of spring |
| Real VSTIFF | valve spring stiffness [N/m] | 1.0e4/1.0e6/1.0e6 | SPR000A, variable, spring rate |
| Real VCLEAR | valve clearance [mm] | 0.05/0.1/0.2 | LSTP00A, variable, gap or clearance with both displacements zero |
| Real VMASS | valve mass [kg] | 0.005/0.01/0.05 | MAS005, real parameter, mass |
| Real VMAXLIFT | maximum possible valve lift [m] | 0.02/0.03/0.085 | MAS005, real parameter, higher displacement limit |
Step 3: Introduce the supercomponent real global parameters shown below
Make sure that none of them is hidden.
Figure 50: Alter the external variable names
Note that you click on the Add new button to introduce each new real parameter.
Step 4: Use the VPRELOAD and VSTIFF global variables in both SPR000A spring submodels Real parameters as shown below
Figure 51: Global variables
Note that you can copy/paste from one spring to the other using the tree structure.
Figure 52: Copy/paste using the tree structure
You can do the same thing in the Explore Supercomponent window.
Figure 53: Copy/paste using the Explore Supercomponent window
A third technique is to select both springs in the tree structure or both springs in the Explore supercomponent window. This works like Common Parameters in Simcenter Amesim and you can set the values for both springs simultaneously.
Figure 54: spring values can be set simultaneously
Step 5: Using the same techniques set the VCLEAR global parameter in both LSTP00A submodels as indicated
Figure 55: VCLEAR global parameter
Step 6: For both MAS005 submodels make the modifications shown below
Figure 56: Modifications for both MAS005
Step 7: In the inlet MAS005 submodel alter the Internal variables as shown
Make the corresponding changes in the exhaust side.
Figure 57: Alter the Internal variables of MAS005
Note
3 (x2) Internal variables have had their titles altered and are not hidden anymore.
Step 8: In the inlet cam INCAM50 submodel alter the second Internal variable as shown
Do not change the exhaust side.
Figure 58: Uncheck the Hidden box for the second variable
We have forced both cams to have a starting angle of 0. We will not be able to change this.
We have forced the starting value of the gap or clearance in both LSTP00A submodels to be VCLEAR.
With both cam profiles starting on a flat part, the starting values of various state variables are consistent.
Step 9: Do a Parameter mode preview and a Simulation mode preview
Figure 59: Parameter mode preview
Figure 60: Simulation mode preview
Step 10: Save the customized supercomponent as CUSVALVES50
This time specify a password, but do not forget it!
Step 11: Add the customized supercomponent to your Simcenter Amesim sketch and check that it produces the same results
Figure 61: Add the customized supercomponent to the sketch
We hope that you find using CUSVALVES50 within Simcenter Amesim more practical than the generic equivalent.
Step 12: Use the state contributions facility and also examine the .state file and .var files produced by Simcenter Amesim in an editor
State contributions facility hidden states
.var file
The important thing to realize is that things hidden by Component Customization appear under very unhelpful names (figure below). This is true even if it is not encrypted. In Component Customization you define what is private and what is public. Simcenter Amesim only shows the public part.
Figure 62: State contributions pane
Source: https://docs.sw.siemens.com/en-US/doc/254352342/PL20250521841123434.amesim_collection.AMECustom/Constructing_the_customized_supercomponent · retrieved 2026-07-17