Breadcrumbs

Page History

Versions Compared

Old Version 3

changes.mady.by.user Inga A.

Saved on Dec 15, 2023

compared with

New Version Current

changes.mady.by.user Ranveersinha A.

Saved on Jun 18, 2024

Key

This line was added.
This line was removed.
Formatting was changed.

...

To set up Jupyter Notebook

...

In Jupyter Notebook, run the following command to install a Python package from the <
modeling_tool_installation_directory>
install_root>\plugins\com.nomagic.magicdraw.simulation\pyST.zip file:
Code Block
%pip install pyST.zip

Code Block
%pip install pyST.zip

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
server_host	path	required	The Teamwork Cloud server host name.
server_port	path	required	The Teamwork Cloud server port.
TWC_user_name	path	optional	The Teamwork Cloud user name. If you do not specify the user name in the request, an input field will be provided to specify it later.
TWC_user_password	path	optional	The Teamwork Cloud password. If you do not specify the password in the request, an input field will be provided to specify it later.

Tip
For instructions on how to run server-side simulation using SSL, refer to Running server-side simulation with SSL

...

The following table describes the parameters used in the request:

Parameter

Required or optional

Description

project

path

required

The Teamwork Cloud project name or ID.

version

path

optional

The Teamwork Cloud project version.

branch

path

optional

The project branch name or ID. If the branch is omitted, the trunk is used instead.

element_id

path

optional

The server ID of the Instance Specification to be executed.

config

path

required

The Simulation Configuration name or server ID.

auto_start

path

optional

Starts the simulation automatically after the initialization phase is completed. Available values are:

- true (default) - performs the initialization phase and then starts the simulation (the simulation clock is started).
- false - only the initialization phase of the simulation is performed. The simulation then waits for an invocation to start the simulation, do a step, or terminate the simulation.
  Note
  The ?autoStart query parameter is ignored when multiple iterations are running, e.g. Tradestudy, Montecarlo, or table simulation

started_from

path

optional

Allows specifying the starting location of the simulation. The value of

the

the started_from parameter is provided in the status endpoint response.
commit_results	path	optional	Commits a new project version with the simulation results. Available values are True or False (default).
verification	path	optional	Returns the selected verification results. Available values are: All - all verification results are returned. None - no verification results are returned. Fail (default) - verification results with the fail status are returned.
data	path	optional	A set of output parameters, which will be obtained after the simulation is complete.

Code Block

title	Request and response examples

 # SpaceCraftMassRollup sample

parameters = {
    "inputs":
   {
       "telecom.antenna.me":10,
        "telecom.amplifier.me":20
   },
 "outputs": 
    [ 
        "me",
        "propulsion.me",
        "propulsion.tank.me",
        "propulsion.thruster.me",
        "telecom.me",
        "telecom.antenna.me",
        "telecom.amplifier.me"
    ] 
}
        
client.run('SpacecraftMassRollup_SimWeb', config='spacecraft mass analysis', commit_results=False, data=json.dumps(parameters))

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of a specific simulation.

Start simulation

Panel

borderColor	lightgrey
borderWidth	1

client.start(<simulation_id>)

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of a specific simulation.

Start simulation and get results

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
project	path	required	The Teamwork Cloud project name or ID.
version	path	optional	The Teamwork Cloud project version.
branch	path	optional	The project branch name or ID. If the branch is omitted, the trunk is used instead.
element_id	path	optional	The server ID of the Instance Specification to be executed.
config	path	required	The Simulation Configuration name or server ID.
commit_results	path	optional	A new project version is committed with the simulation results. Available values are True or False (default).
verification	path	optional	Returns the selected verification results. Available values are: All - all verification results are returned. None - no verification results are returned. Fail - verification results with the fail status are returned including the main status and the status of requirements and constraints. If the verification value is not specified, only the verification results with the fail status are returned when the get_results endpoint is called.
data	path	optional	A set of output parameters, which will be obtained after the simulation is complete.

Code Block

title	Request and response examples

 # SpaceCraftMassRollup sample

