FhSim  3.1.0
Marine systems simulation
Loading...
Searching...
No Matches
Cable branched attractor

Class containing a cable object with the ability to be branched.

+ Collaboration diagram for Cable branched attractor:
Author
Karl-Johan Reite
Date
24.07.2007 KJR: Initial version.
   Simulates a cable object which is a collection of cable sections, which
again are collections of one or more cable elements. The main properties of this class are an arbitrary number of cable sections, connected by an arbitrary number of nodes, with an arbitrary number of external connections. The external connections are nodes where the position and velocity is governed by the input ports. The node numbers of these must be the lowest one, starting from zero and going up to the number of external nodes minus one.

Configuration parameters

It reads every parameter of Cable/Branched (CableBranched in fhsim_marine_elements: File, the geometry file, and the general options) and adds one.

Name Width Description
AttractorName 1 Name of the attractor that pulls the cable sections and the junction nodes, a shared resource made by Seine/Vessel. It must equal AttractorNameWarp of Seine/Vessel and of Seine/Operation, or AttractorNameNet for the net bin. No default; the name must exist when the model is assembled.
File 1 Path of the geometry file, as for Cable/Branched.

Input ports

The ports of Cable/Branched; no port is added.

Name Width Description
Pos1...Pos<NumExternalConnections> 3 Position of each external connection [m].
Vel1...Vel<NumExternalConnections> 3 Velocity of each external connection [m/s].
Length1...Length<NumCables> 1 Length of each cable section [m].

Output ports

Name Width Description
Force1...Force<NumExternalConnections> 3 Force on each external connection [N].
Tension1...Tension<NumExternalConnections> 1 Tension in the element connected to each external connection [N].
Length1...Length<NumCables> 1 The stretched length of each cable section [m].

Initial conditions

The states of Cable/Branched; the attractor adds none.

Full example file

FORMAT ILLUSTRATION, NOT A VALIDATED SEINE SCENARIO. The example wires a Y-shaped cable (two warps from the vessel fastenings to a net node, a bridle from there to a fixed net centre) into the objects of SeineOperation.xml; its geometry values are placeholders, not a calibrated seine. AttractorName must equal AttractorNameWarp of Seine/Vessel and AttractorNameWarp of Seine/Operation. The example is a copy of the regression input tests/in/SeineCable/SeineCable_in.xml, except for the step control: the regression input uses fixed steps of 10 ms so that one baseline holds on every platform, the example the adaptive StepControl.

<!--
FORMAT ILLUSTRATION, NOT A VALIDATED SEINE SCENARIO.
Shows how a Seine/Cable is wired into the Danish-seining objects of SeineOperation.xml:
its BranchedCable geometry file (SeineCableGeometry.xml, Y topology: two warps from the
vessel fastenings to a net node, and a bridle from there to the net centre), the vessel
fastenings driving the warp ends, and the warp attractor shared by name. The geometry
values are placeholders chosen by the model owner, not a calibrated seine (FISH-0017).
The attractor name is one string under two parameter names: Seine/Vessel publishes
it as AttractorNameWarp, Seine/Operation reads it as AttractorNameWarp too (its old
name AttractorNameWarps still works), and the Seine/Cable reads it as AttractorName.
The net centre is held still at a constant position; nothing here models the net.
-->
<Contents>
<OBJECTS>
<Lib
LibName = "environment"
SimObject = "Environment"
Name = "Env"
Waves.Model = "Component"
Waves.NumWaves = "0"
Bathymetry.Depth = "190"
Current.Model = "Constant"
Current.Vector = "0,0,0"
/>
<Lib
LibName = "fishery"
SimObject = "Seine/Vessel"
Name = "V"
Length = "70"
Breadth = "14"
Draught = "7"
NumWarps = "2"
ApSpeed = "0.1"
InitialSpeed = "2"
InitialHeading = "0"
AttractorNameNet = "NetBin"
AttractorNameWarp = "WarpAttr"
/>
<Lib
LibName = "fishery"
SimObject = "Seine/Operation"
Name = "Op"
WarpLength = "500"
MinWarpLength = "60"
WinchHaulSpeed = "0.5"
SetSpeed = "4.0"
InitialSpeed = "4.0"
TowSpeed = "2.0"
HaulSpeed = "0.5"
FinishedSpeed = "0.5"
SpreadAngle = "60"
InitialHeading = "0"
TowHeading = "0"
AddedTrackLength = "50"
TensionFilterTimeConstant = "10"
AttractorNameNet = "NetBin"
AttractorNameWarp = "WarpAttr"
/>
<Lib
LibName = "fishery"
SimObject = "Seine/Buoy"
Name = "B"
/>
<Lib
LibName = "fishery"
SimObject = "Seine/Cable"
Name = "C"
File = "../examples/input/fishery/SeineCableGeometry.xml"
AttractorName = "WarpAttr"
/>
</OBJECTS>
<INTERCONNECTIONS>
<Connection
B.Pos1 = "10, 0, 0"
B.Vel1 = "1, 0, 0"
B.Pos2 = "-10, 0, 0"
B.Vel2 = "-1, 0, 0"
B.Connected = "Op.WarpConnectedVessel"
Op.NetPWingPos = "-50, -25, -10"
Op.NetSWingPos = "-50, 25, -10"
Op.NetVel = "1, 0, 0"
Op.PBridlePos = "-30, -15, -10"
Op.SBridlePos = "-30, 15, -10"
Op.PBridleTension = "20000"
Op.SBridleTension = "20000"
Op.VesselPos = "V.Pos"
V.Heading = "Op.VesselHeading"
V.Vel = "Op.VesselSpeed"
C.Pos1 = "V.WarpPos1"
C.Vel1 = "V.WarpVel1"
C.Pos2 = "V.WarpPos2"
C.Vel2 = "V.WarpVel2"
C.Pos3 = "-285, 0, 10"
C.Vel3 = "0, 0, 0"
C.Length1 = "Op.PWarpLength"
C.Length2 = "Op.SWarpLength"
C.Length3 = "50"
/>
</INTERCONNECTIONS>
<INITIALIZATION>
<InitialCondition
V.Pos = "0,0"
V.Heading = "0"
C.Pos_4 = "-235, 0, 10"
C.Vel_4 = "0, 0, 0"
/>
</INITIALIZATION>
<SIMULATION>
<Timing TStart="0" TEnd="60"/>
<Integrator Method="RK45_i" NumCores="1">
<StepControl StepMax="0.05" StepMin="1e-8" AbsTol="1e-3" RelTol="1e-3"/>
</Integrator>
</SIMULATION>
<OBSERVERS>
<!-- The first output time is 1, where the baseline starts; Op.BuoyPos is zero until the first step latches it (FISH-0024). -->
<FileOutput
TOutput = "1:1:60"
Select = "objects:all"/>
</OBSERVERS>
</Contents>

This SimObject is referred to as Seine/Cable