Matlab adapter

Matlab adapter on GitHub

This section provides basic materials for use by CDF Domain Experts.

PURPOSE OF THE SOFTWARE

The MATLAB adapter is a stand-alone application. It provides a way to exchange data between an ECSS-E-TM-10-25 hub data source and a MATLAB workspace built from a MATLAB script. By meaning of providing access within the adapter to a MATLAB workspace, the MATLAB adapter allows the user to load a MATLAB script and provides a way to execute it. The adapter is capable of writing values that have been selected from value set from the hub model to any MATLAB variable that has write access. Since the experiment generates time tagged values for its variable, the adapter keeps track of them, and allows to transfer the whole set to a hub Parameter of type SampledFunctionParameterType. Between the setting up of the mapping and the transfer, the adapter provides a preview of mapped things by Highlighting changes in the relevant data trees and displaying representation of things that have been mapped. It is also possible to filter the preview by selection. The adapter keeps track of the mapping and saves in the ExternalIdentifierMap of the open Iteration. The MATLAB Adapter eases the way engineer will use MATLAB and COMET®, by providing easy data exchange and by allowing the execution of MATLAB scripts.

EXTERNAL VIEW OF THE SOFTWARE

The adapter needs two data sources to be operational.

  • A WSP or a COMET® server connected to a COMET® database.
  • A MATLAB script.

OPERATIONS ENVIRONMENT

General

The MATLAB adapter is stand-alone application, so no installation of the software itself is required. It is sufficient to run the executable “DEHPMatlab.exe” to get the adapter running. The software runs on windows system and on both 32bits and 64bits platform.

Hardware Configuration

The minimum hardware configuration is the following.

  • 1 GHz or faster processor
  • 512 MB of RAM (work with larger models will require larger RAM usage)
  • 50 MB of available hard disk space
  • A display with a minimum resolution of 800 pixels by 600 pixels

Software Configuration

Supported Operating System

The MATLAB adapter is targeting .Net 4.7.2, therefore it is compatible with the following platform:

  • Windows 7 SP1 (x86 and x64)
  • Windows 8.1 (x86 and x64)
  • Windows 10 Anniversary Update (x86 and x64)
  • Windows Server 2008 R2 SP1 (x64)
  • Windows Server 2012 (x64)
  • Windows Server 2012 R2 (x64)
  • Windows Server 2016 (x64)

Runtime

The MATLAB adapter requires that the Microsoft .NET Framework 4.7.2 runtime is installed to run. Which is usually the case by default if you are running an up-to-date version of Windows 10.

MATLAB scripts

The MATLAB adapter requires to read MATLAB scripts to use the software at full potential. For a better use, please ends each statement of your script by a semicolon, or at least assignment statement.

COMET® WebServices

The minimal version of the COMET® WebServices is version 7.0.5. The recommended version is 7.0.7.

Operational Constraints

Start-up

When the adapter starts, you can connect to a e-TM-10-25 model. Once this is done, you should be able to browse the ElementDefinition tree. You can now connect to a MATLAB instance. You can then now load a MATLAB script. After this step you can browse the Variable from the MATLAB model.

Execute the MATLAB script

After the adapter has loaded a MATLAB script, you can modify MATLAB variables that are assignable and execute the script from the adapter.

Transfer and Mapping

The MATLAB adapter lets you transfer values from and to a MATLAB workspace to A E-TM-10-25 model. To load a mapping configuration, select one on the provided list and proceed with clicking on the button next to the provided list. To create a new one, type the name of the mapping configuration that you want to create and proceed with the same action. Defined mappings are not editable after they has been saved. The persistence of a mapping is done after a transfer. Currently, there is no possibility to remove or modify a defined mapping. The mapping configuration is only able to add new mapping.

Impact view

The described functionalities in 2.4.3 register themselves in a process where once you have defined what value to transfer to what destination, you have the possibility to preview the impact on the target model, but also to filter those impact view based on a selection from the source model.

Then you can transfer your mapped values to their configured destination.

Transfer

When you choose to transfer, the mapped values are then transferred to the configured target model. In the case anything goes wrong at this stage, you can cancel, and it will delete every configured mapping.

Saved Mapping Configuration

When a transfer has been done, the mapping configuration is saved in the open E-TM-10-25 Iteration. This saved mapping configuration is applied each time you map one thing that have been mapped already. This mapping can be overridden.

Operations Basics

From the moment the adapter has started. In order you can

  • Connect to a E-TM-10-25 source.
  • Connect to a MATLAB instance
  • Load a MATLAB script.
  • Execute the script.
  • Map some value from the connected E-TM-10-25 Model to one MATLAB Variable from the loaded script/workspace
  • Preview the net change.
  • Transfer the mapped values.
  • Execute the script.
  • Map some MATLAB variables set of values to some-TM-10-25 Parameter.
  • Preview the net change.
  • Transfer.

Table of contents