Algorithm (Workflow)

This function, smbGetPortofFrame, is designed to retrieve the port name associated with a given frame name within a Simulink subsystem. The function is part of the SimMechanics library and was created by Tim Lueth in November 2016.

Input Parameters

• FName: This is the name of the frame within a subsystem for which the port name is to be retrieved.

Output Results

• PName: This is the name of the port in the current system that corresponds to the given frame name.

Algorithm Steps

1. The function begins by calling smbGetAllPorts(gcs), which retrieves all ports in the current system. The function returns three outputs, but only the third output, c, is used in this function.
2. c is expected to be a cell array where each row contains information about a port. The third column of each row contains the frame name associated with that port.
3. An empty variable PName is initialized to store the port name if a match is found.
4. A for loop iterates over each row of c:
• For each row, the function checks if the frame name FName is a substring of the third column of that row using strfind.
• If a match is found, PName is set to the value in the first column of that row, which is the port name.
5. After the loop, if PName is not empty, the function removes the current system's name from PName using strrep. This is done to ensure that the port name is relative to the current system.
6. The function returns PName as the output.

Example Usage

To demonstrate the function, the example provided shows how to retrieve the port name for the frame 'WORLD.ORIGIN' in a system named 'test_smb_lib':

smbNewSystem('test_smb_lib');
smbGetPortofFrame('WORLD.ORIGIN');