LIBRARY

PlanarMechanics.PrescribedVelocity

Prescribed velocity of frame_b via input connectors.

The absolute velocity of frame_b is driven by the two real inputs v_x, v_y, resolved in the planar world frame. Position is obtained by integrating the velocity inputs starting from r_start.

When fixed_orientation is true, the rotation angle is locked to zero. When false, no orientation constraint is imposed and no torque is applied — the orientation must be determined by connected components.

Usage

MultibodyComponents.PlanarMechanics.PrescribedVelocity(r_start=[0, 0])

Parameters:

Name	Description	Units	Default value
fixed_orientation		–	true
statePriority		–	2
r_start	Initial position vector from world frame to frame_b, resolved in world frame	m	[0, 0]

Connectors

• frame_b - Coordinate system (2-dim.) fixed to the component with one cut-force and cut-torque.

All variables are resolved in the planar world frame. (Frame2D)

• v_x - This connector represents a real signal as an input to a component (RealInput)

• v_y - This connector represents a real signal as an input to a component (RealInput)

Variables

Name	Description	Units
r	Position vector from world frame to frame_b, resolved in world frame	m
v	Absolute velocity of frame_b, resolved in world frame	m/s
a	Absolute acceleration of frame_b, resolved in world frame	m/s2

Behavior

Dict{MIME{Symbol("text/plain")}, String} with 1 entry: MIME type text/plain => "Error displaying result"

Source

"""
Prescribed velocity of `frame_b` via input connectors.

The absolute velocity of `frame_b` is driven by the two real inputs `v_x`, `v_y`,
resolved in the planar world frame. Position is obtained by integrating the
velocity inputs starting from `r_start`.

When `fixed_orientation` is true, the rotation angle is locked to zero.
When false, no orientation constraint is imposed and no torque is applied —
the orientation must be determined by connected components.
"""
component PrescribedVelocity
  frame_b = Frame2D() {
    "Dyad": {
      "placement": {
        "diagram": {"iconName": "default", "x1": 900, "y1": 450, "x2": 1000, "y2": 550, "rot": 0}
      },
      "tags": []
    }
  }
  v_x = RealInput() {
    "Dyad": {
      "placement": {
        "diagram": {"iconName": "default", "x1": -50, "y1": 250, "x2": 50, "y2": 350, "rot": 0}
      },
      "tags": []
    }
  }
  v_y = RealInput() {
    "Dyad": {
      "placement": {
        "diagram": {"iconName": "default", "x1": -50, "y1": 650, "x2": 50, "y2": 750, "rot": 0}
      },
      "tags": []
    }
  }
  structural parameter fixed_orientation::Boolean = true
  structural parameter statePriority::Integer = 2 # Higher than plain body variables so that the initialized, prescribed variables become the selected states
  "Initial position vector from world frame to frame_b, resolved in world frame"
  parameter r_start::Position[2] = [0, 0]
  "Position vector from world frame to frame_b, resolved in world frame"
  variable r::Position(statePriority = statePriority, initial = r_start)[2]
  "Absolute velocity of frame_b, resolved in world frame"
  variable v::Velocity[2]
  "Absolute acceleration of frame_b, resolved in world frame"
  variable a::Acceleration[2]
relations
  v = [v_x, v_y]
  frame_b.x = r[1]
  frame_b.y = r[2]
  der(r) = v
  a = der(v)
  if fixed_orientation
    frame_b.phi = 0
  else
    frame_b.tau = 0
  end
metadata {
  "Dyad": {
    "icons": {"default": "dyad://MultibodyComponents/PrescribedVelocity.svg"},
    "labels": [
      {
        "label": "$(instance)",
        "x": 500,
        "y": 150,
        "rot": 0,
        "attrs": {"font-size": "160"}
      }
    ]
  }
}
end

Flattened Source

"""
Prescribed velocity of `frame_b` via input connectors.

The absolute velocity of `frame_b` is driven by the two real inputs `v_x`, `v_y`,
resolved in the planar world frame. Position is obtained by integrating the
velocity inputs starting from `r_start`.

When `fixed_orientation` is true, the rotation angle is locked to zero.
When false, no orientation constraint is imposed and no torque is applied —
the orientation must be determined by connected components.
"""
component PrescribedVelocity
  frame_b = Frame2D() {
    "Dyad": {
      "placement": {
        "diagram": {"iconName": "default", "x1": 900, "y1": 450, "x2": 1000, "y2": 550, "rot": 0}
      },
      "tags": []
    }
  }
  v_x = RealInput() {
    "Dyad": {
      "placement": {
        "diagram": {"iconName": "default", "x1": -50, "y1": 250, "x2": 50, "y2": 350, "rot": 0}
      },
      "tags": []
    }
  }
  v_y = RealInput() {
    "Dyad": {
      "placement": {
        "diagram": {"iconName": "default", "x1": -50, "y1": 650, "x2": 50, "y2": 750, "rot": 0}
      },
      "tags": []
    }
  }
  structural parameter fixed_orientation::Boolean = true
  structural parameter statePriority::Integer = 2 # Higher than plain body variables so that the initialized, prescribed variables become the selected states
  "Initial position vector from world frame to frame_b, resolved in world frame"
  parameter r_start::Position[2] = [0, 0]
  "Position vector from world frame to frame_b, resolved in world frame"
  variable r::Position(statePriority = statePriority, initial = r_start)[2]
  "Absolute velocity of frame_b, resolved in world frame"
  variable v::Velocity[2]
  "Absolute acceleration of frame_b, resolved in world frame"
  variable a::Acceleration[2]
relations
  v = [v_x, v_y]
  frame_b.x = r[1]
  frame_b.y = r[2]
  der(r) = v
  a = der(v)
  if fixed_orientation
    frame_b.phi = 0
  else
    frame_b.tau = 0
  end
metadata {
  "Dyad": {
    "icons": {"default": "dyad://MultibodyComponents/PrescribedVelocity.svg"},
    "labels": [
      {
        "label": "$(instance)",
        "x": 500,
        "y": 150,
        "rot": 0,
        "attrs": {"font-size": "160"}
      }
    ]
  }
}
end

Test Cases

No test cases defined.

Related

• Examples

• Experiments

• Analyses

• Tests

  • PrescribedVelocityTest