Bug fix platform.setPosition(update_moorings=False)

- re-calculate and reset span when update_moorings=False for platform.setPosition to ensure it is unloaded properly
- some small mooring README updates

Author: lsirkis

famodel/mooring/README.md

@@ -38,7 +38,7 @@ includes a design dictionary with the following details:
 		- v : volume [kg/m^3]
 		- CdA 
 
-The Mooring object contains subcomponent objects that represent each component of the full mooring line. Line segments are Section objects, while connectors between segments and at the ends of the lines are Connector objects. These segments alternate, and are listed in the subcomponents section of the design dictionary in order from end A to end B. If there are parallel sections, such as in the case of a bridle, the parallel sections are described with nested lists.
+The Mooring object contains subcomponent objects that represent each component of the full mooring line. Line segments (lengths of a mooring line with one material) are Section objects, while connectors between segments and at the ends of the lines are Connector objects. These components alternate, and are listed in the subcomponents section of the design dictionary in order from end A to end B. If there are parallel sections, such as in the case of a bridle, the parallel sections are described with nested lists.
 
 ## Mooring Properties
 - dd
@@ -60,15 +60,21 @@ The Mooring object contains subcomponent objects that represent each component o
 - rA : end A absolute coordinates
 - rB : end B absolute coordinates
 - heading : compass heading from B to A
-- ss : MoorPy subsystem representation of this Mooring, pristine
-- ss_mod : modified MoorPy subsystem of thie Mooring, could have marine growth etc
+- ss : MoorPy subsystem representation of this Mooring
 - span : 2D (x-y) distance from fairlead to anchor or fairlead to fairlead. If bridles, the distance is calculated from the midpoint of all bridle fairlead points
 - adjuster : custom function that can adjust mooring
 - shared : int for anchored line (0), shared line (1) or half of a shared line (2)
 - symmetric : boolean for if the mooring line is symmetric shared line
+- parallels : boolean for if there are any parallel sections (for example: bridles) in the mooring
+- i_con : indices of connectors in the subcomponents list property
+- i_sec : indices of sections in the subcomponents list property
 - rho : water density
 - g : acceleration due to gravity
 - envelopes : 2D motion envelopes, buffers, etc.
+- loads : 
+- safety_factors : dictionary of safety factor values based on material MBL and line loads from loads dictionary
+- env_impact : dictionary quantifying environmental impact factors such as disturbedSeabedArea for total seabed disturbance area
+- applied_states : dictionary keeping track of which states have been applied to the mooring line model, such as marine growth (marine_growth), creep, and corrosion. These states are automatically updated when mooring.updateState, setCreep, setCorrosion, addMarineGrowth are called
 - reliability : dictionary of reliability information on the line
 - cost : dictionary of line costs
 - failure_probability : dictionary of failure probabilities

famodel/mooring/mooring.py

@@ -84,7 +84,7 @@ def __init__(self, dd=None, subsystem=None, anchor=None,
 
         # MoorPy subsystem that corresponds to the mooring line
         self.ss = subsystem
-        self.ss_mod = None
+
         # workaround for users who are making mooring objects based on pre-existing subsystems
         if self.ss and not self.dd:
             self.dd = {}

famodel/platform/platform.py

@@ -114,9 +114,17 @@ def setPosition(self, r, heading=None, degrees=False,project=None, update_moorin
                     # headings = [cab.subcomponents[0].headingA + pf_phis[0], cab.subcomponents[-1].headingB + pf_phis[1]]
 
                     # reposition the cable
-                    cab.reposition(project=project)
-            
+                    cab.reposition(project=project)            
+                    
         self.updateMooringPoints()
+        
+        if not update_moorings:
+            # update span in case it changed if pf location changes but anchor does not 
+            for i, att in enumerate(self.attachments):
+                if isinstance(self.attachments[att]['obj'], Mooring):
+                    moor = self.attachments[att]['obj']
+                    moor.dd['span'] = np.linalg.norm(moor.rA[:2]-moor.rB[:2])
+                    moor.span=moor.dd['span']
 
     def mooringSystem(self,rotateBool=0,mList=None,bodyInfo=None, project=None):
         '''