ansys-systemcoupling-core 0.4.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

ansys/systemcoupling/core/adaptor/api_24_2/add_reference_frame.py

@@ -0,0 +1,40 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+
+class add_reference_frame(Command):
+    """
+    Add a reference frame to the datamodel
+
+    The function will add a blank reference frame to the datamodel. Any
+    transformations must be added separately.
+
+    Reference frame name will be "Frame-#" where # is the first positive
+    integer which yields a unique frame name.
+
+    Returns the name of the reference frame.
+
+    Parameters
+    ----------
+    parent_reference_frame : str, optional
+        Name of a reference frame that the added frame should use as the
+        parent. If the argument is not provided, the default parent reference
+        frame "GlobalReferenceFrame" will be added.
+
+    """
+
+    syc_name = "AddReferenceFrame"
+
+    argument_names = ["parent_reference_frame"]
+
+    class parent_reference_frame(String):
+        """
+        Name of a reference frame that the added frame should use as the
+        parent. If the argument is not provided, the default parent reference
+        frame "GlobalReferenceFrame" will be added.
+        """
+
+        syc_name = "ParentReferenceFrame"

ansys/systemcoupling/core/adaptor/api_24_2/add_thermal_data_transfers.py

@@ -0,0 +1,43 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+
+class add_thermal_data_transfers(Command):
+    """
+    Adds group of data transfers for thermal physics.
+
+    Returns the list of the data transfers created.
+
+    Parameters
+    ----------
+    interface : str
+        String indicating the name of the interface on which the data transfer
+        is to be created.
+    option : str, optional
+        Thermal data transfer option: 'Heat Rate' (default) or
+        'Heat Transfer Coefficient' (possible for surface-surface transfers).
+
+    """
+
+    syc_name = "AddThermalDataTransfers"
+
+    argument_names = ["interface", "option"]
+
+    class interface(String):
+        """
+        String indicating the name of the interface on which the data transfer
+        is to be created.
+        """
+
+        syc_name = "Interface"
+
+    class option(String):
+        """
+        Thermal data transfer option: 'Heat Rate' (default) or
+        'Heat Transfer Coefficient' (possible for surface-surface transfers).
+        """
+
+        syc_name = "Option"

ansys/systemcoupling/core/adaptor/api_24_2/add_transformation.py

@@ -0,0 +1,102 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+
+class add_transformation(Command):
+    """
+    Add a transformation to a reference frame defined in the datamodel
+
+    Given the reference frame to add to the transform to, the type of transform
+    to be added, and any required information for the transformation, add the
+    transformation to the referenceFrame. Not all parameters are required for
+    every transformation.
+
+    The name of the transformation will be based on the type of transformation.
+    The name will be of the form ``<transformation_type>-#`` where ``#`` is the first
+    positive integer which yields a unique frame name.
+
+    The transformation will also be added to the end of the ``transformation_order``
+    list for the reference frame.
+
+    Returns the name of the transformation.
+
+    Parameters
+    ----------
+    reference_frame : str
+        Name of the reference frame to which the transformation will be added.
+    transformation_type : str
+        Type of transformation to be added. Available options are \"Rotation\" or
+        \"Translation\".
+
+        Required Parameters for Transformation Types:
+            Rotation: ``angle``, ``axis``, ``vector`` (if ``axis`` is \"UserDefined\")
+            Translation: ``vector``
+    angle : real, optional
+        Angle to rotate a reference frame. Used with \"Rotation\"
+        ``transformation_type``. Default unit is Radians.
+    axis : str, optional
+        Axis about which a rotation is applied. Used with
+        Rotation ``transformation_type``. Available options are: \"XAxis\", \"YAxis\",
+        \"ZAxis\", and \"UserDefined\".
+    vector : typing.Tuple[real, real, real], optional
+        A vector for use with \"Translation\" ``transformation_type`` or \"Rotation\"
+        ``transformation_type`` if the ``axis`` is \"UserDefined\".
+
+    """
+
+    syc_name = "AddTransformation"
+
+    argument_names = [
+        "reference_frame",
+        "transformation_type",
+        "angle",
+        "axis",
+        "vector",
+    ]
+
+    class reference_frame(String):
+        """
+        Name of the reference frame to which the transformation will be added.
+        """
+
+        syc_name = "ReferenceFrame"
+
+    class transformation_type(String):
+        """
+        Type of transformation to be added. Available options are \"Rotation\" or
+        \"Translation\".
+
+        Required Parameters for Transformation Types:
+            Rotation: ``angle``, ``axis``, ``vector`` (if ``axis`` is \"UserDefined\")
+            Translation: ``vector``
+        """
+
+        syc_name = "TransformationType"
+
+    class angle(Real):
+        """
+        Angle to rotate a reference frame. Used with \"Rotation\"
+        ``transformation_type``. Default unit is Radians.
+        """
+
+        syc_name = "Angle"
+
+    class axis(String):
+        """
+        Axis about which a rotation is applied. Used with
+        Rotation ``transformation_type``. Available options are: \"XAxis\", \"YAxis\",
+        \"ZAxis\", and \"UserDefined\".
+        """
+
+        syc_name = "Axis"
+
+    class vector(RealVector):
+        """
+        A vector for use with \"Translation\" ``transformation_type`` or \"Rotation\"
+        ``transformation_type`` if the ``axis`` is \"UserDefined\".
+        """
+
+        syc_name = "Vector"

