References

A reference consists of one or several stand-alone terms that are used to refer to certain objects (panels, profiles ) by a name or a number.

If a reference consists of more than one term, the terms may normally occur in an arbitrary order and need not be given in a continuous sequence.

References may be combined with the stand-alone keyboard REF[LECT] which means that the item referred to should be reflected in the vertical plane through the center line of the ship (y = 0). This will be applied on all reference terms of the statement (or all references on the same side of the slash in statements with slashes).

Names are normally used to refer to different kinds of objects by names but they may also be used to define a certain string to be stored in a panel.

<name>::=   <name_string> |
                 <B-term> |
                <D-term>

<B-term>::= B<i>, (i=1, 2, ..., 12)

To use a B-term means the same as to write the name given as the corresponding boundary in the BOUNDARY statement last executed. NB. The BOUNDARY statement must have been executed in the current run of the input scheme. Otherwise, the result will be an empty string.

<D-term>::= D<i>, (i=0, ..., 9)

To use a D-term means the same as to write an object name earlier defined in a D-statement. An undefined D-term contains an empty string.

Examples of Names:

Curve references refer to principal hull curves (frames, buttocks, waterlines) by their number (Planar Hull Modelling will, from these numbers, derive the object names of the curves).

Bracket references are used for example, when a stiffener is connected to a bracket on the same panel.

<bracket_ref>::= BR<integer>|<rep_term>

Example:    BR5

Hole references are used for example, when a stiffener is "connected" to a hole in the same panel.

<hole_ref>::= HOL<integer>|<rep_term>

Example:    HOL3

Seam references are used for example, when a stiffener is "connected" to a seam in the same panel.

<seam_ref>::= SEA<integer>|<rep_term>

Example:    SEA2

Profile References refer to profiles by their numbers (or - for stiffeners - as an alternative, by their positions). Profiles that can be referred to in this way are stiffeners flanges and pillars - either on the current panel or on another panel - and longitudinals and transversals in the shell.

<prof_ref>::= <int_prof_ref>|<ext_prof_ref>

An internal profile reference means reference to stiffeners and flanges on the current panel.

<int_prof_ref>::= <F-ref>|<S-ref>|<PI-ref>

A stiffener reference can be made either by the stiffener number or by the stiffener tag number. for further information about the latter, see a special section below.

<S-ref>::= <Sno-ref>|<SL-ref>|<SF-ref>|<ST-ref>|<PI-ref>

An external profile reference means reference to profiles that are not stored on the current panel.

<ext_prof_ref>::= (<shell_prof_ref>)|(<name>,<int_prof_ref>)

<shell_prof_ref>::= [<surface>](<L_ref>|<TR-ref>|<T-ref>)

In case of reference to a shell profile, the actual profile reference may be combined with name of the surface in which it is located. If left out the main hull surface is expected.

All the profile reference terms on the lowest level are built up in the following way:

<prefix><integer>|<rep_term>

The prefix has the following sense

Remarks:

1. It is not allowed to mix reference terms of different types in one subpart of a statement, that means, on the same side of a slash in statement types where slashes can be used as delimiters.

2. If, in the syntax description, repetition is allowed for profile references, for example:

   <ext_prof_ref> (1 ... 25)

   this should be interpreted in the following way:

3. All references must be done to profiles in the same panel or surface.

   References to shell profiles requires the surface name to be given if the profile is located in another surface than the main surface.

   The total number of profiles referred to must be in the interval (1, 25). How this is done is irrelevant.

   Example:
   S1-10 = S1, S2, ..., S10 = S1-3, S4-7, S8-10

4. A reference may consist of several terms. The order between the terms is usually irrelevant and they need not form one unit.

5. If the step in a repetition term part of an L-term is not given explicitly in input (see above), the absolute value will be set to 10.

6. In SL-terms, the longitudinal number should not be multiplied by 10.

7. TR and T are interchangeable (except for transversals 1 and 2, where TR must be used).

8. Negative transversal numbers cannot be used.

9. References to pillars are currently restricted to the POINT statement.

Examples:

1. Internal profile references:

2. External profile references:

In the examples below OUTER is supposed to be the main surface.