OMSimulatorLib
The OMSimulator project is a FMI-based co-simulation environment that supports ordinary (i.e., non-delayed) and TLM connections.
Connection.h
Go to the documentation of this file.
1 /*
2  * This file is part of OpenModelica.
3  *
4  * Copyright (c) 1998-CurrentYear, Open Source Modelica Consortium (OSMC),
5  * c/o Linköpings universitet, Department of Computer and Information Science,
6  * SE-58183 Linköping, Sweden.
7  *
8  * All rights reserved.
9  *
10  * THIS PROGRAM IS PROVIDED UNDER THE TERMS OF GPL VERSION 3 LICENSE OR
11  * THIS OSMC PUBLIC LICENSE (OSMC-PL) VERSION 1.2.
12  * ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS PROGRAM CONSTITUTES
13  * RECIPIENT'S ACCEPTANCE OF THE OSMC PUBLIC LICENSE OR THE GPL VERSION 3,
14  * ACCORDING TO RECIPIENTS CHOICE.
15  *
16  * The OpenModelica software and the Open Source Modelica
17  * Consortium (OSMC) Public License (OSMC-PL) are obtained
18  * from OSMC, either from the above address,
19  * from the URLs: http://www.ida.liu.se/projects/OpenModelica or
20  * http://www.openmodelica.org, and in the OpenModelica distribution.
21  * GNU version 3 is obtained from: http://www.gnu.org/copyleft/gpl.html.
22  *
23  * This program is distributed WITHOUT ANY WARRANTY; without
24  * even the implied warranty of MERCHANTABILITY or FITNESS
25  * FOR A PARTICULAR PURPOSE, EXCEPT AS EXPRESSLY SET FORTH
26  * IN THE BY RECIPIENT SELECTED SUBSIDIARY LICENSE CONDITIONS OF OSMC-PL.
27  *
28  * See the full OSMC Public License conditions for more details.
29  *
30  */
31 
32 #ifndef _OMS_CONNECTION_H_
33 #define _OMS_CONNECTION_H_
34 
35 #include "ComRef.h"
36 #include "Connector.h"
37 #include "ssd/ConnectionGeometry.h"
38 #include "Types.h"
39 
40 #include <string>
41 
42 namespace oms
43 {
45  // * \brief Connection
46  // * /
47  class Connection : protected oms_connection_t
48  {
49  public:
51  ~Connection();
52 
53  // methods to copy the object
54  Connection(const Connection& rhs);
55  Connection& operator=(const Connection& rhs);
56 
57  oms_status_enu_t exportToSSD(pugi::xml_node& root) const;
58 
59  const oms::ComRef getSignalA() const {return oms::ComRef(conA);}
60  const oms::ComRef getSignalB() const {return oms::ComRef(conB);}
61 
63  void setGeometry(const oms::ssd::ConnectionGeometry* newGeometry, bool inverse=false);
65  void setTLMParameters(double delay, double alpha, double linearimpedance, double angualrimpedance);
67 
69 
70  bool isEqual(const oms::Connection& connection) const;
71  bool isEqual(const oms::ComRef& signalA, const oms::ComRef& signalB) const;
72  bool isStrictEqual(const oms::ComRef& signalA, const oms::ComRef& signalB) const;
73  bool containsSignal(const oms::ComRef& signal) const;
74  bool containsSignalB(const oms::ComRef& signal) const;
75 
80  static bool isValid(const ComRef& crefA, const ComRef& crefB, const Connector& conA, const Connector& conB);
81  static bool isValidUnits(const ComRef& crefA, const ComRef& crefB, const Connector& conA, const Connector& conB);
82  static void getSIUnits(const Connector& connector, std::map<std::string, std::string>& baseUnits);
83  oms_status_enu_t rename(const oms::ComRef& cref, const oms::ComRef& newCref);
84  private:
85  friend bool operator==(const Connection& lhs, const Connection& rhs);
86  friend bool operator!=(const Connection& lhs, const Connection& rhs);
87  };
88 
89  inline bool operator==(const Connection& lhs, const Connection& rhs) {return lhs.isEqual(rhs);}
90  inline bool operator!=(const Connection& lhs, const Connection& rhs) {return !(lhs == rhs);}
91 }
92 
93 #endif
void setTLMParameters(const oms_tlm_connection_parameters_t *parameters)
Definition: Connection.cpp:162
oms_connection_type_enu_t type
Connection type, e.g. TLM.
Definition: Types.h:347
friend bool operator==(const Connection &lhs, const Connection &rhs)
Definition: Connection.h:89
bool isEqual(const oms::Connection &connection) const
Definition: Connection.cpp:195
oms_status_enu_t exportToSSD(pugi::xml_node &root) const
Definition: Connection.cpp:119
Connection between two connectors.
Definition: Types.h:346
bool isStrictEqual(const oms::ComRef &signalA, const oms::ComRef &signalB) const
"A->B" is not strict equal "B->A"
Definition: Connection.cpp:185
bool containsSignalB(const oms::ComRef &signal) const
Definition: Connection.cpp:207
Connection & operator=(const Connection &rhs)
Definition: Connection.cpp:90
char * conB
Name of connector B.
Definition: Types.h:349
oms_status_enu_t
Definition: Types.h:43
char * conA
Name of connector A.
Definition: Types.h:348
static bool isValid(const ComRef &crefA, const ComRef &crefB, const Connector &conA, const Connector &conB)
Checks a connection based on SSP-1.0 connection table.
Definition: Connection.cpp:212
static void getSIUnits(const Connector &connector, std::map< std::string, std::string > &baseUnits)
Definition: Connection.cpp:262
oms_connection_type_enu_t
Connection type.
Definition: Types.h:147
ComRef - component reference.
Definition: ComRef.h:46
oms_tlm_connection_parameters_t * getTLMParameters() const
Definition: Connection.h:66
oms_tlm_connection_parameters_t * tlmparameters
TLM parameters (only for TLM connections)
Definition: Types.h:351
const char * parameters
Definition: Tags.cpp:80
const oms::ComRef getSignalB() const
Definition: Connection.h:60
const oms::ssd::ConnectionGeometry * getGeometry() const
Definition: Connection.h:62
Connector.
Definition: Connector.h:49
~Connection()
Definition: Connection.cpp:63
bool containsSignal(const oms::ComRef &signal) const
Definition: Connection.cpp:202
FMI conncection (directed & undelayed signal connection)
Definition: Types.h:148
bool suppressUnitConversion
boolean to specify automatic unit coversion between connections
Definition: Types.h:352
oms_status_enu_t rename(const oms::ComRef &cref, const oms::ComRef &newCref)
Definition: Connection.cpp:278
Definition: AlgLoop.h:44
bool getSuppressUnitConversion()
Definition: Connection.h:76
Parameters for TLM connection.
Definition: Types.h:336
Connection(const oms::ComRef &conA, const oms::ComRef &conB, bool suppressUnitConversion=false, oms_connection_type_enu_t type=oms_connection_single)
Definition: Connection.cpp:42
const char * signal
Definition: Tags.cpp:38
void setGeometry(const oms::ssd::ConnectionGeometry *newGeometry, bool inverse=false)
Definition: Connection.cpp:153
Definition: ConnectionGeometry.h:45
**
Definition: Connection.h:47
const oms::ComRef getSignalA() const
Definition: Connection.h:59
const char * connection
Definition: Tags.cpp:46
ssd_connection_geometry_t * geometry
Geometry information of the connection.
Definition: Types.h:350
const char * connector
Definition: Tags.cpp:49
oms_connection_type_enu_t getType() const
Definition: Connection.h:68
friend bool operator!=(const Connection &lhs, const Connection &rhs)
Definition: Connection.h:90
static bool isValidUnits(const ComRef &crefA, const ComRef &crefB, const Connector &conA, const Connector &conB)
Definition: Connection.cpp:246