ansys/systemcoupling/core/adaptor/api_24_2/analysis_control.py

@@ -0,0 +1,283 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+from .apip import apip
+from .automatic_alignment_options import automatic_alignment_options
+from .avoid_data_reconstruction import avoid_data_reconstruction
+from .global_stabilization import global_stabilization
+from .unmapped_value_options import unmapped_value_options
+
+
+class analysis_control(Container):
+    """
+    Configure coupling controls.
+    """
+
+    syc_name = "AnalysisControl"
+
+    child_names = [
+        "global_stabilization",
+        "apip",
+        "avoid_data_reconstruction",
+        "unmapped_value_options",
+        "automatic_alignment_options",
+    ]
+
+    global_stabilization: global_stabilization = global_stabilization
+    """
+    global_stabilization child of analysis_control.
+    """
+    apip: apip = apip
+    """
+    apip child of analysis_control.
+    """
+    avoid_data_reconstruction: avoid_data_reconstruction = avoid_data_reconstruction
+    """
+    avoid_data_reconstruction child of analysis_control.
+    """
+    unmapped_value_options: unmapped_value_options = unmapped_value_options
+    """
+    unmapped_value_options child of analysis_control.
+    """
+    automatic_alignment_options: automatic_alignment_options = (
+        automatic_alignment_options
+    )
+    """
+    automatic_alignment_options child of analysis_control.
+    """
+    property_names_types = [
+        ("analysis_type", "AnalysisType", "str"),
+        ("optimize_if_one_way", "OptimizeIfOneWay", "bool"),
+        ("warped_face_tolerance", "WarpedFaceTolerance", "RealType"),
+        ("allow_simultaneous_update", "AllowSimultaneousUpdate", "bool"),
+        ("simultaneous_participants", "SimultaneousParticipants", "str"),
+        (
+            "allow_simultaneous_initialization",
+            "AllowSimultaneousInitialization",
+            "bool",
+        ),
+        ("mpi_pause_timeout", "MpiPauseTimeout", "RealType"),
+        ("partitioning_algorithm", "PartitioningAlgorithm", "str"),
+        ("cleanup_inflated_fm_us", "CleanupInflatedFMUs", "bool"),
+        ("allow_iterations_only_mode", "AllowIterationsOnlyMode", "bool"),
+        ("target_initialization_option", "TargetInitializationOption", "str"),
+        ("fluent_region_update_at_step", "FluentRegionUpdateAtStep", "bool"),
+        ("mesh_import_on_initialization", "MeshImportOnInitialization", "bool"),
+        ("import_all_regions", "ImportAllRegions", "bool"),
+        ("bypass_fluent_adapter", "BypassFluentAdapter", "bool"),
+        ("variable_to_expression_transfer", "VariableToExpressionTransfer", "bool"),
+        ("update_mapping_weights", "UpdateMappingWeights", "str"),
+        (
+            "solve_incremental_displacement_first",
+            "SolveIncrementalDisplacementFirst",
+            "bool",
+        ),
+        ("write_scs_file", "WriteScsFile", "bool"),
+        ("check_for_input_files_changes", "CheckForInputFilesChanges", "str"),
+    ]
+
+    @property
+    def analysis_type(self) -> str:
+        """Analysis type.
+
+        Allowed values:
+        - \"Steady\"
+        - \"Transient\" """
+        return self.get_property_state("analysis_type")
+
+    @analysis_type.setter
+    def analysis_type(self, value: str):
+        self.set_property_state("analysis_type", value)
+
+    @property
+    def optimize_if_one_way(self) -> bool:
+        """Optimizes various controls for a one-way workflow, if the
+        data transfers form a unidirectional graph."""
+        return self.get_property_state("optimize_if_one_way")
+
+    @optimize_if_one_way.setter
+    def optimize_if_one_way(self, value: bool):
+        self.set_property_state("optimize_if_one_way", value)
+
+    @property
+    def warped_face_tolerance(self) -> RealType:
+        """Set warped face detection tolerance (1e-6 is default value, 1.0 means disabled)."""
+        return self.get_property_state("warped_face_tolerance")
+
+    @warped_face_tolerance.setter
+    def warped_face_tolerance(self, value: RealType):
+        self.set_property_state("warped_face_tolerance", value)
+
+    @property
+    def allow_simultaneous_update(self) -> bool:
+        """Allow simultaneous update of independent participants."""
+        return self.get_property_state("allow_simultaneous_update")
+
+    @allow_simultaneous_update.setter
+    def allow_simultaneous_update(self, value: bool):
+        self.set_property_state("allow_simultaneous_update", value)
+
+    @property
+    def simultaneous_participants(self) -> str:
+        """Controls which participants are updated simultaneously."""
+        return self.get_property_state("simultaneous_participants")
+
+    @simultaneous_participants.setter
+    def simultaneous_participants(self, value: str):
+        self.set_property_state("simultaneous_participants", value)
+
+    @property
+    def allow_simultaneous_initialization(self) -> bool:
+        """Allow simultaneous initialization of participants."""
+        return self.get_property_state("allow_simultaneous_initialization")
+
+    @allow_simultaneous_initialization.setter
+    def allow_simultaneous_initialization(self, value: bool):
+        self.set_property_state("allow_simultaneous_initialization", value)
+
+    @property
+    def mpi_pause_timeout(self) -> RealType:
+        """Specify MPI pause time (in seconds) to wait for other participants to finish solving"""
+        return self.get_property_state("mpi_pause_timeout")
+
+    @mpi_pause_timeout.setter
+    def mpi_pause_timeout(self, value: RealType):
+        self.set_property_state("mpi_pause_timeout", value)
+
+    @property
+    def partitioning_algorithm(self) -> str:
+        """Partitioning algorithm used when participants are running in parallel.
+
+        Allowed values:
+
+        - \"SharedAllocateMachines\" - Participants share both machines and cores.
+
+        - \"SharedAllocateCores\" - Participants share machines but not cores.
+
+        - \"DistributedAllocateCores\" - Participants minimally share cores and machines. (Linux only)
+
+        - \"DistributedAllocateMachines\" - Participants never share cores or machines. (Linux only)
+
+        - \"Custom\" - Custom algorithm."""
+        return self.get_property_state("partitioning_algorithm")
+
+    @partitioning_algorithm.setter
+    def partitioning_algorithm(self, value: str):
+        self.set_property_state("partitioning_algorithm", value)
+
+    @property
+    def cleanup_inflated_fm_us(self) -> bool:
+        """Controls whether System Coupling will cleanup inflated FMUs at end of analysis."""
+        return self.get_property_state("cleanup_inflated_fm_us")
+
+    @cleanup_inflated_fm_us.setter
+    def cleanup_inflated_fm_us(self, value: bool):
+        self.set_property_state("cleanup_inflated_fm_us", value)
+
+    @property
+    def allow_iterations_only_mode(self) -> bool:
+        """Explicitly set whether iterations-only mode is allowed."""
+        return self.get_property_state("allow_iterations_only_mode")
+
+    @allow_iterations_only_mode.setter
+    def allow_iterations_only_mode(self, value: bool):
+        self.set_property_state("allow_iterations_only_mode", value)
+
+    @property
+    def target_initialization_option(self) -> str:
+        """Select option for target initialization."""
+        return self.get_property_state("target_initialization_option")
+
+    @target_initialization_option.setter
+    def target_initialization_option(self, value: str):
+        self.set_property_state("target_initialization_option", value)
+
+    @property
+    def fluent_region_update_at_step(self) -> bool:
+        """Allow update of Fluent regions at the beginning of a step."""
+        return self.get_property_state("fluent_region_update_at_step")
+
+    @fluent_region_update_at_step.setter
+    def fluent_region_update_at_step(self, value: bool):
+        self.set_property_state("fluent_region_update_at_step", value)
+
+    @property
+    def mesh_import_on_initialization(self) -> bool:
+        """Select whether to import the mesh during the analysis initialization."""
+        return self.get_property_state("mesh_import_on_initialization")
+
+    @mesh_import_on_initialization.setter
+    def mesh_import_on_initialization(self, value: bool):
+        self.set_property_state("mesh_import_on_initialization", value)
+
+    @property
+    def import_all_regions(self) -> bool:
+        """Select whether to import mesh for all defined regions."""
+        return self.get_property_state("import_all_regions")
+
+    @import_all_regions.setter
+    def import_all_regions(self, value: bool):
+        self.set_property_state("import_all_regions", value)
+
+    @property
+    def bypass_fluent_adapter(self) -> bool:
+        """Switch to bypass Fluent adapter."""
+        return self.get_property_state("bypass_fluent_adapter")
+
+    @bypass_fluent_adapter.setter
+    def bypass_fluent_adapter(self, value: bool):
+        self.set_property_state("bypass_fluent_adapter", value)
+
+    @property
+    def variable_to_expression_transfer(self) -> bool:
+        """Convert variable-based data transfers to expression transfers."""
+        return self.get_property_state("variable_to_expression_transfer")
+
+    @variable_to_expression_transfer.setter
+    def variable_to_expression_transfer(self, value: bool):
+        self.set_property_state("variable_to_expression_transfer", value)
+
+    @property
+    def update_mapping_weights(self) -> str:
+        """Weight factor when multiple transfers are stabilized.
+
+        Allowed values:
+
+        - \"Off\" (default)
+        - \"EveryStep\"
+        - \"EveryIteration\" """
+        return self.get_property_state("update_mapping_weights")
+
+    @update_mapping_weights.setter
+    def update_mapping_weights(self, value: str):
+        self.set_property_state("update_mapping_weights", value)
+
+    @property
+    def solve_incremental_displacement_first(self) -> bool:
+        """Force participants serving incremental displacement to solve first."""
+        return self.get_property_state("solve_incremental_displacement_first")
+
+    @solve_incremental_displacement_first.setter
+    def solve_incremental_displacement_first(self, value: bool):
+        self.set_property_state("solve_incremental_displacement_first", value)
+
+    @property
+    def write_scs_file(self) -> bool:
+        """Force writing of scs file even if participants are auto-started."""
+        return self.get_property_state("write_scs_file")
+
+    @write_scs_file.setter
+    def write_scs_file(self, value: bool):
+        self.set_property_state("write_scs_file", value)
+
+    @property
+    def check_for_input_files_changes(self) -> str:
+        """Controls whether System Coupling will check for changes in participant input files."""
+        return self.get_property_state("check_for_input_files_changes")
+
+    @check_for_input_files_changes.setter
+    def check_for_input_files_changes(self, value: str):
+        self.set_property_state("check_for_input_files_changes", value)

