Source code for loads.composition_acceleration.api.composition_acceleration_api

import typing
from more.api.simulation.load_cases.load_setup import LoadSetup, TranslationSettableMixin
from more.api.utils.interface_registries import register_api_implementation
from more.loads.composition_acceleration import CompositionAcceleration
from more import log

log.init_logging()
logger = log.getLogger(__name__)

def _composition_acceleration_api_setup(api):
    simulation_setup = api.create_simulation_setup()
    lcc_setup = simulation_setup.create_load_case_container_setup().set_name(name='Example LCC')
    lc_setup = lcc_setup.create_load_case_setup(lc_type='Mechanical load case').set_name(name='Example LC')
    return lc_setup.create_load_setup(load_type='Composition acceleration')




@register_api_implementation(core_class=CompositionAcceleration)
class CompositionAccelerationSetup(LoadSetup, TranslationSettableMixin):
    """ The API handler for composition accelerations

    The following example shows how to create a composition acceleration using the API, it is assumed that these steps were performed
    in each of the examples for other methods in this class.

    .. admonition:: Example
        :class: note

        ..
            >>> import more.project
            >>> proj = more.project.Project()

        >>> from more.api import ApiGateway
        >>> api = ApiGateway(proj=proj)
        >>> simulation_setup = api.create_simulation_setup()
        >>> lcc_setup = simulation_setup.create_load_case_container_setup().set_name(name='Example LCC')
        >>> lc_setup = lcc_setup.create_load_case_setup(lc_type='Mechanical load case').set_name(name='Example LC')
        >>> composition_acceleration_setup = lc_setup.create_load_setup(load_type='Composition acceleration')

        ..
            >>> isinstance(composition_acceleration_setup, CompositionAccelerationSetup)
            True
            >>> isinstance(composition_acceleration_setup._load, CompositionAcceleration)
            True

    The next example shows how to get an API object for an already existing load.

    .. admonition:: Example
        :class: note

        ..
            >>> import more.project
            >>> proj = more.project.Project()

        >>> from more.api import ApiGateway
        >>> api = ApiGateway(proj=proj)
        >>> simulation_setup = api.create_simulation_setup()
        >>> lcc_setup = simulation_setup.create_load_case_container_setup().set_name(name='Example LCC')
        >>> lc_setup = lcc_setup.create_load_case_setup(lc_type='Mechanical load case').set_name(name='Example LC')

        ..
            >>> composition_acceleration_setup = lc_setup.create_load_setup(load_type='Composition acceleration')

        >>> composition_acceleration_setup = lc_setup.get_load_setup(index=0) # The load under this index must already exist

        ..
            >>> isinstance(composition_acceleration_setup, CompositionAccelerationSetup)
            True
            >>> isinstance(composition_acceleration_setup._load, CompositionAcceleration)
            True


        """



    def set_u(self, value: float) -> 'CompositionAccelerationSetup':
        """ Sets the 'u' value of the load vector

        See example at the top for how to create a composition acceleration setup object

        .. admonition:: Example
            :class: note

            ..
                >>> import more.project
                >>> proj = more.project.Project()
                >>> from more.api import ApiGateway
                >>> api = ApiGateway(proj=proj)
                >>> composition_acceleration_setup = _composition_acceleration_api_setup(api)

            >>> composition_acceleration_setup = composition_acceleration_setup.set_u(value=10)

            ..
                >>> composition_acceleration_setup._load.generalized_force_vector.u == 10
                True
                >>> composition_acceleration_setup.set_u(value='wrong value')
                Traceback (most recent call last):
                ...
                TypeError: ...


        Returns
        -------
        self: CompositionAccelerationSetup

        Raises
        ------
        TypeError
            Raised if the supplied value is not a floating point number

        """
        self.set_dof_dict(dof_values_dict={'u': value})
        return self




    def set_v(self, value: float) -> 'CompositionAccelerationSetup':
        """ Sets the 'v' value of the load vector

        See example at the top for how to create a composition acceleration setup object

        .. admonition:: Example
            :class: note

            ..
                >>> import more.project
                >>> proj = more.project.Project()
                >>> from more.api import ApiGateway
                >>> api = ApiGateway(proj=proj)
                >>> composition_acceleration_setup = _composition_acceleration_api_setup(api)

            >>> composition_acceleration_setup = composition_acceleration_setup.set_v(value=10)

            ..
                >>> composition_acceleration_setup._load.generalized_force_vector.v == 10
                True
                >>> composition_acceleration_setup.set_v(value='wrong value')
                Traceback (most recent call last):
                ...
                TypeError: ...


        Returns
        -------
        self: CompositionAccelerationSetup

        Raises
        ------
        TypeError
            Raised if the supplied value is not a floating point number

        """
        self.set_dof_dict(dof_values_dict={'v': value})
        return self




    def set_w(self, value: float) -> 'CompositionAccelerationSetup':
        """ Sets the 'w' value of the load vector

        See example at the top for how to create a composition acceleration setup object

        .. admonition:: Example
            :class: note

            ..
                >>> import more.project
                >>> proj = more.project.Project()
                >>> from more.api import ApiGateway
                >>> api = ApiGateway(proj=proj)
                >>> composition_acceleration_setup = _composition_acceleration_api_setup(api)

            >>> composition_acceleration_setup = composition_acceleration_setup.set_w(value=10)

            ..
                >>> composition_acceleration_setup._load.generalized_force_vector.w == 10
                True
                >>> composition_acceleration_setup.set_w(value='wrong value')
                Traceback (most recent call last):
                ...
                TypeError: ...


        Returns
        -------
        self: CompositionAccelerationSetup

        Raises
        ------
        TypeError
            Raised if the supplied value is not a floating point number

        """
        self.set_dof_dict(dof_values_dict={'w': value})
        return self




    def set_dof_dict(self, dof_values_dict: typing.Dict[str, float]) -> 'CompositionAccelerationSetup':
        """ Sets the values of the load vector to those given in the dictionary

        See example at the top for how to create a composition acceleration setup object

        .. admonition:: Example
            :class: note

            ..
                >>> import more.project
                >>> proj = more.project.Project()
                >>> from more.api import ApiGateway
                >>> api = ApiGateway(proj=proj)
                >>> composition_acceleration_setup = _composition_acceleration_api_setup(api)

            >>> composition_acceleration_setup = composition_acceleration_setup.set_dof_dict(dof_values_dict={'u': 5, 'v': 2.0})

            ..
                >>> composition_acceleration_setup._load.generalized_force_vector.u == 5
                True
                >>> composition_acceleration_setup._load.generalized_force_vector.v == 2.0
                True
                >>> composition_acceleration_setup.set_dof_dict(dof_values_dict={'u': 'wrong value'})
                Traceback (most recent call last):
                ...
                TypeError: ...
                >>> composition_acceleration_setup.set_dof_dict(dof_values_dict={'wrong dof': 10})
                Traceback (most recent call last):
                ...
                more.api.exceptions.api_exception.NameNotFoundError: ...


        Returns
        -------
        self: CompositionAccelerationSetup

        Raises
        ------
        TypeError
            Raised if the supplied value is not a floating point number
        NameNotFoundError
            Raised if a key in the supplied dictionary is not a recognized dof

        """
        self._load.generalized_force_vector.set_dof_dict(dof_values_dict=dof_values_dict)
        return self




    def set_dof(self, dof_name, value) -> 'CompositionAccelerationSetup':
        """ Sets the value of an element of the DOF vector

        See example at the top for how to create the setup object

        .. admonition:: Example
            :class: note

            ..
                >>> import more.project
                >>> proj = more.project.Project()
                >>> from more.api import ApiGateway
                >>> api = ApiGateway(proj=proj)
                >>> composition_acceleration_setup = _composition_acceleration_api_setup(api)

            >>> composition_acceleration_setup = composition_acceleration_setup.set_dof(dof_name='v', value=10)

            ..
                >>> composition_acceleration_setup._load.generalized_force_vector.v == 10
                True
                >>> composition_acceleration_setup.set_dof(dof_name='v', value='wrong value')
                Traceback (most recent call last):
                ...
                TypeError: ...
                >>> composition_acceleration_setup.set_dof(dof_name='wrong dof', value=10)
                Traceback (most recent call last):
                ...
                more.api.exceptions.api_exception.NameNotFoundError: ...


        Returns
        -------
        self: CompositionAccelerationSetup

        Raises
        ------
        TypeError
            Raised if the supplied value is not a floating point number
        NameNotFoundError
            Raised if the given name is not a recognized DOF

        """
        return self.set_dof_dict(dof_values_dict={dof_name: value})