Marine Engineering Specialists -- Bentley Systems has acquired Ultramarine's MOSES Software [ Press Release ]
Incline Template
This command file is used to collect and reduce the data during an inclining experiment. To use it, you should also fill out the accompanying incline.dat template. You should use the browser to copy the basic templates to a working directory.

Here we will describe what data is necessary in the data file and then discuss how to use the incline command template.

INCLINE.DAT:

Define Basic Data:

Here, you define the name of the data file containing the data for the vessel to be inclined and the name of the body given to the vessel in the data file. The body name is specified by setting the variable i_body below. 
    $
    $
    $****************************************          vessel to incline
    $
    &insert p110.dat
    $
    $****************************************          define name
    $
    &set i_body =
    $
    $****************************************          define title
    $
    &title Incline of %i_body
    $
    $****************************************          set dimensions
    $
    &dimen -dimen  feet kips

Define Movable Weights:

Here, you define the movable weights with the variable m_weights. You simply add a call to the m_weight macro for each movable weight you have. For example 
      m_weight one 25
Here, one is the name of the weight and 25 is its weight in kips (tonnes). You will be asked later for the location of each weight by name as the incline progresses. If you have no weights, leave leave the one call blank.

Define tanks for Incline:

Here, you define the tanks which will be used during the incline. You simply add a call to the i_tank for each tank in which you will change the ballast during the incline. For example, 
     i_tank pc1 1pc1 100 -50 00 100 -50 20 \
                2pc1 110 -50 00 110 -50 20 \
                3pc1 100 -30 00 100 -30 20
 
     i_tank sc1 1sc1 100  50 00 100  50 20 \
                2sc1 110  50 00 110  50 20 \
                3sc1 100  30 00 100  30 20
Here, pc1 is the name of the tank to be used and the remainder defines the ends of the sounding tubes. The data for each tube is a name, the x, y, z coordinates of the bottom of the tube followed by the x, y, z coordinates of the top of the tube. You can have as many tubes as you desire and the names of the tubes can be anything you wish, but you will later be queried for reading of the tubes by name. Also, The first tube defined is the "primary" tube and its data will take precedence over the data of the others. If you have no tanks, leave leave the one call blank, otherwise fill it out correctly and add calls for any other tanks.

Define Pendula for Incline:

Here, you define the pendula which will be used during the incline. You simply add a call to the i_pendulum macro for each pendulum you have. For example 
      i_pendulum one 30
Here, one is the name of the pendulum and 30 is its length in feet or meters. You will be asked later for the angle of each pendulum by name as the incline progresses.

Define Weights for Incline:

Here, you define any weights on the vessel during the incline which are: 1) Not included in you vessel model, and 2) which are not part of what will be called the Light Ship of the vessel.

You simply add a call to the e_weight macro for each pendulum you have. For example 

      e_weight Gary .180 200, -30 25
Here, Gary is the name of a person, .180 is his weight in kips (tonnes), 200, -30, and 25 are the x, y,z coordinates of his location. If you have no extra weights, leave leave the one call blank.

Define tanks with fluids:

Here, you specify any tanks will fluid in them during the incline. (excluding those which will be used to do the inclining and defined above). To do this, specify the tank name, its sounding (feet or meters), and the specific gravity of its contents after the equal sign for each tank with fluid in the line 
   &set f_tanks =

Define ignored Load Groups:

Here, you specify any load groups in the model which you want to ignore by filling out their names in: 
   &set lg_ignore =
In particular, if you have a light weight defined, be sure to ignore it.

Define Water:

Here, you specify the specific gravity of the water in which the vessel is being inclined. If you are not in standard sea water, change the 1.028 in the line 
   ¶meter -spgwater 1.0256
to the proper value.

Define Draft Marks:

Here, you need to define the locations which will be used to define the initial position for the inclining if you have not done so in the data file. 
   &interest draft
   end

INCLINE.CIF:

The idea here is that you fill out the template with the "fixed" data and then enter the data as it is taken. The data entry and reduction are accomplished with the following commands: 
     INIT_CON DM1 D1 DM2 D2 .... -TANKS ST1 S1 ST2 S2 ...
 
     MV_WEIGHT WN1 X1 Y1 Z1  WN2 X2 Y2 Z2 .....
 
     SOUND ST1 S1 ST2 S2 .....
 
     P_READ PN1 R1 PN2 R2 .....
 
     EVENT ACTION
 
     REPORT TYPE -OPTIONS
The first of these is "unique" in that it should be issued once at the beginning of the experiment. Here, dm1, dm2, ... are the names of draft marks and d1, d2, .... are the corresponding drafts. After the -TANKS option, you need to define the soundings for any tanks which will be used to accomplish the incline. Here, st1, st2, ... are the names of the sounding tubes and s1, s2, ... are the corresponding soundings.

The three commands MV_WEIGHT, SOUND, and P_READ are used to define the location of the weights, the sounding and the pendula readings. They all operate similarly in that they can be used to edit the existing readings, list the current readings, etc. For example consider: 

     p_read one 5 two 10 three 8
which defines the readings for three pendula. After the command is entered, one receives a list of the input so that it can be checked. Suppose that you really wanted 7.5 as a reading for pendulum three. It can be changed with 
     p_read three 8
so that you do not need to re-enter the "good" data. After the current "event" is defined, you move to the next event with 
     EVENT NEXT
By event, we mean a condition of the vessel which is completely defined by the location of the weights, the pendula readings, and the soundings. This command will Give you an output of the current event, and you are now ready to move the weights and/or ballast water and tank new readings. This command will give you a "status" of the system at the current event. This is a standard MOSES &STATUS B_W report which shows the ballast in the tanks, the location of the weights, any other weight included, and the buoyancy. The KG of the "light ship" shown here is at 0. The macro will automatically correct this to the proper height knowing the angle.

Also, after the first EVENT NEXT, you have an estimate of the kg based on the data taken and a history of the incline which are available for inspection. The REPORT command gives you a look at the history of the incline. There are four valid values for TYPE: KG, PEND, WEIGHT, and SOUND, and the only valid options are -HARD, -PLOTS, and -REPORTS. With no options, a REPORT of the data vs event will be printed to the terminal and a plot of the data vs event will be written to the terminal. If you want this data archived, use the -HARD option to direct it to the output file and the graphics device file. If you only want the summary or the plot, use either -PLOTS or -REPORTS to get one or the other.

Of the four types of reports, there are actually two classes. The results with PEND and SOUND are really input summaries across the experiment, and KG and WEIGHT are the results. The results for KG and WEIGHT are basically those that result from the readings for each event - EXCEPT that the KG at event 0 is the "best fit" kg to to data. A plot of this will have the best fit as a horizontal line extending from where the curve intersects the Y axis.