## On this page # C Interfaces for Participant Library Last update: 17.07.2025 Provides C interfaces to the System Coupling participant library. The C interface closely follows the C++ interface, and is implemented as a wrapper around the latter. ## Enumeration types ### Enumeration type SyscLocation ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 26) ``` enum SyscLocation { SyscNode = 0, SyscElement = 1 } ``` Provide an enum for variable mesh locations. #### Enumerator SyscNode Nodal data. #### Enumerator SyscElement Data on elements. ### Enumeration type SyscTensorType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 32) ``` enum SyscTensorType { SyscScalar = 0, SyscVector = 1 } ``` Provide an enum for variable tensor type. #### Enumerator SyscScalar Scalar #### Enumerator SyscVector Vector ### Enumeration type SyscTopology ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 38) ``` enum SyscTopology { SyscSurface = 2, SyscVolume = 3 } ``` Provide an enum for region topologies. #### Enumerator SyscSurface Surface topology. #### Enumerator SyscVolume Volume topology. ### Enumeration type SyscRegionDiscretizationType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 44) ``` enum SyscRegionDiscretizationType { SyscMeshRegion = 0, SyscPointCloudRegion = 1 } ``` Provide an enum for region mesh type. #### Enumerator SyscMeshRegion Mesh region discretization. #### Enumerator SyscPointCloudRegion Point cloud region discretization. ### Enumeration type SyscInterfaceSide ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 50) ``` enum SyscInterfaceSide { SyscInterfaceSide_One = 1, SyscInterfaceSide_Two = 2 } ``` Provide enum for coupling interface side. #### Enumerator SyscInterfaceSide\_One #### Enumerator SyscInterfaceSide\_Two ### Enumeration type SyscDimension ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 56) ``` enum SyscDimension { SyscD2 = 2, SyscD3 = 3 } ``` Provide enum for system coupling dimension. #### Enumerator SyscD2 #### Enumerator SyscD3 ### Enumeration type SyscTimeIntegration ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 62) ``` enum SyscTimeIntegration { SyscImplicit = 0, SyscExplicit = 1 } ``` Provide an enum for time integration. #### Enumerator SyscImplicit #### Enumerator SyscExplicit ### Enumeration type SyscQuantityType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 91) ``` enum SyscQuantityType { SyscUnspecified = 0, SyscForce = 1, SyscIncrementalDisplacement = 2, SyscTemperature = 3, SyscHeatRate = 4, SyscHeatTransferCoefficient = 5, SyscConvectionReferenceTemperature = 6, SyscModeShape = 7, SyscElectricalConductivity = 8 } ``` Provide an enum for supported quantity types. Quantity type provides information about the physical meaning of the variable. This can be useful for detecting validation errors during the coupled analysis setup. If the variable does not match any of the provided quantity types, quantity type can be set to unspecified. #### Enumerator SyscUnspecified #### Enumerator SyscForce #### Enumerator SyscIncrementalDisplacement #### Enumerator SyscTemperature #### Enumerator SyscHeatRate #### Enumerator SyscHeatTransferCoefficient #### Enumerator SyscConvectionReferenceTemperature #### Enumerator SyscModeShape #### Enumerator SyscElectricalConductivity ### Enumeration type SyscDataType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 103) ``` enum SyscDataType { SyscDataType_Real = 0, SyscDataType_Complex = 1 } ``` #### Enumerator SyscDataType\_Real #### Enumerator SyscDataType\_Complex ### Enumeration type SyscConvergenceStatus ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 109) ``` enum SyscConvergenceStatus { SyscDiverging = -1, SyscNotYetConverged = 0, SyscConverged = 1, SyscComplete = 2, SyscNotEvaluated = 3 } ``` Provide enum for participant's solver convergence status. #### Enumerator SyscDiverging #### Enumerator SyscNotYetConverged #### Enumerator SyscConverged #### Enumerator SyscComplete #### Enumerator SyscNotEvaluated ### Enumeration type SyscAnalysisType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 118) ``` enum SyscAnalysisType { SyscSteady = 0, SyscTransient = 1 } ``` Provide an enum for coupled analysis type. #### Enumerator SyscSteady Steady analysis type. #### Enumerator SyscTransient Transient (unsteady) analysis type. ### Enumeration type SyscPrimitiveType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 147) ``` enum SyscPrimitiveType { SyscFloat = 0, SyscDouble = 1, SyscInt32 = 2, SyscInt64 = 3, SyscUnsignedInt16 = 4, SyscUnsignedInt64 = 5 } ``` Provide an enum for supported primitive types. #### Enumerator SyscFloat Single-precision floating point type. #### Enumerator SyscDouble Double-precision floating point type. #### Enumerator SyscInt32 Signed 32-bit integer. #### Enumerator SyscInt64 Signed 64-bit integer. #### Enumerator SyscUnsignedInt16 Unsigned 16-bit integer. #### Enumerator SyscUnsignedInt64 Unsigned 64-bit integer. ### Enumeration type SyscParticipantType ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 156) ``` enum SyscParticipantType { SyscDEFAULT = 0, SyscCFX = 1, SyscFLUENT = 2, SyscMAPDL = 3, SyscAEDT = 4, SyscFMU = 5, SyscFMU_PROXY = 6, SyscEXTERNALDATA = 7, SyscFORTE = 8, SyscDEFAULT_SRV = 9, SyscMECH_SRV = 10, SyscCFD_SRV = 11, SyscSCDT_SRV = 12, SyscTHERMAL_DESKTOP = 13, SyscLS_DYNA = 14, SyscROCKY = 15 } ``` #### Enumerator SyscDEFAULT #### Enumerator SyscCFX #### Enumerator SyscFLUENT #### Enumerator SyscMAPDL #### Enumerator SyscAEDT #### Enumerator SyscFMU #### Enumerator SyscFMU\_PROXY #### Enumerator SyscEXTERNALDATA #### Enumerator SyscFORTE #### Enumerator SyscDEFAULT\_SRV #### Enumerator SyscMECH\_SRV #### Enumerator SyscCFD\_SRV #### Enumerator SyscSCDT\_SRV #### Enumerator SyscTHERMAL\_DESKTOP #### Enumerator SyscLS\_DYNA #### Enumerator SyscROCKY ### Enumeration type SyscElementTypes ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscElementTypes.h` (line 238) ``` enum SyscElementTypes { SyscTri3 = 5, SyscTri6 = 6, SyscQuad4 = 7, SyscQuad8 = 8, SyscTet4 = 9, SyscTet10 = 10, SyscHex8 = 11, SyscHex20 = 12, SyscWedge6 = 13, SyscWedge15 = 14, SyscPyramid5 = 15, SyscPyramid13 = 16, SyscPolygon = 18, SyscPolyhedron = 19 } ``` Provide an enum for element types. #### Enumerator SyscTri3 Trilateral element with corner nodes only. #### Enumerator SyscTri6 Trilateral element with corner and mid-side nodes. #### Enumerator SyscQuad4 Quadrilateral element with corner nodes only. #### Enumerator SyscQuad8 Quadrilateral element with corner and mid-side nodes. #### Enumerator SyscTet4 Tetrahedral element with corner nodes only. #### Enumerator SyscTet10 Tetrahedral element with corner and mid-side nodes. #### Enumerator SyscHex8 Hexahedral element with corner nodes only. #### Enumerator SyscHex20 Hexahedral element with corner and mid-side nodes. #### Enumerator SyscWedge6 Wedge element with corner nodes only. #### Enumerator SyscWedge15 Wedge element with corner and mid-side nodes. #### Enumerator SyscPyramid5 Pyramid element with corner nodes only. #### Enumerator SyscPyramid13 Pyramid element with corner and mid-side nodes. #### Enumerator SyscPolygon Arbitrary polygon. #### Enumerator SyscPolyhedron Arbitrary polyhedron. ## Typedefs ### Typedef SyscSolutionControl ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 134) ``` typedef struct SyscSolutionControl SyscSolutionControl ``` Provide a structure containing solution control. **Return type**: struct [SyscSolutionControl](structSyscSolutionControl.md#structSyscSolutionControl) ### Typedef SyscOpaqueDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 175) ``` typedef void* SyscOpaqueDataAccess ``` Declare an opaque pointer type. **Return type**: void \* ### Typedef SyscSetupInfo ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 197) ``` typedef struct SyscSetupInfo SyscSetupInfo ``` Provide a structure for System Coupling setup information. To create and/or initialize the [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) struct, it is highly recommended to use one of the functions with names starting with `syscGetSetupInfo`. These functions will initialize all members to the correct values and will help to avoid back-compatibility issues in the future. For example: ``` SyscSetupInfo setupInfo = syscGetSetupInfoA(SyscSteady); ``` **Return type**: struct [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Typedef SyscSetupFileInfo ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 297) ``` typedef struct SyscSetupFileInfo SyscSetupFileInfo ``` Provide a structure for writing System Coupling setup files. To create and/or initialize the [SyscSetupFileInfo](structSyscSetupFileInfo.md#structSyscSetupFileInfo) struct, it is highly recommended to use `syscGetSetupFileInfo` function. This function will initialize all members to the correct values and will help to avoid back-compatibility issues in the future. For example: ``` SyscSetupFileInfo setupFileInfo = syscGetSetupFileInfo("setup.scp"); ``` **Return type**: struct [SyscSetupFileInfo](structSyscSetupFileInfo.md#structSyscSetupFileInfo) ### Typedef SyscResultsInfo ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCommonTypes.h` (line 316) ``` typedef struct SyscResultsInfo SyscResultsInfo ``` Provide a structure for writing results files. **Return type**: struct [SyscResultsInfo](structSyscResultsInfo.md#structSyscResultsInfo) ### Typedef SyscCouplingInterface ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscCouplingInterface.h` (line 47) ``` typedef struct SyscCouplingInterface SyscCouplingInterface ``` Provide a struct for a coupling interface. Coupling interface can be used to set up the transfers of data between different regions within the same participant solver. Interface contains two sides and each side can contain one or more regions. Data transfers are automatically defined: if a variable is defined as an output on all regions on one side of the interface and as an input on all regions on the opposide side of the interface, then it will be mapped from the former side to the latter side. All regions on one side of the interface must have the same topology. To create and/or initialize the [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) struct, it is highly recommended to use the `syscGetCouplingInterface` function. This function will initialize all members to the correct values and will help to avoid back-compatibility issues in the future. For example: ``` SyscCouplingInterface reg = syscGetCouplingInterface("FSI"); ``` **Return type**: struct [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) ### Typedef SyscDataTransfer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscDataTransfer.h` (line 33) ``` typedef struct SyscDataTransfer SyscDataTransfer ``` Provide a struct for a data transfer. Data transfer specifies the source and target variables for mapping. **Return type**: struct [SyscDataTransfer](structSyscDataTransfer.md#structSyscDataTransfer) ### Typedef SyscInputScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 39) ``` typedef SyscInputScalarData(* SyscInputScalarDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to input scalar data. **Return type**: [SyscInputScalarData](structSyscInputScalarData.md#structSyscInputScalarData)(\* ### Typedef SyscInputScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 46) ``` typedef SyscInputScalarData(* SyscInputScalarDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to input scalar data with opaque pointer. **Return type**: [SyscInputScalarData](structSyscInputScalarData.md#structSyscInputScalarData)(\* ### Typedef SyscInputScalarDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 54) ``` typedef SyscInputScalarData(* SyscInputScalarDataMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone input scalar data. **Return type**: [SyscInputScalarData](structSyscInputScalarData.md#structSyscInputScalarData)(\* ### Typedef SyscInputVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 63) ``` typedef SyscInputVectorData(* SyscInputVectorDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to input vector data. **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData)(\* ### Typedef SyscInputVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 70) ``` typedef SyscInputVectorData(* SyscInputVectorDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to input vector data with opaque pointer. **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData)(\* ### Typedef SyscInputVectorDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 78) ``` typedef SyscInputVectorData(* SyscInputVectorDataMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone input vector data. **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData)(\* ### Typedef SyscOutputScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 87) ``` typedef SyscOutputScalarData(* SyscOutputScalarDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to output scalar data. **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData)(\* ### Typedef SyscOutputScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 94) ``` typedef SyscOutputScalarData(* SyscOutputScalarDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to output scalar data with opaque pointer. **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData)(\* ### Typedef SyscOutputScalarDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 102) ``` typedef SyscOutputScalarData(* SyscOutputScalarDataMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone output scalar data. **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData)(\* ### Typedef SyscOutputVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 111) ``` typedef SyscOutputVectorData(* SyscOutputVectorDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to output vector data. **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData)(\* ### Typedef SyscOutputVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 118) ``` typedef SyscOutputVectorData(* SyscOutputVectorDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to output vector data with opaque pointer. **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData)(\* ### Typedef SyscOutputVectorDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 126) ``` typedef SyscOutputVectorData(* SyscOutputVectorDataMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone output vector data. **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData)(\* ### Typedef SyscInputComplexScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 135) ``` typedef SyscInputComplexScalarData(* SyscInputComplexScalarDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to input complex scalar data. **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData)(\* ### Typedef SyscInputComplexScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 142) ``` typedef SyscInputComplexScalarData(* SyscInputComplexScalarDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to input complex scalar data with opaque pointer. **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData)(\* ### Typedef SyscInputComplexVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 150) ``` typedef SyscInputComplexVectorData(* SyscInputComplexVectorDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to input complex vector data. **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData)(\* ### Typedef SyscInputComplexVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 157) ``` typedef SyscInputComplexVectorData(* SyscInputComplexVectorDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to input complex vector data with opaque pointer. **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData)(\* ### Typedef SyscOutputComplexScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 165) ``` typedef SyscOutputComplexScalarData(* SyscOutputComplexScalarDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to output complex scalar data. **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData)(\* ### Typedef SyscOutputComplexScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 172) ``` typedef SyscOutputComplexScalarData(* SyscOutputComplexScalarDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to output complex scalar data with opaque pointer. **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData)(\* ### Typedef SyscOutputComplexVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 180) ``` typedef SyscOutputComplexVectorData(* SyscOutputComplexVectorDataAccess) (const char *regionName, const char *variableName) ``` Provide function prototype for access to output complex vector data. **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData)(\* ### Typedef SyscOutputComplexVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 187) ``` typedef SyscOutputComplexVectorData(* SyscOutputComplexVectorDataAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, const char *variableName) ``` Provide function prototype for access to output complex vector data with opaque pointer. **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData)(\* ### Typedef SyscSurfMeshAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 195) ``` typedef SyscSurfaceMesh(* SyscSurfMeshAccess) (const char *regionName) ``` Provide function prototype for access to surface mesh. **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh)(\* ### Typedef SyscSurfaceMeshAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 201) ``` typedef SyscSurfaceMesh(* SyscSurfaceMeshAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName) ``` Provide function prototype for access to surface mesh with opaque pointer. **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh)(\* ### Typedef SyscSurfaceMeshMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 206) ``` typedef SyscSurfaceMesh(* SyscSurfaceMeshMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone surface mesh. **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh)(\* ### Typedef SyscVolumeMeshAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 214) ``` typedef SyscVolumeMesh(* SyscVolumeMeshAccess) (const char *regionName) ``` Provide function prototype for access to volume mesh. **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh)(\* ### Typedef SyscVolumeMeshAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 220) ``` typedef SyscVolumeMesh(* SyscVolumeMeshAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName) ``` Provide function prototype for access to volume mesh with opaque pointer. **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh)(\* ### Typedef SyscVolumeMeshMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 225) ``` typedef SyscVolumeMesh(* SyscVolumeMeshMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone volume mesh. **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh)(\* ### Typedef SyscPointCloudAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 233) ``` typedef SyscPointCloud(* SyscPointCloudAccess) (const char *regionName) ``` Provide function prototype for access to point cloud. **Return type**: [SyscPointCloud](structSyscPointCloud.md#structSyscPointCloud)(\* ### Typedef SyscPointCloudAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 239) ``` typedef SyscPointCloud(* SyscPointCloudAccessWithPointer) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName) ``` Provide function prototype for access to point cloud with an opaque pointer. **Return type**: [SyscPointCloud](structSyscPointCloud.md#structSyscPointCloud)(\* ### Typedef SyscPointCloudMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 244) ``` typedef SyscPointCloud(* SyscPointCloudMultiZoneAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName, uint16_t zoneIndex) ``` Provide function prototype for access to multi-zone point cloud. **Return type**: [SyscPointCloud](structSyscPointCloud.md#structSyscPointCloud)(\* ### Typedef SyscZoneCountAccess ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 252) ``` typedef uint16_t(* SyscZoneCountAccess) (SyscOpaqueDataAccess opaqueDataAccess, const char *regionName) ``` Provide function prototype for access to zone count. **Return type**: uint16\_t(\* ### Typedef SyscRestartPointCreation ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscFunctionTypes.h` (line 263) ``` typedef const char*(* SyscRestartPointCreation) () ``` Provide function prototype for creating restart points. This function may be called only during outputs update, and is expected to return a unique string identifier for a given restart point. **Return type**: const char *(* ### Typedef SyscParameter ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscParameter.h` (line 29) ``` typedef struct SyscParameter SyscParameter ``` Provide a struct for a System Coupling parameter. **Return type**: struct [SyscParameter](structSyscParameter.md#structSyscParameter) ### Typedef SyscRegion ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscRegion.h` (line 47) ``` typedef struct SyscRegion SyscRegion ``` Provide a struct for a System Coupling region. Participant can declare which regions can be used in the coupled analysis. Each region can declare its input variables and output variables. Input variables represent physical quantities whose values the participant expects System Coupling to provide. Output variables represent physical quantities whose values System Coupling expects the participant to provide. To create and/or initialize the [SyscRegion](structSyscRegion.md#structSyscRegion) struct, it is highly recommended to use one of the functions with names starting with `syscGetRegion`. These functions will initialize all members to the correct values and will help to avoid back-compatibility issues in the future. For example: ``` SyscRegion reg = syscGetRegionT("Wall", SyscSurface); ``` **Return type**: struct [SyscRegion](structSyscRegion.md#structSyscRegion) ### Typedef SyscVariable ![](https://img.shields.io/badge/-public-brightgreen "public") **Definition**: `syscVariable.h` (line 45) ``` typedef struct SyscVariable SyscVariable ``` Provide a struct for a System Coupling variable. To create and/or initialize the [SyscVariable](structSyscVariable.md#structSyscVariable) struct, it is highly recommended to use one of the functions with names starting with `syscGetVariable`. These functions will initialize all members to the correct values and will help to avoid back-compatibility issues in the future. For example: ``` SyscVariable var = syscGetVariableTE( "Temperature", SyscScalar, 0, SyscNode); ``` **Return type**: struct [SyscVariable](structSyscVariable.md#structSyscVariable) ## Functions ### Function syscGetRealAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRealAttribute syscGetRealAttribute(const char *name, double value, SyscDimensionality dimensionality) ``` Create a real-valued attribute. **Parameters**: - **name**: - attribute name. - **value**: - attribute value. - **dimensionality**: - attribute dimensionality. **Parameters**: - const char \* **name** - double **value** - [SyscDimensionality](structSyscDimensionality.md#structSyscDimensionality) **dimensionality** **Return type**: [SyscRealAttribute](structSyscRealAttribute.md#structSyscRealAttribute) ### Function syscGetRealAttributeVDM ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRealAttribute syscGetRealAttributeVDM(const char *name, double value, SyscDimensionality dimensionality, int modifiable) ``` Create a real-valued attribute. **Parameters**: - **name**: - attribute name. - **value**: - attribute value. - **dimensionality**: - attribute dimensionality. - **modifiable**: - attribute is modifiable. **Parameters**: - const char \* **name** - double **value** - [SyscDimensionality](structSyscDimensionality.md#structSyscDimensionality) **dimensionality** - int **modifiable** **Return type**: [SyscRealAttribute](structSyscRealAttribute.md#structSyscRealAttribute) ### Function syscGetIntegerAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscIntegerAttribute syscGetIntegerAttribute(const char *name, long long int value) ``` Create an integer-valued attribute. **Parameters**: - **name**: - attribute name. - **value**: - attribute value. **Parameters**: - const char \* **name** - long long int **value** **Return type**: [SyscIntegerAttribute](structSyscIntegerAttribute.md#structSyscIntegerAttribute) ### Function syscGetIntegerAttributeVM ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscIntegerAttribute syscGetIntegerAttributeVM(const char *name, long long int value, int modifiable) ``` Create an integer-valued attribute. **Parameters**: - **name**: - attribute name. - **value**: - attribute value. - **modifiable**: - attribute is modifiable. **Parameters**: - const char \* **name** - long long int **value** - int **modifiable** **Return type**: [SyscIntegerAttribute](structSyscIntegerAttribute.md#structSyscIntegerAttribute) ### Function syscGetDimensionality ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscDimensionality syscGetDimensionality() ``` Get dimensionality. **Return type**: [SyscDimensionality](structSyscDimensionality.md#structSyscDimensionality) ### Function syscGetSyscError ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscGetSyscError(int retcode, const char *message) ``` Provide a function to return [SyscError](structSyscError.md#structSyscError) struct. **Parameters**: - int **retcode** - const char \* **message** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscGetSetupInfo ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupInfo syscGetSetupInfo() ``` Create a setup info struct. Analysis type will be set to steady. Restarts supported flag will be set to false. **Return type**: [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Function syscGetSetupInfoA ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupInfo syscGetSetupInfoA(enum SyscAnalysisType analysisType) ``` Create a setup info struct. **Parameters**: - **analysisType**: - analysis type. Restarts supported flag will be set to false. **Parameters**: - enum [SyscAnalysisType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7d5b3786948265c902f7231abe6d79b5) **analysisType** **Return type**: [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Function syscGetSetupInfoAR ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupInfo syscGetSetupInfoAR(enum SyscAnalysisType analysisType, int restartsSupported) ``` Create a setup info struct. **Parameters**: - **analysisType**: - analysis type. - **restartsSupported**: - flag indicating whether restarts are supported. **Parameters**: - enum [SyscAnalysisType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7d5b3786948265c902f7231abe6d79b5) **analysisType** - int **restartsSupported** **Return type**: [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Function syscGetSetupInfoARD ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupInfo syscGetSetupInfoARD(enum SyscAnalysisType analysisType, int restartsSupported, enum SyscDimension dimension) ``` Create a setup info struct. **Parameters**: - **analysisType**: - analysis type. - **restartsSupported**: - flag indicating whether restarts are supported. - **dimension**: - dimension of the participant. **Parameters**: - enum [SyscAnalysisType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7d5b3786948265c902f7231abe6d79b5) **analysisType** - int **restartsSupported** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Function syscGetSetupInfoARDT ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupInfo syscGetSetupInfoARDT(enum SyscAnalysisType analysisType, int restartsSupported, enum SyscDimension dimension, enum SyscTimeIntegration timeIntegration) ``` Create a setup info struct. **Parameters**: - **analysisType**: - analysis type. - **restartsSupported**: - flag indicating whether restarts are supported. - **dimension**: - dimension of the participant. - **timeIntegration**: - Time integration method **Parameters**: - enum [SyscAnalysisType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7d5b3786948265c902f7231abe6d79b5) **analysisType** - int **restartsSupported** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** - enum [SyscTimeIntegration](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaedf008f34febb068e44cb21292dc167f) **timeIntegration** **Return type**: [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Function syscGetSetupInfoARDTP ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupInfo syscGetSetupInfoARDTP(enum SyscAnalysisType analysisType, int restartsSupported, enum SyscDimension dimension, enum SyscTimeIntegration timeIntegration, enum SyscParticipantType participantType) ``` Create a setup info struct. **Parameters**: - **analysisType**: - analysis type. - **restartsSupported**: - flag indicating whether restarts are supported. - **dimension**: - dimension of the participant. - **timeIntegration**: - Time integration method - **participantType**: - Participant type **Parameters**: - enum [SyscAnalysisType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7d5b3786948265c902f7231abe6d79b5) **analysisType** - int **restartsSupported** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** - enum [SyscTimeIntegration](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaedf008f34febb068e44cb21292dc167f) **timeIntegration** - enum SyscParticipantType **participantType** **Return type**: [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) ### Function syscGetSetupFileInfo ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSetupFileInfo syscGetSetupFileInfo(const char *setupFileName) ``` Provide a function to create SetupFileInfo struct. **Parameters**: - **setupFileName**: Setup file name. Restarts supported flag will be set to false. **Parameters**: - const char \* **setupFileName** **Return type**: [SyscSetupFileInfo](structSyscSetupFileInfo.md#structSyscSetupFileInfo) ### Function syscGetResultsInfo ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscResultsInfo syscGetResultsInfo(const char *baseFileName) ``` Provide a function to create SetupFileInfo struct. **Parameters**: - **baseFileName**: - base results file name. **Parameters**: - const char \* **baseFileName** **Return type**: [SyscResultsInfo](structSyscResultsInfo.md#structSyscResultsInfo) ### Function syscGetCouplingInterface ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCouplingInterface syscGetCouplingInterface(const char *name) ``` Create a coupling interface. **Parameters**: - **name**: - Unique name for this interface. String length should not exceed SYSC\_STRING\_LENGTH. **Parameters**: - const char \* **name** **Return type**: [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) ### Function syscAddSideOneRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddSideOneRegion(const SyscCouplingInterface couplingInterface, const SyscRegion region) ``` Add region to side one of the interface. If this region has already been added to the interface on side one, then this call will have no effect. If a different region with the same name has already been added to the interface on side one, then a runtime error will be thrown. If a region with the same name has already been added to the interface on side two, then a runtime error will be thrown. If the region name contains invalid characters, a runtime error will be thrown. **Parameters**: - **couplingInterface**: Coupling interface to which the output variable is to be added. - **region**: Region to be added to side one of the interface. **Parameters**: - const [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddSideTwoRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddSideTwoRegion(const SyscCouplingInterface couplingInterface, const SyscRegion region) ``` Add region to side two of the interface. If this region has already been added to the interface on side two, then this call will have no effect. If a different region with the same name has already been added to the interface on side two, then a runtime error will be thrown. If a region with the same name has already been added to the interface on side one, then a runtime error will be thrown. If the region name contains invalid characters, a runtime error will be thrown. **Parameters**: - **couplingInterface**: Coupling interface to which the output variable is to be added. - **region**: Region to be added to side two of the interface. **Parameters**: - const [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddDataTransfer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddDataTransfer(SyscCouplingInterface couplingInterface, SyscDataTransfer dataTransfer) ``` Add the data transfer to the coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - [SyscDataTransfer](structSyscDataTransfer.md#structSyscDataTransfer) **dataTransfer** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscCouplingInterfaceGetNumDataTransfers ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscCouplingInterfaceGetNumDataTransfers(SyscCouplingInterface couplingInterface) ``` Get number of data transfer for a given coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** **Return type**: size\_t ### Function syscCouplingInterfaceGetNumSideOneRegions ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscCouplingInterfaceGetNumSideOneRegions(SyscCouplingInterface couplingInterface) ``` Get number of side one regions for a given coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** **Return type**: size\_t ### Function syscCouplingInterfaceGetNumSideTwoRegions ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscCouplingInterfaceGetNumSideTwoRegions(SyscCouplingInterface couplingInterface) ``` Get number of side two regions for a given coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** **Return type**: size\_t ### Function syscCouplingInterfaceGetDataTransfer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscDataTransfer syscCouplingInterfaceGetDataTransfer(SyscCouplingInterface couplingInterface, size_t index) ``` Get the data transfer at specified index for a given coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - size\_t **index** **Return type**: [SyscDataTransfer](structSyscDataTransfer.md#structSyscDataTransfer) ### Function syscCouplingInterfaceGetSideOneRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscCouplingInterfaceGetSideOneRegion(SyscCouplingInterface couplingInterface, size_t index) ``` Get the side one region at specified index for a given coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - size\_t **index** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscCouplingInterfaceGetSideTwoRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscCouplingInterfaceGetSideTwoRegion(SyscCouplingInterface couplingInterface, size_t index) ``` Get the side two region at specified index for a given coupling interface. **Parameters**: - [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - size\_t **index** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscGetDataTransfer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscDataTransfer syscGetDataTransfer(SyscVariable sideOneVariable, SyscVariable sideTwoVariable, enum SyscInterfaceSide targetSide) ``` Create a data transfer using side{One|Two}Variable. **Parameters**: - **sideOneVariable**: - side one variable. - **sideTwoVariable**: - side two variable. - **targetSide**: - target side. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **sideOneVariable** - [SyscVariable](structSyscVariable.md#structSyscVariable) **sideTwoVariable** - enum [SyscInterfaceSide](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gacf32f1d9c1566f28bee2b348b2dcd9f5) **targetSide** **Return type**: [SyscDataTransfer](structSyscDataTransfer.md#structSyscDataTransfer) ### Function syscGetDataTransferST ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscDataTransfer syscGetDataTransferST(SyscVariable sourceVariable, SyscVariable targetVariable, enum SyscInterfaceSide targetSide) ``` Create a data transfer using {source|target}Variable. **Parameters**: - **sourceVariable**: - source variable. - **targetVariable**: - target variable. - **targetSide**: - target side. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **sourceVariable** - [SyscVariable](structSyscVariable.md#structSyscVariable) **targetVariable** - enum [SyscInterfaceSide](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gacf32f1d9c1566f28bee2b348b2dcd9f5) **targetSide** **Return type**: [SyscDataTransfer](structSyscDataTransfer.md#structSyscDataTransfer) ### Function syscGetInputComplexScalarData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexScalarData syscGetInputComplexScalarData() ``` Create an empty input copmlex scalar data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointers will be set to null. **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData) ### Function syscGetInputComplexScalarDataSplitDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexScalarData syscGetInputComplexScalarDataSplitDouble(double *const dataReal, double *const dataImag, size_t dataSize) ``` Create a complex input scalar data access struct. **Parameters**: - **dataReal**: - pointer to the double-precision real data component. - **dataImag**: - pointer to the double-precision imaginary data component. - **dataSize**: - data size. **Parameters**: - double \*const **dataReal** - double \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData) ### Function syscGetInputComplexScalarDataSplitFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexScalarData syscGetInputComplexScalarDataSplitFloat(float *const dataReal, float *const dataImag, size_t dataSize) ``` Create a complex input scalar data access struct. **Parameters**: - **dataReal**: - pointer to the single-precision real data component. - **dataImag**: - pointer to the single-precision imaginary data component. - **dataSize**: - data size. **Parameters**: - float \*const **dataReal** - float \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData) ### Function syscGetInputComplexScalarDataCompactDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexScalarData syscGetInputComplexScalarDataCompactDouble(double *const data, size_t dataSize) ``` Create a complex input scalar data access struct. **Parameters**: - **data**: - pointer to the double-precision data. - **dataSize**: - data size. **Parameters**: - double \*const **data** - size\_t **dataSize** **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData) ### Function syscGetInputComplexScalarDataCompactFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexScalarData syscGetInputComplexScalarDataCompactFloat(float *const data, size_t dataSize) ``` Create a complex input scalar data access struct. **Parameters**: - **data**: - pointer to the single-precision data. - **dataSize**: - data size. **Parameters**: - float \*const **data** - size\_t **dataSize** **Return type**: [SyscInputComplexScalarData](structSyscInputComplexScalarData.md#structSyscInputComplexScalarData) ### Function syscGetInputComplexVectorData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputComplexVectorData() ``` Create an empty input complex vector data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointers will be set to null. **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputCompactComplexCompactVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputCompactComplexCompactVectorDataDouble(double *const data, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **data**: - pointer to the double-precision complex data. - **dataSize**: - data size. **Parameters**: - double \*const **data** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputCompactComplexCompactVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputCompactComplexCompactVectorDataFloat(float *const data, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **data**: - pointer to the single-precision complex data. - **dataSize**: - data size. **Parameters**: - float \*const **data** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputSplitComplexCompactVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputSplitComplexCompactVectorDataDouble(double *const dataReal, double *const dataImag, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **dataReal**: - pointer to the double-precision complex data (real components). - **dataImag**: - pointer to the double-precision complex data (imaginary components). - **dataSize**: - data size. **Parameters**: - double \*const **dataReal** - double \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputSplitComplexCompactVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputSplitComplexCompactVectorDataFloat(float *const dataReal, float *const dataImag, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **dataReal**: - pointer to the single-precision complex data (real components). - **dataImag**: - pointer to the single-precision complex data (imaginary components). - **dataSize**: - data size. **Parameters**: - float \*const **dataReal** - float \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputCompactComplexSplitVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputCompactComplexSplitVectorDataDouble(double *const data1, double *const data2, double *const data3, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **data1**: - pointer to the double-precision complex data (first component). - **data2**: - pointer to the double-precision complex data (second component). - **data3**: - pointer to the double-precision complex data (third component). - **dataSize**: - data size. **Parameters**: - double \*const **data1** - double \*const **data2** - double \*const **data3** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputCompactComplexSplitVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputCompactComplexSplitVectorDataFloat(float *const data1, float *const data2, float *const data3, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **data1**: - pointer to the single-precision complex data (first component). - **data2**: - pointer to the single-precision complex data (second component). - **data3**: - pointer to the single-precision complex data (third component). - **dataSize**: - data size. **Parameters**: - float \*const **data1** - float \*const **data2** - float \*const **data3** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputSplitComplexSplitVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputSplitComplexSplitVectorDataDouble(double *const data1Real, double *const data1Imag, double *const data2Real, double *const data2Imag, double *const data3Real, double *const data3Imag, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **data1Real**: - pointer to the double-precision complex data (first real component). - **data1Imag**: - pointer to the double-precision complex data (first imagindary component). - **data2Real**: - pointer to the double-precision complex data (second real component). - **data2Imag**: - pointer to the double-precision complex data (second imagindary component). - **data3Real**: - pointer to the double-precision complex data (third real component). - **data3Imag**: - pointer to the double-precision complex data (third imagindary component). - **dataSize**: - data size. **Parameters**: - double \*const **data1Real** - double \*const **data1Imag** - double \*const **data2Real** - double \*const **data2Imag** - double \*const **data3Real** - double \*const **data3Imag** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputSplitComplexSplitVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputSplitComplexSplitVectorDataFloat(float *const data1Real, float *const data1Imag, float *const data2Real, float *const data2Imag, float *const data3Real, float *const data3Imag, size_t dataSize) ``` Create a 3D complex input vector data access struct. **Parameters**: - **data1Real**: - pointer to the single-precision complex data (first real component). - **data1Imag**: - pointer to the single-precision complex data (first imagindary component). - **data2Real**: - pointer to the single-precision complex data (second real component). - **data2Imag**: - pointer to the single-precision complex data (second imagindary component). - **data3Real**: - pointer to the single-precision complex data (third real component). - **data3Imag**: - pointer to the single-precision complex data (third imagindary component). - **dataSize**: - data size. **Parameters**: - float \*const **data1Real** - float \*const **data1Imag** - float \*const **data2Real** - float \*const **data2Imag** - float \*const **data3Real** - float \*const **data3Imag** - size\_t **dataSize** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputCompactComplexCompactVectorDataDoubleDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputCompactComplexCompactVectorDataDoubleDim(double *const data, size_t dataSize, enum SyscDimension dimension) ``` Create a complex input vector data access struct based on dimension. **Parameters**: - **data**: - pointer to the double-precision complex data. - **dataSize**: - data size. - **dimension**: - dimension of complex vector data. **Parameters**: - double \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputCompactComplexCompactVectorDataFloatDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputComplexVectorData syscGetInputCompactComplexCompactVectorDataFloatDim(float *const data, size_t dataSize, enum SyscDimension dimension) ``` Create a complex input vector data access struct based on dimension. **Parameters**: - **data**: - pointer to the single-precision complex data. - **dataSize**: - data size. - **dimension**: - dimension of complex vector data. **Parameters**: - float \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscInputComplexVectorData](structSyscInputComplexVectorData.md#structSyscInputComplexVectorData) ### Function syscGetInputScalarData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputScalarData syscGetInputScalarData() ``` Create an input scalar data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointer will be set to null. **Return type**: [SyscInputScalarData](structSyscInputScalarData.md#structSyscInputScalarData) ### Function syscGetInputScalarDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputScalarData syscGetInputScalarDataDouble(double *const data, size_t dataSize) ``` Create an input scalar data access struct. **Parameters**: - **data**: - pointer to the double-precision (64-bit) array of data. - **dataSize**: - number of elements in the array. **Parameters**: - double \*const **data** - size\_t **dataSize** **Return type**: [SyscInputScalarData](structSyscInputScalarData.md#structSyscInputScalarData) ### Function syscGetInputScalarDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputScalarData syscGetInputScalarDataFloat(float *const data, size_t dataSize) ``` Create an input scalar data access struct. **Parameters**: - **data**: - pointer to the single-precision (32-bit) array of data. - **dataSize**: - number of elements in the array. **Parameters**: - float \*const **data** - size\_t **dataSize** **Return type**: [SyscInputScalarData](structSyscInputScalarData.md#structSyscInputScalarData) ### Function syscGetInputVectorData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorData() ``` Create an input vector data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointers will be set to null. **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInputVectorDataCompactDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorDataCompactDouble(double *const data, size_t dataSize) ``` Create an 3D input vector data access struct with compact storage. **Parameters**: - **data**: - pointer to the array of double-precision data - **dataSize**: - number of vectors. **Parameters**: - double \*const **data** - size\_t **dataSize** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInputVectorDataCompactFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorDataCompactFloat(float *const data, size_t dataSize) ``` Create an 3D input vector data access struct with compact storage. **Parameters**: - **data**: - pointer to the array of single-precision data - **dataSize**: - number of vectors. **Parameters**: - float \*const **data** - size\_t **dataSize** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInputVectorDataSplitDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorDataSplitDouble(double *const data0, double *const data1, double *const data2, size_t dataSize) ``` Create an 3D input vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of double-precision data - **data1**: - pointer to the second array of double-precision data - **data2**: - pointer to the third array of double-precision data - **dataSize**: - number of vectors. **Parameters**: - double \*const **data0** - double \*const **data1** - double \*const **data2** - size\_t **dataSize** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInputVectorDataSplitFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorDataSplitFloat(float *const data0, float *const data1, float *const data2, size_t dataSize) ``` Create an 3D input vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of single-precision data - **data1**: - pointer to the second array of single-precision data - **data2**: - pointer to the third array of single-precision data - **dataSize**: - number of vectors. **Parameters**: - float \*const **data0** - float \*const **data1** - float \*const **data2** - size\_t **dataSize** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInputVectorDataCompactDoubleDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorDataCompactDoubleDim(double *const data, size_t dataSize, enum SyscDimension dimension) ``` Create an input vector data access struct with compact storage based on dimension. **Parameters**: - **data**: - pointer to the array of double-precision data - **dataSize**: - number of vectors. - **dimension**: - dimension of complex vector data. **Parameters**: - double \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInputVectorDataCompactFloatDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInputVectorDataCompactFloatDim(float *const data, size_t dataSize, enum SyscDimension dimension) ``` Create an input vector data access struct with compact storage based on dimension. **Parameters**: - **data**: - pointer to the array of single-precision data - **dataSize**: - number of vectors. - **dimension**: - dimension of complex vector data. **Parameters**: - float \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInput2DVectorDataSplitDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInput2DVectorDataSplitDouble(double *const data0, double *const data1, size_t dataSize) ``` Create an 2D input vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of double-precision data - **data1**: - pointer to the second array of double-precision data - **dataSize**: - number of vectors. **Parameters**: - double \*const **data0** - double \*const **data1** - size\_t **dataSize** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetInput2DVectorDataSplitFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscInputVectorData syscGetInput2DVectorDataSplitFloat(float *const data0, float *const data1, size_t dataSize) ``` Create an 2D input vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of single-precision data - **data1**: - pointer to the second array of single-precision data - **dataSize**: - number of vectors. **Parameters**: - float \*const **data0** - float \*const **data1** - size\_t **dataSize** **Return type**: [SyscInputVectorData](structSyscInputVectorData.md#structSyscInputVectorData) ### Function syscGetNodeData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscNodeData syscGetNodeData() ``` Create a mesh node data access struct. Returns an empty mesh node data access struct. All member will be assigned default values. **Return type**: [SyscNodeData](structSyscNodeData.md#structSyscNodeData) ### Function syscGetNodeDataIC ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscNodeData syscGetNodeDataIC(SyscOutputIntegerData nodeIds, SyscOutputVectorData nodeCoords) ``` Create a mesh node data access struct, given node ids and node coords in same order. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **nodeIds** - [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) **nodeCoords** **Return type**: [SyscNodeData](structSyscNodeData.md#structSyscNodeData) ### Function syscGetNodeDataC ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscNodeData syscGetNodeDataC(SyscOutputVectorData nodeCoords) ``` Creates a mesh node data access struct, given node coordinates in ascending node ids order. **Parameters**: - [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) **nodeCoords** **Return type**: [SyscNodeData](structSyscNodeData.md#structSyscNodeData) ### Function syscGetElementTypeDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementTypeData syscGetElementTypeDataEmpty() ``` Create an empty mesh element type data access struct. Returns an empty mesh element type data access struct. All member will be assigned default values. **Return type**: [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) ### Function syscGetElementTypeData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementTypeData syscGetElementTypeData(SyscOutputIntegerData elemTypes) ``` Create an mesh element type data access struct, given element types. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **elemTypes** **Return type**: [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) ### Function syscGetElementNodeCountDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementNodeCountData syscGetElementNodeCountDataEmpty() ``` Create an empty mesh element node count data access struct. Returns an empty mesh element node count data access struct. All member will be assigned default values. **Return type**: [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) ### Function syscGetElementNodeCountData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementNodeCountData syscGetElementNodeCountData(SyscOutputIntegerData elemNodeCount) ``` Create an mesh element node count data access struct, given element node counts. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **elemNodeCount** **Return type**: [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) ### Function syscGetElementNodeConnectivityDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementNodeConnectivityData syscGetElementNodeConnectivityDataEmpty() ``` Create an empty element-to-node connectivity data access struct. Returns an empty element-to-node connectivity data access struct. All member will be assigned default values. **Return type**: [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) ### Function syscGetElementNodeConnectivityData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementNodeConnectivityData syscGetElementNodeConnectivityData(SyscOutputIntegerData elemNodeIds) ``` Create an element-to-node connectivity data access struct, given element node ids. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **elemNodeIds** **Return type**: [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) ### Function syscGetFaceCellConnectivityDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceCellConnectivityData syscGetFaceCellConnectivityDataEmpty() ``` Create empty face-to-cell connectivity. **Return type**: [SyscFaceCellConnectivityData](structSyscFaceCellConnectivityData.md#structSyscFaceCellConnectivityData) ### Function syscGetFaceCellConnectivityData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceCellConnectivityData syscGetFaceCellConnectivityData(SyscOutputIntegerData cell0Ids, SyscOutputIntegerData cell1Ids) ``` Create face-to-cell connectivity given cell0 and cell1 arrays. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **cell0Ids** - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **cell1Ids** **Return type**: [SyscFaceCellConnectivityData](structSyscFaceCellConnectivityData.md#structSyscFaceCellConnectivityData) ### Function syscGetCellIdDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCellIdData syscGetCellIdDataEmpty() ``` Create empty cell id data. **Return type**: [SyscCellIdData](structSyscCellIdData.md#structSyscCellIdData) ### Function syscGetCellIdData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCellIdData syscGetCellIdData(SyscOutputIntegerData cellIds) ``` Create cell id data given cell ids array. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **cellIds** **Return type**: [SyscCellIdData](structSyscCellIdData.md#structSyscCellIdData) ### Function syscGetElementIdDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementIdData syscGetElementIdDataEmpty() ``` Create empty element id data. **Return type**: [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) ### Function syscGetElementIdData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscElementIdData syscGetElementIdData(SyscOutputIntegerData elementIds) ``` Create cell id data given cell ids array. **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **elementIds** **Return type**: [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) ### Function syscGetFaceDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceData syscGetFaceDataEmpty() ``` Create empty face data. **Return type**: [SyscFaceData](structSyscFaceData.md#structSyscFaceData) ### Function syscGetFaceDataITCNF ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceData syscGetFaceDataITCNF(SyscElementIdData faceIds, SyscElementTypeData faceTypes, SyscElementNodeCountData faceNodeCounts, SyscElementNodeConnectivityData faceNodeConnectivity, SyscFaceCellConnectivityData faceCellConnectivity) ``` Create face data given face ids, types, node counts, node-to-face connectivity, face-to-cell connectivity. **Parameters**: - [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) **faceIds** - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **faceTypes** - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **faceNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **faceNodeConnectivity** - [SyscFaceCellConnectivityData](structSyscFaceCellConnectivityData.md#structSyscFaceCellConnectivityData) **faceCellConnectivity** **Return type**: [SyscFaceData](structSyscFaceData.md#structSyscFaceData) ### Function syscGetFaceDataICNF ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceData syscGetFaceDataICNF(SyscElementIdData faceIds, SyscElementNodeCountData faceNodeCounts, SyscElementNodeConnectivityData faceNodeConnectivity, SyscFaceCellConnectivityData faceCellConnectivity) ``` Create face data given face ids, types, node-to-face connectivity, face-to-cell connectivity. **Parameters**: - [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) **faceIds** - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **faceNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **faceNodeConnectivity** - [SyscFaceCellConnectivityData](structSyscFaceCellConnectivityData.md#structSyscFaceCellConnectivityData) **faceCellConnectivity** **Return type**: [SyscFaceData](structSyscFaceData.md#structSyscFaceData) ### Function syscGetFaceDataITN ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceData syscGetFaceDataITN(SyscElementIdData faceIds, SyscElementTypeData faceTypes, SyscElementNodeConnectivityData faceNodeConnectivity) ``` Create face data given face ids, types, node-to-face connectivity, face-to-cell connectivity. **Parameters**: - [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) **faceIds** - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **faceTypes** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **faceNodeConnectivity** **Return type**: [SyscFaceData](structSyscFaceData.md#structSyscFaceData) ### Function syscGetFaceDataCN ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscFaceData syscGetFaceDataCN(SyscElementNodeCountData faceNodeCounts, SyscElementNodeConnectivityData faceNodeConnectivity) ``` Create face data given face node counts, node-to-face connectivity. **Parameters**: - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **faceNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **faceNodeConnectivity** **Return type**: [SyscFaceData](structSyscFaceData.md#structSyscFaceData) ### Function syscGetCellDataEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCellData syscGetCellDataEmpty() ``` Create empty cell data. **Return type**: [SyscCellData](structSyscCellData.md#structSyscCellData) ### Function syscGetCellDataITN ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCellData syscGetCellDataITN(SyscElementIdData cellIds, SyscElementTypeData cellTypes, SyscElementNodeConnectivityData cellNodeConnectivity) ``` Create cell data given cell ids, types, cell-to-node connectivity. **Parameters**: - [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) **cellIds** - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **cellTypes** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **cellNodeConnectivity** **Return type**: [SyscCellData](structSyscCellData.md#structSyscCellData) ### Function syscGetCellDataI ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCellData syscGetCellDataI(SyscElementIdData cellIds) ``` Create cell data given cell ids. **Parameters**: - [SyscElementIdData](structSyscElementIdData.md#structSyscElementIdData) **cellIds** **Return type**: [SyscCellData](structSyscCellData.md#structSyscCellData) ### Function syscGetCellDataTN ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCellData syscGetCellDataTN(SyscElementTypeData cellTypes, SyscElementNodeConnectivityData cellNodeConnectivity) ``` Create cell data given cell types, cell-to-node connectivity. **Parameters**: - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **cellTypes** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **cellNodeConnectivity** **Return type**: [SyscCellData](structSyscCellData.md#structSyscCellData) ### Function syscGetOutputComplexScalarData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexScalarData syscGetOutputComplexScalarData() ``` Create an empty output complex scalar data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointers will be set to null. **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData) ### Function syscGetOutputComplexScalarDataSplitDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexScalarData syscGetOutputComplexScalarDataSplitDouble(const double *const dataReal, const double *const dataImag, size_t dataSize) ``` Create a complex output scalar data access struct. **Parameters**: - **dataReal**: - pointer to the double-precision real data component. - **dataImag**: - pointer to the double-precision imaginary data component. - **dataSize**: - data size. **Parameters**: - const double \*const **dataReal** - const double \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData) ### Function syscGetOutputComplexScalarDataSplitFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexScalarData syscGetOutputComplexScalarDataSplitFloat(const float *const dataReal, const float *const dataImag, size_t dataSize) ``` Create a complex output scalar data access struct. **Parameters**: - **dataReal**: - pointer to the single-precision real data component. - **dataImag**: - pointer to the single-precision imaginary data component. - **dataSize**: - data size. **Parameters**: - const float \*const **dataReal** - const float \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData) ### Function syscGetOutputComplexScalarDataCompactDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexScalarData syscGetOutputComplexScalarDataCompactDouble(const double *const data, size_t dataSize) ``` Create a complex output scalar data access struct. **Parameters**: - **data**: - pointer to the double-precision data. - **dataSize**: - data size. **Parameters**: - const double \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData) ### Function syscGetOutputComplexScalarDataCompactFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexScalarData syscGetOutputComplexScalarDataCompactFloat(const float *const data, size_t dataSize) ``` Create a complex output scalar data access struct. **Parameters**: - **data**: - pointer to the single-precision data. - **dataSize**: - data size. **Parameters**: - const float \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputComplexScalarData](structSyscOutputComplexScalarData.md#structSyscOutputComplexScalarData) ### Function syscGetOutputComplexVectorData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputComplexVectorData() ``` Create an empty output complex vector data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointers will be set to null. **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputCompactComplexCompactVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputCompactComplexCompactVectorDataDouble(const double *const data, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **data**: - pointer to the double-precision complex data. - **dataSize**: - data size. **Parameters**: - const double \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputCompactComplexCompactVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputCompactComplexCompactVectorDataFloat(const float *const data, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **data**: - pointer to the single-precision complex data. - **dataSize**: - data size. **Parameters**: - const float \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputSplitComplexCompactVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputSplitComplexCompactVectorDataDouble(const double *const dataReal, const double *const dataImag, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **dataReal**: - pointer to the double-precision complex data (real components). - **dataImag**: - pointer to the double-precision complex data (imaginary components). - **dataSize**: - data size. **Parameters**: - const double \*const **dataReal** - const double \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputSplitComplexCompactVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputSplitComplexCompactVectorDataFloat(const float *const dataReal, const float *const dataImag, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **dataReal**: - pointer to the single-precision complex data (real components). - **dataImag**: - pointer to the single-precision complex data (imaginary components). - **dataSize**: - data size. **Parameters**: - const float \*const **dataReal** - const float \*const **dataImag** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputCompactComplexSplitVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputCompactComplexSplitVectorDataDouble(const double *const data1, const double *const data2, const double *const data3, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **data1**: - pointer to the double-precision complex data (first component). - **data2**: - pointer to the double-precision complex data (second component). - **data3**: - pointer to the double-precision complex data (third component). - **dataSize**: - data size. **Parameters**: - const double \*const **data1** - const double \*const **data2** - const double \*const **data3** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputCompactComplexSplitVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputCompactComplexSplitVectorDataFloat(const float *const data1, const float *const data2, const float *const data3, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **data1**: - pointer to the single-precision complex data (first component). - **data2**: - pointer to the single-precision complex data (second component). - **data3**: - pointer to the single-precision complex data (third component). - **dataSize**: - data size. **Parameters**: - const float \*const **data1** - const float \*const **data2** - const float \*const **data3** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputSplitComplexSplitVectorDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputSplitComplexSplitVectorDataDouble(const double *const data1Real, const double *const data1Imag, const double *const data2Real, const double *const data2Imag, const double *const data3Real, const double *const data3Imag, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **data1Real**: - pointer to the double-precision complex data (first real component). - **data1Imag**: - pointer to the double-precision complex data (first imagindary component). - **data2Real**: - pointer to the double-precision complex data (second real component). - **data2Imag**: - pointer to the double-precision complex data (second imagindary component). - **data3Real**: - pointer to the double-precision complex data (third real component). - **data3Imag**: - pointer to the double-precision complex data (third imagindary component). - **dataSize**: - data size. **Parameters**: - const double \*const **data1Real** - const double \*const **data1Imag** - const double \*const **data2Real** - const double \*const **data2Imag** - const double \*const **data3Real** - const double \*const **data3Imag** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputSplitComplexSplitVectorDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputSplitComplexSplitVectorDataFloat(const float *const data1Real, const float *const data1Imag, const float *const data2Real, const float *const data2Imag, const float *const data3Real, const float *const data3Imag, size_t dataSize) ``` Create a 3D complex output vector data access struct. **Parameters**: - **data1Real**: - pointer to the single-precision complex data (first real component). - **data1Imag**: - pointer to the single-precision complex data (first imagindary component). - **data2Real**: - pointer to the single-precision complex data (second real component). - **data2Imag**: - pointer to the single-precision complex data (second imagindary component). - **data3Real**: - pointer to the single-precision complex data (third real component). - **data3Imag**: - pointer to the single-precision complex data (third imagindary component). - **dataSize**: - data size. **Parameters**: - const float \*const **data1Real** - const float \*const **data1Imag** - const float \*const **data2Real** - const float \*const **data2Imag** - const float \*const **data3Real** - const float \*const **data3Imag** - size\_t **dataSize** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputCompactComplexCompactVectorDataDoubleDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputCompactComplexCompactVectorDataDoubleDim(const double *const data, size_t dataSize, enum SyscDimension dimension) ``` Create a complex output vector data access struct based on dimension. **Parameters**: - **data**: - pointer to the double-precision complex data. - **dataSize**: - data size. - **dimension**: - dimension of complex vector data. **Parameters**: - const double \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputCompactComplexCompactVectorDataFloatDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputComplexVectorData syscGetOutputCompactComplexCompactVectorDataFloatDim(const float *const data, size_t dataSize, enum SyscDimension dimension) ``` Create a complex output vector data access struct based on dimension. **Parameters**: - **data**: - pointer to the single-precision complex data. - **dataSize**: - data size. - **dimension**: - dimension of complex vector data. **Parameters**: - const float \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscOutputComplexVectorData](structSyscOutputComplexVectorData.md#structSyscOutputComplexVectorData) ### Function syscGetOutputIntegerData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputIntegerData syscGetOutputIntegerData() ``` Create an output integer data access struct. Primitive type will default to 64-bit signed integer. Data size will be set to zero. Data pointer will be set to null. **Return type**: [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) ### Function syscGetOutputIntegerDataInt32 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputIntegerData syscGetOutputIntegerDataInt32(const int32_t *const data, size_t dataSize) ``` Create an output integer data access struct. **Parameters**: - **data**: - pointer to the signed (32-bit) array of data. - **dataSize**: - number of elements in the array. **Parameters**: - const int32\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) ### Function syscGetOutputIntegerDataInt64 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputIntegerData syscGetOutputIntegerDataInt64(const int64_t *const data, size_t dataSize) ``` Create an output integer data access struct. **Parameters**: - **data**: - pointer to the 64-bit array of integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const int64\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) ### Function syscGetOutputIntegerDataUInt16 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputIntegerData syscGetOutputIntegerDataUInt16(const uint16_t *const data, size_t dataSize) ``` Create an output integer data access struct. **Parameters**: - **data**: - pointer to the 16-bit array of unsigned integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const uint16\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) ### Function syscGetOutputIntegerDataUInt64 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputIntegerData syscGetOutputIntegerDataUInt64(const uint64_t *const data, size_t dataSize) ``` Create an output integer data access struct. **Parameters**: - **data**: - pointer to the 64-bit array of unsigned integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const uint64\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) ### Function syscGetOutputScalarData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarData() ``` Create an output scalar data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointer will be set to null. **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputScalarDataDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarDataDouble(const double *const data, size_t dataSize) ``` Create an output scalar data access struct. **Parameters**: - **data**: - pointer to the double-precision (64-bit) array of data. - **dataSize**: - number of elements in the array. **Parameters**: - const double \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputScalarDataFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarDataFloat(const float *const data, size_t dataSize) ``` Create an output scalar data access struct. **Parameters**: - **data**: - pointer to the single-precision (32-bit) array of data. - **dataSize**: - number of elements in the array. **Parameters**: - const float \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputScalarDataInt32 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarDataInt32(const int32_t *const data, size_t dataSize) ``` Create an output scalar data access struct. **Parameters**: - **data**: - pointer to the 32-bit array of integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const int32\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputScalarDataInt64 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarDataInt64(const int64_t *const data, size_t dataSize) ``` Create an output scalar data access struct. **Parameters**: - **data**: - pointer to the 64-bit array of integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const int64\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputScalarDataUInt16 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarDataUInt16(const uint16_t *const data, size_t dataSize) ``` Create an output scalar data access struct. **Parameters**: - **data**: - pointer to the 16-bit array of unsigned integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const uint16\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputScalarDataUInt64 ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputScalarData syscGetOutputScalarDataUInt64(const uint64_t *const data, size_t dataSize) ``` Create an output scalar data access struct. **Parameters**: - **data**: - pointer to the 64-bit array of unsigned integer data. - **dataSize**: - number of elements in the array. **Parameters**: - const uint64\_t \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) ### Function syscGetOutputVectorData ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorData() ``` Create an output vector data access struct. Primitive type will default to double-precision. Data size will be set to zero. Data pointers will be set to null. **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutputVectorDataCompactDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorDataCompactDouble(const double *const data, size_t dataSize) ``` Create an 3D output vector data access struct with compact storage. **Parameters**: - **data**: - pointer to the array of double-precision data - **dataSize**: - number of vectors. **Parameters**: - const double \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutputVectorDataCompactFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorDataCompactFloat(const float *const data, size_t dataSize) ``` Create an 3D output vector data access struct with compact storage. **Parameters**: - **data**: - pointer to the array of single-precision data - **dataSize**: - number of vectors. **Parameters**: - const float \*const **data** - size\_t **dataSize** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutputVectorDataSplitDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorDataSplitDouble(const double *const data0, const double *const data1, const double *const data2, size_t dataSize) ``` Create an 3D output vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of double-precision data - **data1**: - pointer to the second array of double-precision data - **data2**: - pointer to the third array of double-precision data - **dataSize**: - number of vectors. **Parameters**: - const double \*const **data0** - const double \*const **data1** - const double \*const **data2** - size\_t **dataSize** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutputVectorDataSplitFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorDataSplitFloat(const float *const data0, const float *const data1, const float *const data2, size_t dataSize) ``` Create an 3D output vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of single-precision data - **data1**: - pointer to the second array of single-precision data - **data2**: - pointer to the third array of single-precision data - **dataSize**: - number of vectors. **Parameters**: - const float \*const **data0** - const float \*const **data1** - const float \*const **data2** - size\_t **dataSize** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutputVectorDataCompactDoubleDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorDataCompactDoubleDim(const double *const data, size_t dataSize, enum SyscDimension dimension) ``` Create an output vector data access struct with compact storage based on dimension. **Parameters**: - **data**: - pointer to the array of double-precision data - **dataSize**: - number of vectors. - **dimension**: - dimension of complex vector data. **Parameters**: - const double \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutputVectorDataCompactFloatDim ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutputVectorDataCompactFloatDim(const float *const data, size_t dataSize, enum SyscDimension dimension) ``` Create an output vector data access struct with compact storage based on dimension. **Parameters**: - **data**: - pointer to the array of single-precision data - **dataSize**: - number of vectors. - **dimension**: - dimension of complex vector data. **Parameters**: - const float \*const **data** - size\_t **dataSize** - enum [SyscDimension](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac5a5f66ee72fd8015eab632a642cf26d) **dimension** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutput2DVectorDataSplitDouble ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutput2DVectorDataSplitDouble(const double *const data0, const double *const data1, size_t dataSize) ``` Create a 2D output vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of double-precision data - **data1**: - pointer to the second array of double-precision data - **dataSize**: - number of vectors. **Parameters**: - const double \*const **data0** - const double \*const **data1** - size\_t **dataSize** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetOutput2DVectorDataSplitFloat ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscOutputVectorData syscGetOutput2DVectorDataSplitFloat(const float *const data0, const float *const data1, size_t dataSize) ``` Create an output vector data access struct with split storage. **Parameters**: - **data0**: - pointer to the first array of single-precision data - **data1**: - pointer to the second array of single-precision data - **dataSize**: - number of vectors. **Parameters**: - const float \*const **data0** - const float \*const **data1** - size\_t **dataSize** **Return type**: [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) ### Function syscGetParameter ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscParameter syscGetParameter(const char *name) ``` Create parameter to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this parameter. String length should not exceed SYSC\_STRING\_LENGTH. Display name will default to the same as name. **Parameters**: - const char \* **name** **Return type**: [SyscParameter](structSyscParameter.md#structSyscParameter) ### Function syscGetParameterD ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscParameter syscGetParameterD(const char *name, const char *displayName) ``` Create parameter to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this parameter. String length should not exceed SYSC\_STRING\_LENGTH. - **displayName**: - parameter display name. String length should not exceed SYSC\_STRING\_LENGTH. **Parameters**: - const char \* **name** - const char \* **displayName** **Return type**: [SyscParameter](structSyscParameter.md#structSyscParameter) ### Function syscGetPointCloudEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscPointCloud syscGetPointCloudEmpty() ``` Create a point cloud access struct. Returns a struct representing empty point cloud. All member will be assigned default values. **Return type**: [SyscPointCloud](structSyscPointCloud.md#structSyscPointCloud) ### Function syscGetPointCloud ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscPointCloud syscGetPointCloud(SyscOutputIntegerData nodeIds, SyscOutputVectorData nodeCoords) ``` Create a point cloud access struct. **Parameters**: - **nodeIds**: - output integer data access for node ids - **nodeCoords**: - output vector data access for node coordinates, provided in the same order as node ids **Parameters**: - [SyscOutputIntegerData](structSyscOutputIntegerData.md#structSyscOutputIntegerData) **nodeIds** - [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) **nodeCoords** **Return type**: [SyscPointCloud](structSyscPointCloud.md#structSyscPointCloud) ### Function syscGetRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscGetRegion(const char *name) ``` Create region to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this region. String length should not exceed SYSC\_STRING\_LENGTH. Display name will default to the same as name. Topology will default to surface. Region mesh type will default to mesh. **Parameters**: - const char \* **name** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscGetRegionT ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscGetRegionT(const char *name, enum SyscTopology topology) ``` Create region to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this region. String length should not exceed SYSC\_STRING\_LENGTH. - **topology**: - region topology. Display name will default to the same as name. Region mesh type will default to mesh. **Parameters**: - const char \* **name** - enum [SyscTopology](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gabf36499a0f333dc9b856c4bcbb25385a) **topology** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscGetRegionDT ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscGetRegionDT(const char *name, const char *displayName, enum SyscTopology topology) ``` Create region to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this region. String length should not exceed SYSC\_STRING\_LENGTH. - **displayName**: - region display name. String length should not exceed SYSC\_STRING\_LENGTH. - **topology**: - region topology. Region mesh type will default to mesh. **Parameters**: - const char \* **name** - const char \* **displayName** - enum [SyscTopology](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gabf36499a0f333dc9b856c4bcbb25385a) **topology** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscGetRegionTM ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscGetRegionTM(const char *name, enum SyscTopology topology, enum SyscRegionDiscretizationType regionDiscretizationType) ``` Create region to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this region. String length should not exceed SYSC\_STRING\_LENGTH. - **topology**: - region topology. - **regionDiscretizationType**: - region mesh type. Display names will be same as name. **Parameters**: - const char \* **name** - enum [SyscTopology](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gabf36499a0f333dc9b856c4bcbb25385a) **topology** - enum [SyscRegionDiscretizationType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga83942e23c7ff51ec76e4632612a34d45) **regionDiscretizationType** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscGetRegionDTM ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscGetRegionDTM(const char *name, const char *displayName, enum SyscTopology topology, enum SyscRegionDiscretizationType regionDiscretizationType) ``` Create region to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this region. String length should not exceed SYSC\_STRING\_LENGTH. - **displayName**: - region display name. String length should not exceed SYSC\_STRING\_LENGTH. - **topology**: - region topology. - **regionDiscretizationType**: - region mesh type. **Parameters**: - const char \* **name** - const char \* **displayName** - enum [SyscTopology](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gabf36499a0f333dc9b856c4bcbb25385a) **topology** - enum [SyscRegionDiscretizationType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga83942e23c7ff51ec76e4632612a34d45) **regionDiscretizationType** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscAddInputVariable ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddInputVariable(const SyscRegion region, const SyscVariable variable) ``` Provide a function to add an input variable to the region. If this variable has already been added to the region as an input variable, then this call will have no effect. If a different variable with the same name has already been added to the region as an input variable, then an error will be returned. If a variable with the same name has already been added to the region as an output variable, then an error will be returned. If the variable name contains invalid characters, then an error will be returned. If the region discretization type is point cloud, then the location of the variable added to this region is insignificant. **Parameters**: - **region**: Region to which the input variable is to be added. - **variable**: Variable whose values are provided by System Coupling and consumed by the participant. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** - const [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddOutputVariable ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddOutputVariable(const SyscRegion region, const SyscVariable variable) ``` Provide a function to add an output variable to the region. If this variable has already been added to the region as an output variable, then this call will have no effect. If a different variable with the same name has already been added to the region as an output variable, then an error will be returned. If a variable with the same name has already been added to the region as an input variable, then an error will be returned. If the variable name contains invalid characters, then an error will be returned. If the region discretization type is point cloud, then the location of the variable added to this region is insignificant. **Parameters**: - **region**: Region to which the output variable is to be added. - **variable**: Variable whose values are consumed by System Coupling and provided by the participant. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** - const [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscGetNumInputVariables ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumInputVariables(const SyscRegion region) ``` Provide a function to return the number of input variables. **Parameters**: - **region**: - region **Returns**: Number of input variables for the region. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** **Return type**: size\_t ### Function syscGetInputVariable ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetInputVariable(const SyscRegion region, size_t index) ``` Return an input variable. **Parameters**: - **region**: - region - **index**: - region index **Returns**: Variable at specified index. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** - size\_t **index** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscGetNumOutputVariables ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumOutputVariables(const SyscRegion region) ``` Provide a function to return the number of output variables. **Parameters**: - **region**: - region **Returns**: Number of output variables for the region. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** **Return type**: size\_t ### Function syscGetOutputVariable ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetOutputVariable(const SyscRegion region, size_t index) ``` Return an output variable. **Parameters**: - **region**: - region - **index**: - region index **Returns**: Variable at specified index. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** - size\_t **index** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscGetSurfaceMesh ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMesh() ``` Create a surface mesh access struct. Returns a struct representing empty surface mesh. All member will be assigned default values. **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshNF ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshNF(SyscNodeData nodes, SyscFaceData faces) ``` Create a surface mesh access struct. **Parameters**: - **nodes**: - node data - **faces**: - face data **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscFaceData](structSyscFaceData.md#structSyscFaceData) **faces** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshNTCI ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshNTCI(SyscNodeData nodes, SyscElementTypeData elemTypes, SyscElementNodeCountData elemNodeCounts, SyscElementNodeConnectivityData elemNodeConnectivity) ``` Create a surface mesh access struct. Both element types and element node counts are provided. **Parameters**: - **nodes**: - mesh nodes - **elemTypes**: - element types - **elemNodeCounts**: - element node counts - **elemNodeConnectivity**: - element-to-node connectivity **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **elemTypes** - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **elemNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **elemNodeConnectivity** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshNCI ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshNCI(SyscNodeData nodes, SyscElementNodeCountData elemNodeCounts, SyscElementNodeConnectivityData elemNodeConnectivity) ``` Create a surface mesh access struct. Element node counts are provided, element types are deduced from element node counts. **Parameters**: - **nodes**: - mesh nodes - **elemNodeCounts**: - element node counts - **elemNodeConnectivity**: - element-to-node connectivity **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **elemNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **elemNodeConnectivity** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshNCIF ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshNCIF(SyscNodeData nodes, SyscElementNodeCountData elemNodeCounts, SyscElementNodeConnectivityData elemNodeConnectivity, SyscFaceCellConnectivityData faceCellConnectivty) ``` Create a surface mesh access struct. Element node counts are provided, element types are deduced from element node counts. Face-to-cell connectivity is provided as well. **Parameters**: - **nodes**: - mesh nodes - **elemNodeCounts**: - element node counts - **elemNodeConnectivity**: - element-to-node connectivity - **faceCellConnectivity**: - face-to-cell connectivity **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **elemNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **elemNodeConnectivity** - [SyscFaceCellConnectivityData](structSyscFaceCellConnectivityData.md#structSyscFaceCellConnectivityData) **faceCellConnectivty** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshNTI ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshNTI(SyscNodeData nodes, SyscElementTypeData elemTypes, SyscElementNodeConnectivityData elemNodeConnectivity) ``` Create a surface mesh access struct. Element types are provided, element node counts are deduced from element types. **Parameters**: - **nodes**: - mesh nodes - **elemTypes**: - element types - **elemNodeConnectivity**: - element-to-node connectivity **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **elemTypes** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **elemNodeConnectivity** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshA ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshA(SyscOutputScalarData nodeIds, SyscOutputVectorData nodeCoords, SyscOutputScalarData elemNodeCounts, SyscOutputScalarData elemNodeIds) ``` Create a surface mesh access struct. Note: this function is deprecated. Use syscGetSurfaceMeshNCI instead. **Parameters**: - **nodeIds**: - output scalar data access for node ids - **nodeCoords**: - output vector data access for node coordinates, provided in the same order as node ids - **elemNodeCounts**: - output scalar data access for element node counts - **elemNodeIds**: - output scalar data access for element node ids **Parameters**: - [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) **nodeIds** - [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) **nodeCoords** - [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) **elemNodeCounts** - [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) **elemNodeIds** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscGetSurfaceMeshB ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSurfaceMesh syscGetSurfaceMeshB(SyscOutputVectorData nodeCoords, SyscOutputScalarData elemNodeCounts, SyscOutputScalarData elemNodeIds) ``` Create a surface mesh access struct. Note: this function is deprecated. Use syscGetSurfaceMeshNCI instead. **Parameters**: - **nodeCoords**: - output vector data access for node coordinates, provided in ascending node ids order - **elemNodeCounts**: - output scalar data access for element node counts - **elemNodeIds**: - output scalar data access for element node ids **Parameters**: - [SyscOutputVectorData](structSyscOutputVectorData.md#structSyscOutputVectorData) **nodeCoords** - [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) **elemNodeCounts** - [SyscOutputScalarData](structSyscOutputScalarData.md#structSyscOutputScalarData) **elemNodeIds** **Return type**: [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) ### Function syscStartStandaloneParallel ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscStartStandaloneParallel(const size_t mpiCommunicator) ``` Provide a function to start standalone mode in parallel. **Parameters**: - **mpiCommunicator**: MPI communicator cast to size\_t. This will initialize the participant library in standalone mode and will use the provided MPI communicator for all parallel communication. Note that if the MPI communicator is MPI\_COMM\_WORLD, then it is not necessary to call this function. **Parameters**: - const size\_t **mpiCommunicator** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscConnect ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscConnect(const char *scHost, const unsigned short scPort, const char *participantName, const char *buildInformation) ``` Provide a function to establish connection to System Coupling. A participant must have obtained the host and port information from System Coupling prior to calling this function (e.g. via an input argument when participant application was started). **Parameters**: - **scHost**: Name of the host on which System Coupling is running. - **scPort**: Port number on which System Coupling is listening for participant connections. - **participantName**: Name of this participant (e.g. "MAPDL-1"). - **buildInformation**: Information about the build of this participant solver. **Returns**: [SyscError](structSyscError.md#structSyscError) Can be checked for any errors. **Parameters**: - const char \* **scHost** - const unsigned short **scPort** - const char \* **participantName** - const char \* **buildInformation** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscConnectParallel ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscConnectParallel(const char *scHost, const unsigned short scPort, const char *participantName, const size_t communicator, const char *buildInformation) ``` Provide a function to establish connection to System Coupling in parallel. This function is an alternative to syscConnect function. It works the same way as syscConnect, but it takes in one additional argument, which is the MPI communicator, cast as size\_t. Note that if the MPI communicator is MPI\_COMM\_WORLD, then it is not necessary to call this function and [syscConnect()](syscSystemCoupling_8h.md#group__SyscParticipantLibraryCAPI_1ga1404ad75fb1f5b1515dae967b71b1725) can be used instead. **Parameters**: - const char \* **scHost** - const unsigned short **scPort** - const char \* **participantName** - const size\_t **communicator** - const char \* **buildInformation** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscConnectUseStruct ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscConnectUseStruct(SyscParticipantInfo participantInfo) ``` Provide a function to establish connection to System Coupling in serial using a C structure. **Parameters**: - **participantInfo**: A C structure containing the participant attributes **Returns**: [SyscError](structSyscError.md#structSyscError) **Parameters**: - [SyscParticipantInfo](structSyscParticipantInfo.md#structSyscParticipantInfo) **participantInfo** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscConnectParallelUseStruct ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscConnectParallelUseStruct(SyscParticipantInfo participantInfo, const size_t communicator) ``` Provide a function to establish connection to System Coupling in parallel using a C structure. **Parameters**: - **participantInfo**: A C structure containing the participant attributes - **communicator**: A size\_t flag signifying what mode to run in parallel with. **Returns**: [SyscError](structSyscError.md#structSyscError) **Parameters**: - [SyscParticipantInfo](structSyscParticipantInfo.md#structSyscParticipantInfo) **participantInfo** - const size\_t **communicator** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddRegion(const SyscRegion region) ``` Provide a function to add a region that could be used in a coupled analysis. If this region has already been added, then this call will have no effect. If a different region with the same has already been added, then an error will be returned. If the region name contains invalid characters, then a runtime error will be thrown. **Parameters**: - const [SyscRegion](structSyscRegion.md#structSyscRegion) **region** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddInputParameter ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddInputParameter(const SyscParameter parameter) ``` Provide a method to add an input parameter that could be used in a coupled analysis. If this parameter has already been added as an input solver parameter, then this call will have no effect. If a different parameter with the same name has already been added as an input parameter, then a runtime error will be thrown. If a parameter with the same name has already been added as an output parameter, then a runtime error will be thrown. If the parameter name contains invalid characters, a runtime error will be thrown. **Parameters**: - **parameter**: Parameter whose values are provided by System Coupling and consumed by the participant. **Parameters**: - const [SyscParameter](structSyscParameter.md#structSyscParameter) **parameter** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddOutputParameter ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddOutputParameter(const SyscParameter parameter) ``` Provide a method to add an output parameter that could be used in a coupled analysis. If this parameter has already been added as an output solver parameter, then this call will have no effect. If a different parameter with the same name has already been added as an output parameter, then a runtime error will be thrown. If a parameter with the same name has already been added as an input parameter, then a runtime error will be thrown. If the parameter name contains invalid characters, a runtime error will be thrown. **Parameters**: - **parameter**: Parameter whose values are provided by System Coupling and consumed by the participant. **Parameters**: - const [SyscParameter](structSyscParameter.md#structSyscParameter) **parameter** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscGetNumInputParameters ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumInputParameters() ``` Provide a method to get the number of input parameters. **Returns**: Number of input parameters. **Return type**: size\_t ### Function syscGetNumOutputParameters ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumOutputParameters() ``` Provide a method to get the number of output parameters. **Returns**: Number of output parameters. **Return type**: size\_t ### Function syscGetAddedInputParameter ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscParameter syscGetAddedInputParameter(size_t index) ``` Provide a function to return input parameter information. **Parameters**: - **index**: - input parameter index **Returns**: Input parameter information at specified index. **Parameters**: - size\_t **index** **Return type**: [SyscParameter](structSyscParameter.md#structSyscParameter) ### Function syscGetAddedOutputParameter ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscParameter syscGetAddedOutputParameter(size_t index) ``` Provide a function to return input parameter information. **Parameters**: - **index**: - input parameter index **Returns**: Output parameter information at specified index. **Parameters**: - size\_t **index** **Return type**: [SyscParameter](structSyscParameter.md#structSyscParameter) ### Function syscGetNumRealAttributes ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumRealAttributes() ``` Provide a function to get the number of real attributes. **Returns**: Number of real attributes. **Return type**: size\_t ### Function syscGetNumIntegerAttributes ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumIntegerAttributes() ``` Provide a function to get the number of integer attributes. **Returns**: Number of integer attributes. **Return type**: size\_t ### Function syscGetAddedRealAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRealAttribute syscGetAddedRealAttribute(size_t index) ``` Provide a function to return real attribute information. **Parameters**: - **index**: - real attribute index. **Returns**: Real attribute information at specified index. **Parameters**: - size\_t **index** **Return type**: [SyscRealAttribute](structSyscRealAttribute.md#structSyscRealAttribute) ### Function syscGetAddedIntegerAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscIntegerAttribute syscGetAddedIntegerAttribute(size_t index) ``` Provide a function to return integer attribute information. **Parameters**: - **index**: - integer attribute index. **Returns**: Integer attribute information at specified index. **Parameters**: - size\_t **index** **Return type**: [SyscIntegerAttribute](structSyscIntegerAttribute.md#structSyscIntegerAttribute) ### Function syscAddRealAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddRealAttribute(const SyscRealAttribute attribute) ``` Provide a method to add a real attribute that could be used in a coupled analysis. If this attribute has already been added as a real attribute, then this call will have no effect. If a different real attribute with the same name has already been added, then a runtime error will be thrown. If a an attribute with the same name has already been added as an integer attribute, then a runtime error will be thrown. If the attribute name contains invalid characters, a runtime error will be thrown. **Parameters**: - **attribute**: Real attribute. **Parameters**: - const [SyscRealAttribute](structSyscRealAttribute.md#structSyscRealAttribute) **attribute** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddIntegerAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddIntegerAttribute(const SyscIntegerAttribute attribute) ``` Provide a method to add an integer attribute that could be used in a coupled analysis. If this attribute has already been added as an integer attribute, then this call will have no effect. If a different integer attribute with the same name has already been added, then a runtime error will be thrown. If a an attribute with the same name has already been added as a real attribute, then a runtime error will be thrown. If the attribute name contains invalid characters, a runtime error will be thrown. **Parameters**: - **attribute**: Integer attribute. **Parameters**: - const [SyscIntegerAttribute](structSyscIntegerAttribute.md#structSyscIntegerAttribute) **attribute** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscGetParameterValue ![](https://img.shields.io/badge/-public-brightgreen "public") ``` double syscGetParameterValue(const char *parameterName, SyscError *errorCode) ``` Provide a function to get a Parameter value. **Parameters**: - **parameterName**: - name of the parameter. - **errorCode**: - error status for the fuction. **Parameters**: - const char \* **parameterName** - [SyscError](structSyscError.md#structSyscError) \* **errorCode** **Return type**: double ### Function syscSetParameterValue ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscSetParameterValue(const char *parameterName, double value) ``` Provide a function to set a Parameter value. **Parameters**: - **parameterName**: - name of the parameter. - **value**: - value of the parameter. **Parameters**: - const char \* **parameterName** - double **value** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscGetRealAttributeValue ![](https://img.shields.io/badge/-public-brightgreen "public") ``` double syscGetRealAttributeValue(const char *attributeName, SyscError *errorCode) ``` Provide a function to get a RealAttribute value. **Parameters**: - **attributeName**: - name of the attribute. - **errorCode**: - error status for the function. **Parameters**: - const char \* **attributeName** - [SyscError](structSyscError.md#structSyscError) \* **errorCode** **Return type**: double ### Function syscGetIntegerAttributeValue ![](https://img.shields.io/badge/-public-brightgreen "public") ``` int64_t syscGetIntegerAttributeValue(const char *attributeName, SyscError *errorCode) ``` Provide a function to get an IntegerAttribute value. **Parameters**: - **attributeName**: - name of the attribute. - **errorCode**: - error status for the function. **Parameters**: - const char \* **attributeName** - [SyscError](structSyscError.md#structSyscError) \* **errorCode** **Return type**: int64\_t ### Function syscAddCouplingInterface ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddCouplingInterface(const SyscCouplingInterface couplingInterface) ``` Provide a function to add a coupling interface. If this coupling interface has already been added, then this call will have no effect. If a different coupling interface with the same has already been added, then an error status will be returned. If the coupling interface name contains invalid characters, then an error status will be returned. See [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) for more details. **Parameters**: - const [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscAddCouplingInterfaceA ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscAddCouplingInterfaceA(const SyscCouplingInterface couplingInterface, int autoGenerateDataTransfers) ``` Provide a function to add a coupling interface. If this coupling interface has already been added, then this call will have no effect. If a different coupling interface with the same has already been added, then an error status will be returned. If the coupling interface name contains invalid characters, then an error status will be returned. See [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) for more details. **Parameters**: - const [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) **couplingInterface** - int **autoGenerateDataTransfers** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscCompleteSetup ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscCompleteSetup(const SyscSetupInfo setupInfo) ``` Provide a function to notify System Coupling that setup can be completed. After this function is called, coupled analysis setup can no longer be updated, i.e. regions and variables cannot be changed. Once the setup is complete, any subsequent call to complete the setup will have no effect. **Parameters**: - **setupInfo**: - setup information. **Parameters**: - const [SyscSetupInfo](structSyscSetupInfo.md#structSyscSetupInfo) **setupInfo** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputScalarDataAccess(SyscInputScalarDataAccess dataAccess) ``` Provide a function to register input scalar data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscInputScalarDataAccess prototype. **Parameters**: - [SyscInputScalarDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaaf3788ac706a730edbf6093c7e543681) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputScalarDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscInputScalarDataAccessWithPointer dataAccess) ``` Provide a function to register input scalar data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscInputScalarDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscInputScalarDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gad41922f1a4f5abb891d5a913ba5fcccf) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputScalarDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputScalarDataMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscInputScalarDataMultiZoneAccess dataAccess) ``` Provide a function to register input scalar data multi-zone access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscInputScalarDataMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscInputScalarDataMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga844dc6322bd6e4eabc2d3d2d9e69bdb1) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputVectorDataAccess(SyscInputVectorDataAccess dataAccess) ``` Provide a function to register input vector data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscInputVectorDataAccess prototype. **Parameters**: - [SyscInputVectorDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga8d5f53de4e65a4bacef0f25ba8b46483) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputVectorDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscInputVectorDataAccessWithPointer dataAccess) ``` Provide a function to register input vector data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscInputVectorDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscInputVectorDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gae7c6372393f3ec720b8d6d1535fcf9b3) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputVectorDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputVectorDataMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscInputVectorDataMultiZoneAccess dataAccess) ``` Provide a function to register input vector data multi-zone access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscInputVectorDataMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscInputVectorDataMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gae2e92f1b7ae911c36bf3606c60a01511) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputScalarDataAccess(SyscOutputScalarDataAccess dataAccess) ``` Provide a function to register output scalar data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscOutputScalarDataAccess prototype. **Parameters**: - [SyscOutputScalarDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gabd35283796cae3d3dbc851ac66b8564f) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputScalarDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscOutputScalarDataAccessWithPointer dataAccess) ``` Provide a function to register output scalar data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscOutputScalarDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscOutputScalarDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gab378ed75ffd9b081ad7eccf8107a5542) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputScalarDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputScalarDataMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscOutputScalarDataMultiZoneAccess dataAccess) ``` Provide a function to register output scalar data multi-zone access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscOutputScalarDataMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscOutputScalarDataMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7767f728d880014dfbd853bbb8e0eb07) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputVectorDataAccess(SyscOutputVectorDataAccess dataAccess) ``` Provide a function to register output vector data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscOutputVectorDataAccess prototype. **Parameters**: - [SyscOutputVectorDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gae99c8cb78199403b9e74217557be206a) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputVectorDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscOutputVectorDataAccessWithPointer dataAccess) ``` Provide a function to register output vector data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscOutputVectorDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscOutputVectorDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gab30cbe5478bf769c81f5c0a07e885afd) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputVectorDataMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputVectorDataMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscOutputVectorDataMultiZoneAccess dataAccess) ``` Provide a function to register output vector data multi-zone access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscOutputVectorDataMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscOutputVectorDataMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga1d6d5d9fa806ac5820d9a6ed85811804) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputComplexScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputComplexScalarDataAccess(SyscInputComplexScalarDataAccess dataAccess) ``` Provide a function to register input complex scalar data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscInputComplexScalarDataAccess prototype. **Parameters**: - [SyscInputComplexScalarDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gab388f936f3a73b9b480a792c401a95a1) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputComplexScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputComplexScalarDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscInputComplexScalarDataAccessWithPointer dataAccess) ``` Provide a function to register input complex scalar data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscInputComplexScalarDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscInputComplexScalarDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga7a0c5889de7b17b59d44595d7636747e) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputComplexVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputComplexVectorDataAccess(SyscInputComplexVectorDataAccess dataAccess) ``` Provide a function to register input complex vector data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscInputComplexVectorDataAccess prototype. **Parameters**: - [SyscInputComplexVectorDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gace54794852b48d8725b930f1aed89c4d) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterInputComplexVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterInputComplexVectorDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscInputComplexVectorDataAccessWithPointer dataAccess) ``` Provide a function to register input complex vector data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscInputComplexVectorDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscInputComplexVectorDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga68dcce877e8cc69f13bee845c76f1b4d) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputComplexScalarDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputComplexScalarDataAccess(SyscOutputComplexScalarDataAccess dataAccess) ``` Provide a function to register output complex scalar data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscOutputComplexScalarDataAccess prototype. **Parameters**: - [SyscOutputComplexScalarDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17d96c2c29a44374309efafdfb8fef62) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputComplexScalarDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputComplexScalarDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscOutputComplexScalarDataAccessWithPointer dataAccess) ``` Provide a function to register output complex scalar data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscOutputComplexScalarDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscOutputComplexScalarDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga71ac4910edd87d8d62e871001258c698) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputComplexVectorDataAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputComplexVectorDataAccess(SyscOutputComplexVectorDataAccess dataAccess) ``` Provide a function to register output complex vector data access. **Parameters**: - **dataAccess**: - a pointer to the function that conforms to SyscOutputComplexVectorDataAccess prototype. **Parameters**: - [SyscOutputComplexVectorDataAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga65a0f3a119f2cec715ac89798f16a97c) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterOutputComplexVectorDataAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterOutputComplexVectorDataAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscOutputComplexVectorDataAccessWithPointer dataAccess) ``` Provide a function to register output complex vector data access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **dataAccess**: - a pointer to the function that conforms to SyscOutputComplexVectorDataAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscOutputComplexVectorDataAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga18e31a00d833843895c731e69ca006b0) **dataAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterSurfMeshAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterSurfMeshAccess(SyscSurfMeshAccess meshAccess) ``` Provide a function to register surface mesh access. **Parameters**: - **meshAccess**: - a pointer to the function that conforms to SyscSurfMeshAccess prototype. **Parameters**: - [SyscSurfMeshAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga71e4eb102d00dd0a211f6dc2f4d24222) **meshAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterSurfaceMeshAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterSurfaceMeshAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscSurfaceMeshAccessWithPointer meshAccess) ``` Provide a function to register surface mesh access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **meshAccess**: - a pointer to the function that conforms to SyscSurfaceMeshAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscSurfaceMeshAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gafbfb299099d65e3f232bb67a04d1a8e9) **meshAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterSurfaceMeshMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterSurfaceMeshMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscSurfaceMeshMultiZoneAccess meshAccess) ``` Provide a function to register surface mesh multi-zone access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **meshAccess**: - a pointer to the function that conforms to SyscSurfaceMeshMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscSurfaceMeshMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga9ffe052c4c28ff40b4a14b32cd9f227c) **meshAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterVolumeMeshAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterVolumeMeshAccess(SyscVolumeMeshAccess meshAccess) ``` Provide a function to register volume mesh access. **Parameters**: - **meshAccess**: - a pointer to the function that conforms to SyscVolumeMeshAccess prototype. **Parameters**: - [SyscVolumeMeshAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gad0ff77c2af045d3294b149219123a084) **meshAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterVolumeMeshAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterVolumeMeshAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscVolumeMeshAccessWithPointer meshAccess) ``` Provide a function to register volume mesh access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **meshAccess**: - a pointer to the function that conforms to SyscVolumeMeshAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscVolumeMeshAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gadcb6262e27485836632696e52cf80fb9) **meshAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterVolumeMeshMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterVolumeMeshMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscVolumeMeshMultiZoneAccess meshAccess) ``` Provide a function to register volume mesh multi-zone access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **meshAccess**: - a pointer to the function that conforms to SyscVolumeMeshMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscVolumeMeshMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaf381b799bec1baf9f3ab727b61458b59) **meshAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterPointCloudAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterPointCloudAccess(SyscPointCloudAccess pointCloudAccess) ``` Provide a function to register point cloud access. **Parameters**: - **pointCloudAccess**: - a pointer to the function that conforms to SyscPointCloudAccess prototype. **Parameters**: - [SyscPointCloudAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gae999907f608779e525e34f60d2803038) **pointCloudAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterPointCloudAccessWithPointer ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterPointCloudAccessWithPointer(SyscOpaqueDataAccess opaqueDataAccess, SyscPointCloudAccessWithPointer pointCloudAccess) ``` Provide a function to register point cloud access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **pointCloudAccess**: - a pointer to the function that conforms to SyscPointCloudAccessWithPointer prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscPointCloudAccessWithPointer](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gafa62fd6d86905625ae071dea4749a8df) **pointCloudAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterPointCloudMultiZoneAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterPointCloudMultiZoneAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscPointCloudMultiZoneAccess pointCloudAccess) ``` Provide a function to register point cloud multi-zone access. **Parameters**: - **opaqueDataAccess**: - a pointer to an address in memory. This pointer will be passed into the callback function. - **meshAccess**: - a pointer to the function that conforms to SyscPointCloudMultiZoneAccess prototype. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscPointCloudMultiZoneAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gac4a0788f14f0d473372f07638e9dceaa) **pointCloudAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterZoneCountAccess ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterZoneCountAccess(SyscOpaqueDataAccess opaqueDataAccess, SyscZoneCountAccess zoneCountAccess) ``` Provide a function to register zone count access. **Parameters**: - [SyscOpaqueDataAccess](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga17ef60969b3c919163ba2471eb95a28b) **opaqueDataAccess** - [SyscZoneCountAccess](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaabc0678095ad5a5efb8be4d666ce2677) **zoneCountAccess** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscRegisterRestartPointCreation ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscRegisterRestartPointCreation(SyscRestartPointCreation restartPointCreation) ``` Provide a function to register restart point creation callback. **Parameters**: - **restartPointCreation**: - a pointer to the function that conforms to SyscRestartPointCreation function prototype. See SyscRestartPointCreation for details. **Parameters**: - [SyscRestartPointCreation](syscFunctionTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga6d3934571a8dcc03e2ecbe724a808c1b) **restartPointCreation** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscInitializeAnalysis ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscInitializeAnalysis() ``` Provide a function to notify System Coupling that analysis initialization can be completed. This function must be called after registering mesh and variable data access and prior to entering the coupled analysis loop. If this function is called before the coupled analysis is complete, it will automatically complete the coupled analysis and assume steady analysis type. **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscDoIteration ![](https://img.shields.io/badge/-public-brightgreen "public") ``` int syscDoIteration() ``` Provide a function to check whether to do a coupling iteration. This function returns 1 (true) if another coupling iteration is required, otherwise it returns 0 (false). **Return type**: int ### Function syscDoTimeStep ![](https://img.shields.io/badge/-public-brightgreen "public") ``` int syscDoTimeStep() ``` Provide a function to check whether to do a coupling time step. This function returns 1 (true) if another coupling time step is required, otherwise it returns 0 (false). This function should be called to check if another coupling time step should be done. If the previous coupling time step is finished and another time step should be performed, then calling this function will tell System Coupling that the coupling participant is going to advance to the next time step (i.e. calling [syscDoTimeStep()](syscSystemCoupling_8h.md#group__SyscParticipantLibraryCAPI_1gaf701624f0add6b5d7a5fd2d9dcf8e298) will cause [syscDoIteration()](syscSystemCoupling_8h.md#group__SyscParticipantLibraryCAPI_1gaea2bf4afeff9dd606125e00bb6c475a0) to change from returning false to returning true, under the conditions described above). This function only makes sense for transient analysis. It will always return false for steady analysis. **Return type**: int ### Function syscGetCurrentTimeStep ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscTimeStep syscGetCurrentTimeStep() ``` Provide a function to get current time step. This function returns a time step struct, which contains time step number, start time, and time step size for the current coupling time step. A default value (time step number 0, start time 0.0, time step size 0.0) is returned if this function is called outside the coupled analysis loop or if the analysis is steady. **Return type**: [SyscTimeStep](structSyscTimeStep.md#structSyscTimeStep) ### Function syscUpdateInputs ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscUpdateInputs() ``` Provide a function to update the participants input variables. Solution data for all input variables will be updated. Depending on the defined interfaces, data will be transferred from another coupling participant solver, or from the opposite side of the same-participant coupling interface. When doing cosimulation, this function must be called from inside the coupled analysis loop. It tells System Coupling that the participant is about to begin its solver iterations. All input variable data will be up-to-date after returning from this function. If any local coupling interfaces are defined, all corresponding input variable data will also be updated. When doing same-participant mapping only (without cosimulation), this function should be called whenever input data needs to be brought up-to-date. **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscUpdateOutputs ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscUpdateOutputs(const enum SyscConvergenceStatus convStatus) ``` Provide a function to update the participants output variables. This function must be called from inside the coupled analysis loop. It tells System Coupling that the participant has finished performing its solver iterations. **Parameters**: - const enum [SyscConvergenceStatus](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga10ce3774353dfbc811147a9ad211b3cd) **convStatus** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscDisconnect ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscDisconnect() ``` Provide a function to end the analysis and disconnect from System Coupling. **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscFatalError ![](https://img.shields.io/badge/-public-brightgreen "public") ``` void syscFatalError(const char *errorMessage) ``` Provide a function to notify System Coupling about a fatal error. **Parameters**: - const char \* **errorMessage** **Return type**: void ### Function syscNonFatalError ![](https://img.shields.io/badge/-public-brightgreen "public") ``` void syscNonFatalError(const char *errorMessage) ``` Provide a function to notify System Coupling about a non fatal error. **Parameters**: - const char \* **errorMessage** **Return type**: void ### Function syscCheckSurfaceMeshValidity ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscCheckSurfaceMeshValidity(SyscSurfaceMesh mesh) ``` Provide a function to perform simple mesh validity checks. This function is provided as a testing and debugging tool and is not meant to be used in production workflows. System Coupling itself will not call this function for performance reasons. The function will check the surface mesh for detectable problems. For example, it will check if array sizes are consistent, that elemNodeIds array only contains ids that are found in nodeIds array, etc. It is not an exhaustive validity check - the mesh can still have problems even if all checks passed. **Returns**: Return value is [SyscError](structSyscError.md#structSyscError) struct. If mesh checks passed, then retcode will be 0. If mesh checks failed, then retcode will be not 0 and message that contains information about about the particular issue. **Parameters**: - [SyscSurfaceMesh](structSyscSurfaceMesh.md#structSyscSurfaceMesh) **mesh** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscWriteSetupFile ![](https://img.shields.io/badge/-public-brightgreen "public") ``` int syscWriteSetupFile(const SyscSetupFileInfo setupFileInfo) ``` Provide a function to write the setup file. This function can be used to generate a System Coupling setup file, which contains participant's setup information. It should be called after calling syscCompleteCouplingSetup. It takes [SyscSetupFileInfo](structSyscSetupFileInfo.md#structSyscSetupFileInfo) struct as input parameter. It will return true (1) if the setup file was successfully written, and false (0) otherwise. **Parameters**: - const [SyscSetupFileInfo](structSyscSetupFileInfo.md#structSyscSetupFileInfo) **setupFileInfo** **Return type**: int ### Function syscWriteResults ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscWriteResults(const SyscResultsInfo resultsInfo) ``` Write results to a file. **Parameters**: - const [SyscResultsInfo](structSyscResultsInfo.md#structSyscResultsInfo) **resultsInfo** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscGetNumRegions ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumRegions() ``` Provide a function to return the number of added regions. **Returns**: Number of regions. **Return type**: size\_t ### Function syscGetAddedRegion ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRegion syscGetAddedRegion(size_t index) ``` Provide a function to return added region given the region index. **Parameters**: - **index**: - region index. Use [syscGetNumRegions()](syscSystemCoupling_8h.md#group__SyscParticipantLibraryCAPI_1ga5783653d3a5994b0bccb7471843e72eb) to get the number of regions. **Returns**: Region at specified index. **Parameters**: - size\_t **index** **Return type**: [SyscRegion](structSyscRegion.md#structSyscRegion) ### Function syscGetSolutionControl ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscSolutionControl syscGetSolutionControl() ``` Get solution control. **Return type**: [SyscSolutionControl](structSyscSolutionControl.md#structSyscSolutionControl) ### Function syscGetNumCouplingInterfaces ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscGetNumCouplingInterfaces() ``` Provide a function to return the number of added coupling interfaces. **Returns**: Number of coupling interfaces. **Return type**: size\_t ### Function syscGetAddedCouplingInterface ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscCouplingInterface syscGetAddedCouplingInterface(size_t index) ``` **Parameters**: - size\_t **index** **Return type**: [SyscCouplingInterface](structSyscCouplingInterface.md#structSyscCouplingInterface) ### Function syscGetVariable ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetVariable(const char *name) ``` Create variable to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this variable. String length should not exceed SYSC\_STRING\_LENGTH. Display name will default to the same as name. Tensor type will default to scalar. Is extensive flag will default to false (to non-extensive). Location will default to nodes. Quantity type will default to unspecified. **Parameters**: - const char \* **name** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscGetVariableDTELQD ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetVariableDTELQD(const char *name, const char *displayName, enum SyscTensorType tensorType, int isExtensive, enum SyscLocation location, enum SyscQuantityType quantityType, enum SyscDataType dataType) ``` Create variable to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this variable. String length should not exceed SYSC\_STRING\_LENGTH. - **displayName**: - variable display name. String length should not exceed SYSC\_STRING\_LENGTH. - **tensorType**: - variable tensor type. - **isExtensive**: - flag indicating if it's an extensive property. - **location**: - variable location (e.g element or node). - **quantityType**: - variable quantity type. - **dataType**: - variable data type. **Parameters**: - const char \* **name** - const char \* **displayName** - enum [SyscTensorType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga007e2fd66e7263a63c114a6d12b3808d) **tensorType** - int **isExtensive** - enum [SyscLocation](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gade42aba1a68acbbf5956edcd388cdcda) **location** - enum [SyscQuantityType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaa28a3de6c7c91003a8a15721a5301f12) **quantityType** - enum SyscDataType **dataType** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscGetVariableTE ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetVariableTE(const char *name, enum SyscTensorType tensorType, int isExtensive, enum SyscLocation location) ``` Create variable to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this variable. String length should not exceed SYSC\_STRING\_LENGTH. - **tensorType**: - variable tensor type. - **isExtensive**: - flag indicating if it's an extensive property. - **location**: - variable location (e.g element or node). Display name will default to the same as name. Quantity type will default to unspecified. **Parameters**: - const char \* **name** - enum [SyscTensorType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga007e2fd66e7263a63c114a6d12b3808d) **tensorType** - int **isExtensive** - enum [SyscLocation](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gade42aba1a68acbbf5956edcd388cdcda) **location** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscGetVariableTEQ ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetVariableTEQ(const char *name, const char *displayName, enum SyscTensorType tensorType, int isExtensive, enum SyscLocation location, enum SyscQuantityType quantityType) ``` Create variable to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this variable. String length should not exceed SYSC\_STRING\_LENGTH. - **displayName**: - variable display name. String length should not exceed SYSC\_STRING\_LENGTH. - **tensorType**: - variable tensor type. - **isExtensive**: - flag indicating if it's an extensive property. - **location**: - variable location (e.g element or node). - **quantityType**: - variable quantity type. **Parameters**: - const char \* **name** - const char \* **displayName** - enum [SyscTensorType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1ga007e2fd66e7263a63c114a6d12b3808d) **tensorType** - int **isExtensive** - enum [SyscLocation](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gade42aba1a68acbbf5956edcd388cdcda) **location** - enum [SyscQuantityType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaa28a3de6c7c91003a8a15721a5301f12) **quantityType** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscGetVariableQ ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVariable syscGetVariableQ(const char *name, const char *displayName, enum SyscLocation location, enum SyscQuantityType quantityType) ``` Create variable to be used in a coupled analysis. **Parameters**: - **name**: - Unique name for this variable. String length should not exceed SYSC\_STRING\_LENGTH. - **displayName**: - variable display name. String length should not exceed SYSC\_STRING\_LENGTH. - **location**: - variable location (e.g element or node). - **quantityType**: - variable quantity type. The variable tensor type and is extensive properties will be inferred from the quantity type, according to the following rules: ``` Quantity Type Tensor Type Is Extensive ---------------------------------------------------------------- Force Vector True Incremental Displacement Vector False Temperature Scalar False Heat Rate Scalar True Heat Transfer Coefficient Scalar False Convection Reference Temperature Scalar False ``` If any other quantity type is specified, tensor type will be set to scalar and is extensive will be set to false. **Parameters**: - const char \* **name** - const char \* **displayName** - enum [SyscLocation](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gade42aba1a68acbbf5956edcd388cdcda) **location** - enum [SyscQuantityType](syscCommonTypes_8h.md#group__SyscParticipantLibraryCAPI_1gaa28a3de6c7c91003a8a15721a5301f12) **quantityType** **Return type**: [SyscVariable](structSyscVariable.md#structSyscVariable) ### Function syscVariableAddRealAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscVariableAddRealAttribute(SyscVariable variable, SyscRealAttribute attribute) ``` Add real-valued attribute to the variable. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** - [SyscRealAttribute](structSyscRealAttribute.md#structSyscRealAttribute) **attribute** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscVariableAddIntegerAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscError syscVariableAddIntegerAttribute(SyscVariable variable, SyscIntegerAttribute attribute) ``` Add integer-valued attribute to the variable. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** - [SyscIntegerAttribute](structSyscIntegerAttribute.md#structSyscIntegerAttribute) **attribute** **Return type**: [SyscError](structSyscError.md#structSyscError) ### Function syscVariableGetNumRealAttributes ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscVariableGetNumRealAttributes(SyscVariable variable) ``` Get number of real-valued attributes. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** **Return type**: size\_t ### Function syscVariableGetNumIntegerAttributes ![](https://img.shields.io/badge/-public-brightgreen "public") ``` size_t syscVariableGetNumIntegerAttributes(SyscVariable variable) ``` Get number of integer-valued attributes. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** **Return type**: size\_t ### Function syscVariableGetRealAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscRealAttribute syscVariableGetRealAttribute(SyscVariable variable, size_t index) ``` Return the real-valued attribute at the given index. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** - size\_t **index** **Return type**: [SyscRealAttribute](structSyscRealAttribute.md#structSyscRealAttribute) ### Function syscVariableGetIntegerAttribute ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscIntegerAttribute syscVariableGetIntegerAttribute(SyscVariable variable, size_t index) ``` Return the integer-valued attribute at the given index. **Parameters**: - [SyscVariable](structSyscVariable.md#structSyscVariable) **variable** - size\_t **index** **Return type**: [SyscIntegerAttribute](structSyscIntegerAttribute.md#structSyscIntegerAttribute) ### Function syscGetVolumeMeshEmpty ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVolumeMesh syscGetVolumeMeshEmpty() ``` Create an empty volume mesh access struct. Returns a struct representing empty volume mesh. All member will be assigned default values. **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh) ### Function syscGetVolumeMeshNFC ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVolumeMesh syscGetVolumeMeshNFC(SyscNodeData nodes, SyscFaceData faces, SyscCellData cells) ``` Create a volume mesh access struct. **Parameters**: - **nodes**: - node data - **faces**: - face data - **cells**: - cell data **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscFaceData](structSyscFaceData.md#structSyscFaceData) **faces** - [SyscCellData](structSyscCellData.md#structSyscCellData) **cells** **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh) ### Function syscGetVolumeMeshElementBased ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVolumeMesh syscGetVolumeMeshElementBased(SyscNodeData nodes, SyscElementTypeData cellTypes, SyscElementNodeConnectivityData cellNodeConnectivity) ``` Create an element-based volume mesh access struct. **Parameters**: - **nodes**: - node data - **cellTypes**: - cell types - **cellNodeConnectivity**: - cell-to-node connectivity **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscElementTypeData](structSyscElementTypeData.md#structSyscElementTypeData) **cellTypes** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **cellNodeConnectivity** **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh) ### Function syscGetVolumeMeshFaceBased ![](https://img.shields.io/badge/-public-brightgreen "public") ``` SyscVolumeMesh syscGetVolumeMeshFaceBased(SyscNodeData nodes, SyscElementNodeCountData faceNodeCounts, SyscElementNodeConnectivityData faceNodeConnectivity, SyscFaceCellConnectivityData faceCellConnectivity, SyscCellIdData cellIds) ``` Create a face-based volume mesh access struct. **Parameters**: - **nodes**: - node data - **faceNodeCounts**: - face node counts - **faceNodeConnectivity**: - face-to-node connectivity - **faceCellConnectivity**: - face-to-cell connectivity - **cellIds**: - cell ids **Parameters**: - [SyscNodeData](structSyscNodeData.md#structSyscNodeData) **nodes** - [SyscElementNodeCountData](structSyscElementNodeCountData.md#structSyscElementNodeCountData) **faceNodeCounts** - [SyscElementNodeConnectivityData](structSyscElementNodeConnectivityData.md#structSyscElementNodeConnectivityData) **faceNodeConnectivity** - [SyscFaceCellConnectivityData](structSyscFaceCellConnectivityData.md#structSyscFaceCellConnectivityData) **faceCellConnectivity** - [SyscCellIdData](structSyscCellIdData.md#structSyscCellIdData) **cellIds** **Return type**: [SyscVolumeMesh](structSyscVolumeMesh.md#structSyscVolumeMesh) ## Macros ### Macro SYSC\_STRING\_LENGTH ![](https://img.shields.io/badge/-public-brightgreen "public") ``` #define SYSC_STRING_LENGTH 256 ``` Define maximum string length.