parameters = {
    "inputs":
   {
       "telecom.antenna.me":10,
        "telecom.amplifier.me":20
   },
 "outputs": 
    [ 
        "me",
        "propulsion.me",
        "propulsion.tank.me",
        "propulsion.thruster.me",
        "telecom.me",
        "telecom.antenna.me",
        "telecom.amplifier.me"
    ] 
}
        
client.simulate('SpacecraftMassRollup_SimWeb', config='spacecraft mass analysis', commit_results=False, data=json.dumps(parameters))

...

This request gets the status of a specific simulation. If the model has a a UI mockup, Time Series Chart, Timeline Chart, or HTML Table, you can use the URL provided in the 'ui' or indexUI' key to open the specified UI.

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of a specific simulation.

Code Block

title	Request and response examples

client.get_status('77d0c496-c1e2-42cd-8ba4-04e4c7f359d3')
 
{'state': 'RUNNING',
 'simulationId': '77d0c496-c1e2-42cd-8ba4-04e4c7f359d3',
 'simulationTime': '0 ms',
 'indexUI': 'http://nm-simulation.dsone.3ds.com/simulation/api/ui/index/77d0c496-c1e2-42cd-8ba4-04e4c7f359d3?pages=Coffee%20Machine.html&pages=Water%20Heating%20Element.html&pages=Wallet.html',
 'project': 'CoffeeMachine',
 'config': 'Coffee Machine',
 'elapsedTime': 0,
 'podName': 'simulation-deployment-6989d5dfc9-r6llk',
 'ui': ['http://nm-simulation.dsone.3ds.com/simulation/api/ui/77d0c496-c1e2-42cd-8ba4-04e4c7f359d3/Coffee%20Machine.html',
  'http://nm-simulation.dsone.3ds.com/simulation/api/ui/77d0c496-c1e2-42cd-8ba4-04e4c7f359d3/Water%20Heating%20Element.html',
  'http://nm-simulation.dsone.3ds.com/simulation/api/ui/77d0c496-c1e2-42cd-8ba4-04e4c7f359d3/Wallet.html']}


client.get_status('ce8c8215-0515-43fd-9d34-92d1d7a95d87')
 
{'state': 'COMPLETED',
 'simulationId': 'ce8c8215-0515-43fd-9d34-92d1d7a95d87',
 'simulationTime': '3000 ms',
 'project': 'SpacecraftMassRollup',
 'config': 'spacecraft mass analysis',
 'elapsedTime': 6598}
 
 
client.get_status('b7bdf933-f58d-4e7e-b73b-8370c60485cd')
 
{'state': 'QUEUED',
 'queueNumber': 3,
 'simulationId': 'b7bdf933-f58d-4e7e-b73b-8370c60485cd',
 'simulationTime': '0 ms',
 'project': 'CarBrakingAnalysis',
 'elapsedTime': 52}

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of the running simulation.
variables	path	optional	The set of simulation variables that should be obtained. If no variables are specified, the values of all simulation variables are returned.

Set simulation variables

Panel

borderColor	lightgrey
borderWidth	1
borderStyle	solid

client.set_variables(<simulation_id>, variables=json.dumps(<parameters>))

This request provides request provides a list of simulation variables with values.

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of the running simulation.
variables	path	required	The set of simulation variables with values that should be used during the current simulation.
context	path	optional	The context ID.
property_path	path	optional	The property path of the context specified using property names or IDs.

Code Block

title	Request and response examples

var = {
 "variables":
 {
 "position": 40
 }
}

client.set_variables('23ceff24-28fa-47e4-b29f-b6b60b4b12e3', variables=json.dumps(var))

...

Note

Panel

borderColor	lightgrey
borderWidth	1
borderStyle	solid

client.pause(<simulation_id>)

title	Available only for HotFix 2

A simplified Set Simulation Variable method can be used when setting a single value, which does not require constructing a JSON.

Panel
client.set_variable(<name>, <value>, <simulation_id> (optional), <context> (optional), <propertyPath> (optional)).

For example, set_variable(name="mass", value=100, propertyPath = "car.engine")

You can also omit parameter names if the parameters are in the correct sequence, for example, client.set_variable("mass", 100).

Pause simulation

