;;
;;  $RCSfile$ $Revision$ $State$
;;
;;  trk_sea_veh.rdr
;;  Descriptions of vehicles for wave response and sinking.
;;


;; Notes on wave response fields:
;; i.e. z_w0, z_damp, etc.
;; All are optional, because all are (roughly) computable from mass & lengths.
;; For a given complex wave input, with time behaviour exp(-I*w*t), t is time,
;; Complex pole_response(w) =  1/((-I*w)**2 + (-I*w)*b + w0**2)
;;                          =  (w0**2 - w**2 + I*w*b)
;;                             /((w0**2 - w**2)**2 + (w*b)**2).
;;   where damp is roughly amplitude fraction lost in a cycle when not driven,
;;         b = damp*w0/Pi.
;; To turn off wave response, but still allow sinking, no_wave_response
;; may be set to 1.

;; Notes on sinking fields:
;; Units: MKS, and all angles are in radians.
;; Sinking occurs in 2 stages:
;; First the ship fills up with water, at the fractional rate
;; "fill_fraction_rate", until it becomes no longer bouyant.
;; "max_fill_fraction" specifies what fraction of the ship's volume may
;; take on water.  During this time the ship sinks slowly, based
;; on a simple bouyancy calculation.
;; Then the ship sinks, by accelerating to its terminal velocity in
;; the water, until it hits the ocean floor.
;; The angles "transition_roll_angle" and "transition_pitch_angle" specify
;; the orientation we would like the ship to have just before
;; it starts sinking.
;; The angles "final_roll_angle" and "final_pitch_angle" specify the 
;; orientation we would like the ship to have when it hits the ocean bottom.
;; Any of these target angles might not be reached, because
;; the rate of change of angle is limited by either
;; "max_roll_rate" or "max_pitch_rate", and ship might reach
;; the transition time or hit bottom to soon to reach the target angles.
;; The "drag_multiplier" modifies drag coefficient, from its
;; originally computed value, for the velocity friction force, affecting
;; falling through the water.
;; A larger drag_multiplier will furthur slow the ship's falling in the water.
;; An extra_z_floor value may be provided, to be added to the externally 
;; derived ocean floor, in case the ship's model bottom will not otherwise
;; end at a reasonable depth.
;; To turn off sinking, just set max_fill_fraction to zero.

(

(
;; LABELS
(name		"vehicle_USMC_AAV")
(guise		 vehicle_USMC_AAV)
;; GENERAL
(mass		23044.1)
(width		3.32)
(length		7.92)
(height		3.32)
;; WAVE RESPONSE, resonant frequencies etc.
;(z_w0		)
(z_damp		12.0)
;(pitch_w0	)
(pitch_damp	12.0)
;(roll_w0	)
(roll_damp	12.0)
;(z_inertia	)
;(pitch_inertia	)
;(roll_inertia	)
(waterline	1.0) ; meters from the bottom of the entities bounding volume
;(no_wave_response 1)
;; SINKING
(max_fill_fraction	0.9 )
(fill_fraction_rate	0.1 )
(drag_multiplier	1.0 )
(transition_roll_angle	0.5 )
(transition_pitch_angle	0.2 )
(final_roll_angle	1.0 )
(final_pitch_angle	0.2 )
(max_roll_rate		0.2 )
(max_pitch_rate		0.1 )
(extra_z_floor		0.5 )
;(extra_z_out_offset	0.0 )
)

(
;; LABELS
(name		"vehicle_USMC_AAV_C7")
(guise		 vehicle_USMC_AAV_C7)
;; GENERAL
(mass		24070.6)
(width		3.3)
(length		8.2)
(height		2.9)
;; WAVE RESPONSE, resonant frequencies etc.
;(z_w0		)
(z_damp		10.0)
;(pitch_w0	)
(pitch_damp	10.0)
;(roll_w0	)
(roll_damp	10.0)
;(z_inertia	)
;(pitch_inertia	)
;(roll_inertia	)
(waterline	1.0) ; meters from the bottom of the entities bounding volume
;(no_wave_response 1)
;; SINKING
(max_fill_fraction	0.9 )
(fill_fraction_rate	0.1 )
(drag_multiplier	1.0 )
(transition_roll_angle	0.5 )
(transition_pitch_angle	0.2 )
(final_roll_angle	1.0 )
(final_pitch_angle	0.2 )
(max_roll_rate		0.2 )
(max_pitch_rate		0.1 )
(extra_z_floor		0.0 )
;(extra_z_out_offset	0.0 )
)

(
;; LABELS
(name		"vehicle_USMC_AAV_MINE")
(guise		 vehicle_USMC_AAV_MINE)
;; GENERAL
(mass		23663.0)
(width		3.26)
(length		8.13)
(height		3.29)
;; WAVE RESPONSE, resonant frequencies etc.
;(z_w0		)
(z_damp	    10.0)
;(pitch_w0	)
(pitch_damp 10.0)
;(roll_w0	)
(roll_damp  10.0)
;(z_inertia	)
;(pitch_inertia	)
;(roll_inertia	)
(waterline	1.0) ; meters from the bottom of the entities bounding volume
;(no_wave_response 1)
;; SINKING
(max_fill_fraction	0.9 )
(fill_fraction_rate	0.1 )
(drag_multiplier	1.0 )
(transition_roll_angle	0.5 )
(transition_pitch_angle	0.2 )
(final_roll_angle	1.0 )
(final_pitch_angle	0.2 )
(max_roll_rate		0.2 )
(max_pitch_rate		0.1 )
(extra_z_floor		0.5 )
;(extra_z_out_offset	0.0 )
)

(
;; LABELS
(name		"vehicle_USMC_AAV_REC")
(guise		 vehicle_USMC_AAV_REC)
;; GENERAL
(mass		23663.0)
(width		3.26)
(length		8.13)
(height		3.29)
;; WAVE RESPONSE, resonant frequencies etc.
;(z_w0		)
(z_damp	    10.0)
;(pitch_w0	)
(pitch_damp 10.0)
;(roll_w0	)
(roll_damp  10.0)
;(z_inertia	)
;(pitch_inertia	)
;(roll_inertia	)
(waterline	1.0) ; meters from the bottom of the entities bounding volume
;(no_wave_response 1)
;; SINKING
(max_fill_fraction	0.9 )
(fill_fraction_rate	0.1 )
(drag_multiplier	1.0 )
(transition_roll_angle	0.5 )
(transition_pitch_angle	0.2 )
(final_roll_angle	1.0 )
(final_pitch_angle	0.2 )
(max_roll_rate		0.2 )
(max_pitch_rate		0.1 )
(extra_z_floor		0.0 )
;(extra_z_out_offset	0.0 )
)



)