$
$@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
$@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
$@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
$
$            ---------    incline command file   --------
$
$.d This command file is used to collect and reduce the data during an
$.d inclining experiment. To use it, you should also fill out the
$.d accompanying incline.dat template.
$.d
$.d The idea here is that you fill out the template with the "fixed"
$.d data and then enter the data as it is taken. The data entry and
$.d reduction are accomplished with the following commands:
$.d
$.d      INIT_CON DM1 D1 RM2 D2 .... -TANKS ST1 S1 ST2 S2 ...
$.d
$.d      MV_WEIGHT WN1 X1 Y1 Z1  WN2 X2 Y2 Z2 .....
$.d
$.d      SOUND ST1 S1 ST2 S2 .....
$.d
$.d      P_READ PN1 R1 PN2 R2 .....
$.d
$.d      EVENT ACTION
$.d
$.d      REPORT TYPE -OPTIONS
$.d
$.d The first of these is "unique" in that it should be issued
$.d once at the beginning of the experiment. Here, dm1, dm2, ...
$.d are the names of draft marks and d1, d2, .... are the corresponding
$.d drafts. After the -TANKS option, you need to define the
$.d soundings for any tanks which will be used to accomplish the
$.d incline. Here, st1, st2, ... are the names of the sounding
$.d tubes and s1, s2, ... are the corresponding soundings.
$.d
$.d The three commands MV_WEIGHT, SOUND, and P_READ are used
$.d to define the location of the weights, the sounding and the
$.d pendula readings. They all operate similarly in that they can be
$.d used to edit the existing readings, list the current readings, etc.
$.d For example consider:
$.d
$.d      p_read one 5 two 10 three 8
$.d
$.d which defines the readings for three pendula. After the command
$.d is entered, one receives a list of the input so that it can be
$.d checked. Suppose that you really wanted 7.5 as a reading for
$.d pendulum three. It can be changed with
$.d
$.d      p_read three 8
$.d
$.d so that you do not need to re-enter the "good" data.
$.d
$.d After the current "event" is defined, you move to the next
$.d event with
$.d
$.d      EVENT NEXT
$.d
$.d By event, we mean a condition of the vessel which is
$.d completely defined by the location of the weights, the
$.d pendula readings, and the soundings. This command will
$.d Give you an output of the current event, and you are now
$.d ready to move the weights and/or ballast water and tank
$.d new readings. This command will give you a "status" of
$.d the system at the current event. This is a standard MOSES
$.d &STATUS B_W report which shows the ballast in the tanks,
$.d the location of the weights, any other weight included,
$.d and the buoyancy. The KG of the "light ship" shown here
$.d is at 0. The macro will automatically correct this to
$.d the proper height knowing the angle.
$.d
$.d Also, after the first EVENT NEXT, you have
$.d an estimate of the kg based on the data taken and a
$.d history of the incline which are available for inspection.
$.d The REPORT command gives you a look at the history of
$.d the incline. There are four valid values for TYPE:
$.d KG, PEND, WEIGHT, and SOUND, and the only valid options are
$.d -HARD, -PLOTS, and -REPORTS. With no options, a REPORT of the
$.d data vs event will be printed to the terminal and a plot of
$.d the data vs event will be written to the terminal. If you want
$.d this data archived, use the -HARD option to direct it to
$.d the output file and the graphics device file. If you only want
$.d the summary or the plot, use either -PLOTS or -REPORTS to get
$.d one or the other.
$.d
$.d Of the four types of reports, there are actually two classes.
$.d The results with PEND and SOUND are really input summaries
$.d across the experiment, and KG and WEIGHT are the results.
$.d The results for KG and WEIGHT are basically those that result
$.d from the readings for each event - EXCEPT that the KG at
$.d event 0 is the "best fit" kg to to data. A plot of this will
$.d have the best fit as a horizontal line extending from where
$.d the curve intersects the Y axis.
$
$
$@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
$@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
$@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
$
$
$****************************************          basic parameters
$
&device -oecho no  -primary screen -mecho no
$
$****************************************          read model
$
inmodel
$
$****************************************          set up
$
incline
$
$****************************************          set up
$
incl_init ready
$
$****************************************          Now Interactive
$
$
$****************************************          all done
$