Panel

borderColor	lightgrey
borderWidth	1
borderStyle	solid

client.pause(<simulation_id>)

This request pauses the execution of the specified simulation.

The following table describes the parameters used in the REST API request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of the running simulation.

Resume simulation

Panel

borderColor	lightgrey
borderWidth	1
borderStyle	solid

client.resume(<simulation_id>)

This request resumes the execution of the specified simulation.

The following table describes the parameters used in the REST API request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of the running simulation.

Get simulation results

Panel

borderColor	lightgrey
borderWidth	1
borderStyle	solid

client.get_result(<simulation_id>)

This request returns the results of the specified simulation. If the OutputParameters tag of the executed Simulation Configuration is specified, the results are provided according to the OutputParameters tag value. If If a Time Series or Timeline chart is specified for the Simulation Configuration, the chart data is returned in the JSON format.

The figure below demonstrates how to specify input and output parameters.

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of the running simulation.

Get the list of running simulations

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
simulation_id	path	required	The ID of a specific simulation.

Check for Simulation Configurations

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
project	path	required	The Teamwork Cloud project name or ID.
version	path	optional	The Teamwork Cloud project version.
branch	path	optional	The project branch name or ID. If the branch is omitted, the trunk is used instead.

Get Simulation Configurations

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
project	path	required	The Teamwork Cloud project name or ID.
version	path	optional	The Teamwork Cloud project version.
branch	path	optional	The project branch name or ID. If the branch is omitted, the trunk is used instead.
element_id	path	optional	The server ID of the Instance Specification to be executed.
filter	path	optional	Returns Simulations Configurations with a specified UI tag for a particular project. The only possible value for

the filter parameter is

the filter parameter is ui.

Only Simulations Configurations having at least one of the following UI elements are returned:

Frame
Table
TimeSeries chart
Timeline chart

Get Simulation Configuration descriptor

...

This REST API request retrieves Simulation Configuration data (description, execution target, time step, input input and output parameters) from the specified project. The set of input and output parameters is specified using the Input Parameters and Output Parameters properties of a Simulation Configuration. The figure below demonstrates how to specify input and output parameters.

...

The following table describes the parameters used in the request:

Parameter	In	Required or optional	Description
project	path	required	The Teamwork Cloud project name or ID.
version	path	optional	The Teamwork Cloud project version.
branch	path	optional	The project branch name or ID. If the branch is omitted, the trunk is used instead.
config	path	required	The Simulation Configuration name or server ID.

Code Block

title	Request and response examples

 client.get_descriptor('SpacecraftMassPollup_SimWeb', config='spacecraft mass analysis')

{'config': 'spacecraft mass analysis',
 'description': 'Simulation Config that is dedicated to run spacecraft mass rollup.',
 'model': 'spacecraft',
 'parameters': {'inputs': [{'parameter': 'telecom.amplifier.me',
    'value': 32.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]},
   {'parameter': 'telecom.antenna.me',
    'value': 32.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]},
   {'parameter': 'propulsion.tank.me',
    'value': 68.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]},
   {'parameter': 'propulsion.thruster.me',
    'value': 68.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]}],
  'outputs': [{'parameter': 'telecom.me',
    'value': 32.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]},
   {'parameter': 'propulsion.me',
    'value': 68.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]},
   {'parameter': 'me',
    'value': 95.0,
    'type': 'mass[kilogram]',
    'unit': 'kilogram',
    'requirements': [{'id': '1',
      'text': 'Estimated mass shall be less than allocated mass'}]}]}}


client.get_descriptor('BouncingBall', config='Run BouncingBall')


{'config': 'Run BouncingBall',
 'description': 'Simulation Config dedicated to run simulation with bouncingBall.fmu.',
 'model': 'bouncingBall',
 'timeStep': '10 ms' 
 }

...

Content

Space Tools

Versions Compared

Old Version 3

New Version Current

Key

Start simulation

Start simulation and get results

Set simulation variables

Pause simulation

Resume simulation

Get simulation results

Get the list of running simulations

Check for Simulation Configurations

Get Simulation Configurations

Get Simulation Configuration descriptor