ansys/systemcoupling/core/adaptor/api_24_2/apip.py

@@ -0,0 +1,33 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+
+class apip(Container):
+    """
+    Apip-related expert settings.
+    """
+
+    syc_name = "Apip"
+
+    property_names_types = [("debug", "Debug", "bool"), ("disable", "Disable", "bool")]
+
+    @property
+    def debug(self) -> bool:
+        """Debug apip data (sends to debug server, saves data locally)."""
+        return self.get_property_state("debug")
+
+    @debug.setter
+    def debug(self, value: bool):
+        self.set_property_state("debug", value)
+
+    @property
+    def disable(self) -> bool:
+        """Disable apip collection (regardless of user settings)."""
+        return self.get_property_state("disable")
+
+    @disable.setter
+    def disable(self, value: bool):
+        self.set_property_state("disable", value)

ansys/systemcoupling/core/adaptor/api_24_2/ascii_output.py

@@ -0,0 +1,44 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+
+class ascii_output(Container):
+    """
+    Output interface data as ASCII.
+    """
+
+    syc_name = "AsciiOutput"
+
+    property_names_types = [("option", "Option", "str"), ("format", "Format", "str")]
+
+    @property
+    def option(self) -> str:
+        """Control ASCII interface data output.
+
+        Allowed values:
+
+        - \"Off\"
+        - \"EveryStep\" (for step-based analyses)
+        - \"EveryIteration\" (for iteration-based analyses)"""
+        return self.get_property_state("option")
+
+    @option.setter
+    def option(self, value: str):
+        self.set_property_state("option", value)
+
+    @property
+    def format(self) -> str:
+        """ASCII output format type.
+
+        Allowed values:
+
+        - \"Axdt\"
+        - \"Csv\" """
+        return self.get_property_state("format")
+
+    @format.setter
+    def format(self, value: str):
+        self.set_property_state("format", value)

