← Back to ControllerToLocal_MiddleLevelCouplingBasis documentation

ControllerToLocal_MiddleLevelCouplingBasis - Source Code

File: Distributed_Design_Optimizer/middlelevel/ControllerToLocal_MiddleLevelCouplingBasis.py

# Copyright (C) The DistributedDesignOptimizer Contributors
# Licensed under the GNU General Public License v3.0. See LICENSE file for details.
"""Controller -> Local Middle-level coupling basis module.

This module provides the base class for middle-level coupling parameters
from controller to local subsystem in distributed optimization.
"""

from Distributed_Design_Optimizer.middlelevel import LocalController_MiddleLevelCouplingBasis


class ControllerToLocal_MiddleLevelCouplingBasis(LocalController_MiddleLevelCouplingBasis):

    """Holds the coupling parameters from controller to a local subsystem.

    It stores the identifier of the neighbor and stores the coupling variables.
    """

    def __init__(self) -> None:
        """Initialize the controller -> local middle level coupling basis.

        The neighbor identifier is fixed to "C" (the controller).
        """
        super().__init__(id="C")

    def update_state(self, other_middlelevelcoupling: 'ControllerToLocal_MiddleLevelCouplingBasis') -> None:
        """Update the state of this ControllerToLocal_MiddleLevelCouplingBasis from another instance.

        This method is necessary for multiprocessing. When subsystems are executed
        in parallel processes via Parallel.py, the original objects need to
        be updated with results from the executed copies. This method preserves
        the memory address of the object's attributes while updating their values.

        Args:
            other_middlelevelcoupling: The source instance containing updated values to copy from.

        Note on copy operations:
            - _id (str): No copy.copy() needed - str is immutable in Python.
              Assigning creates a new binding; the original cannot be modified.
        """

        super().update_state(other_middlelevelcoupling=other_middlelevelcoupling)