Engee documentation

Mass

Ideal mechanical mass.

blockType: AcausalFoundation.Mechanical.Translational.Elements.Mass

mass 1

Path in the library:

/Physical Modeling/Fundamental/Mechanical/Translational/Elements/Mass

Description

Block Mass represents the ideal mechanical mass, which is described by the following equation:

Where

  • — force of inertia;

  • — mass;

  • — speed;

  • — Time.

By default, the unit has one mechanical translational port. The positive direction of the block is from the port to the control point. This means that the inertial force is positive if the mass is accelerated in a positive direction.

In some applications, it is customary to display the mass sequentially with other elements in the flowchart. To support this use case, the parameter Number of graphical ports allows you to use the second port.

The dual-port option is exclusively graphical: both ports have the same speed, so the unit functions the same regardless of whether it has one or two ports. The block icon changes depending on the parameter value Number of graphical ports.

Number of graphics ports Block icon

1

mass 1

2

mass 2

Variables

Use the parameter group Initial Targets to set the priority and initial target values for the block parameter variables before simulation. For more information, see Configuring physical blocks using target values.

Ports

Conserving

# M — the port connecting the unit to the network
translational mechanics

Details

A mechanical translational port that connects the mass to the physical network.

Program usage name

flange_reference_a

# N — the second graphic port
translational mechanics

Details

The second mechanical port for maintaining translational motion, which allows you to connect the mass sequentially with other elements in the flowchart. This port is connected to the M port, so the difference between one- and two-port block representations is purely graphical.

Dependencies

To use this port, set the parameter Number of graphical ports value 2.

Program usage name

flange_reference_b

Parameters

Parameters

# Mass — weight
kg | mg | g | t | lbm | oz | slug

Details

The value of the mass. The mass remains constant during the simulation.

Units

kg | mg | g | t | lbm | oz | slug
Default value

1.0 kg
Program usage name

mass
Evaluatable

Yes

# Number of graphical ports — number of graphics ports
1 | 2

Details

Number of graphics ports:

  • 1 — the unit has one port that connects it to a mechanical translational circuit. When the unit has one port, connect it to the connecting line between the other two units.

  • 2 — when this option is selected, the second port opens, which allows you to connect the unit in series with other units in the circuit. The two ports are connected and have the same speed, so the unit functions exactly as if it had one port.

Values

1 | 2
Default value

1
Program usage name

flange_count
Evaluatable

No

Examples