ansys/systemcoupling/core/adaptor/api_24_2/attribute.py

@@ -0,0 +1,20 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+from .attribute_child import attribute_child
+
+
+class attribute(NamedContainer[attribute_child]):
+    """
+    Configure a variable's attributes.
+    """
+
+    syc_name = "Attribute"
+
+    child_object_type: attribute_child = attribute_child
+    """
+    child_object_type of attribute.
+    """

ansys/systemcoupling/core/adaptor/api_24_2/attribute_child.py

@@ -0,0 +1,54 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+from .dimensionality import dimensionality
+
+
+class attribute_child(Container):
+    """
+    Configure a variable's attributes.
+    """
+
+    syc_name = "child_object_type"
+
+    child_names = ["dimensionality"]
+
+    dimensionality: dimensionality = dimensionality
+    """
+    dimensionality child of attribute_child.
+    """
+    property_names_types = [
+        ("attribute_type", "AttributeType", "str"),
+        ("real_value", "RealValue", "RealType"),
+        ("integer_value", "IntegerValue", "int"),
+    ]
+
+    @property
+    def attribute_type(self) -> str:
+        """The type of the attribute (\"Real\" or \"Integer\")."""
+        return self.get_property_state("attribute_type")
+
+    @attribute_type.setter
+    def attribute_type(self, value: str):
+        self.set_property_state("attribute_type", value)
+
+    @property
+    def real_value(self) -> RealType:
+        """Real attribute value."""
+        return self.get_property_state("real_value")
+
+    @real_value.setter
+    def real_value(self, value: RealType):
+        self.set_property_state("real_value", value)
+
+    @property
+    def integer_value(self) -> int:
+        """Integer attribute value."""
+        return self.get_property_state("integer_value")
+
+    @integer_value.setter
+    def integer_value(self, value: int):
+        self.set_property_state("integer_value", value)

ansys/systemcoupling/core/adaptor/api_24_2/automatic_alignment_options.py

@@ -0,0 +1,46 @@
+#
+# This is an auto-generated file.  DO NOT EDIT!
+#
+
+from ansys.systemcoupling.core.adaptor.impl.types import *
+
+
+class automatic_alignment_options(Container):
+    """
+    Automatic alignment settings.
+    """
+
+    syc_name = "AutomaticAlignmentOptions"
+
+    property_names_types = [
+        ("alignment_type", "AlignmentType", "str"),
+        ("singular_value_tolerance", "SingularValueTolerance", "RealType"),
+        ("verbosity", "Verbosity", "int"),
+    ]
+
+    @property
+    def alignment_type(self) -> str:
+        """Alignment type (\"Covariance\" or \"Moment Covariance\" or \"Inertial Axes\")."""
+        return self.get_property_state("alignment_type")
+
+    @alignment_type.setter
+    def alignment_type(self, value: str):
+        self.set_property_state("alignment_type", value)
+
+    @property
+    def singular_value_tolerance(self) -> RealType:
+        """Tolerance used to compare singular values"""
+        return self.get_property_state("singular_value_tolerance")
+
+    @singular_value_tolerance.setter
+    def singular_value_tolerance(self, value: RealType):
+        self.set_property_state("singular_value_tolerance", value)
+
+    @property
+    def verbosity(self) -> int:
+        """Set to 1 to print additional information about the alignment"""
+        return self.get_property_state("verbosity")
+
+    @verbosity.setter
+    def verbosity(self, value: int):
+        self.set_property_state("verbosity", value)