DEFINE UNITS

Purpose

Defines the Input and Output units.

Syntax

DEFINE ( UNITS ) ( FEET  )
               ( IMPERIAL )
               ( INCHES  )
               ( meterS  )
               ( MM  )
               --------------------------
               ( /PRECISION ) ( FEET     ) $N
                            ( FRAME   )
                            ( INCHES  )
                            ( meterS  )
                            ( MM      )
                            ( STATION )
               --------------------------
               ( /SHOW )

Description

The DEFINE UNITS command allows the user to select from either FEET, INCHES, meterS, Millimeters ( MM ) or IMPERIAL ( feet, inches and sixteenths ) for Input and Output units. Imperial units should have a "#" as the first character followed by up to three numbers separated by a period '.' for example, #5.6.10 which translates to 5 feet, 6 inches and 10 sixteenths.

Given below are examples of valid imperial numbers:

The DEFINE UNITS /PRECISION command allows the user to change the precision (number of decimal places) to which numeric values are displayed throughout Lines. This is set for each units type setting.

Examples

DEFINE UNITS INCHES
DEFINE UNITS MM
DEFINE UNITS /PRECISION meterS 3
DEFINE UNITS /PRECISION STATION 5

DELETE

Purpose

To delete an item.

Syntax

DELETE ( BUTTOCK  ) ( /ALL    ) < /CONFIRM >
( DECK $W  ) ( $N THRU $N < INC $N > )
( DESIGN  ) ( $S    )
( SECTION  )
( WATERLINE )
---------------------------------
( ANGLE  ) ( /ALL ) < /CONFIRM >
( CAMBER  ) ( $L  )
( CLINE  )
( DIAGONAL )
( KNUCKLE  )
( PLATE  )
( PLINE  )
( SAC  )
( SHEER  )
( SURFACE  )
( TANGENT  )
---------------------------------
( PATCH ) ( /ALL ) < /STORED >
  ( $L  )
------------------------------------
( FOB  ) < /CONFIRM >
( FOS  )
( STEM /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /HALFSIDING  )
( STERN /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /HALFSIDING  )

Description

This command deletes the specified item(s) from the WORKFILE. Since the data is only removed from the workfile it will not actually be lost until a SAVE is performed.

Command Qualifiers

Examples

DELETE STEM /PROFILE
DELETE SECTION 2 THRU 10 INC 0.5
DEL WAT 2 3 4 5 6.3
DEL PATCH /ALL /CON

DERIVATIVE

Purpose

To calculate the derivative at a point on the current curve.

Syntax

DERIVATIVE ( /CURSOR )
---------
( /U= $N )
( /V= $N )

Description

The program will calculate the derivative that means, the slope of the curve at any user defined position by entering the U or V value in the local axis system or via the CURSOR in which case the derivative of the nearest point to the cursor crosswire will be calculated.

The derivative returned depends on the current view that means,

• Section view = dz/dy

• Waterline view = dy/dx

• Buttock view = dz/dx

Examples

DERIVATIVE /U=2.35
DER /V=4.07
DER /CURSOR

DESIGN

Purpose

To read an HFD, SFOLDS or BRITFAIR design file.

To write an HFD, BRITFAIR.

Syntax

DESIGN ( /READ ) ( /BRITFAIR ) /FILE=$F
  ( /HFD  )
  ( /SFOLDS  )
-------------------------------------------------
( /WRITE ) ( /BRITFAIR /SHIP= $W /TOL= $N ...
... < /MAX_POINTS= $N > ) ...
... ( BUTTOCK  ) < /FILE= > ( $F )
( DIAGONAL $W  )
( FOB  )
( FOS  )
( KNUCKLE $W  )
( PLINE $W  )
( SECTION  )
( STEM /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /HALFSIDING  )
( STERN /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /HALFSIDING  )
                    (PMB /AFT        )
                    (PMB /FORWARD        )
( TANGENT $W  )
( WATERLINE  )
  ------------------------------------
  ( /HFD ) < /FILE= > ( $F )

Description

DESIGN /READ...

A design file contains Section offsets used when GETting or FITting Sections. When data is read in from the design file the offsets are stored in the DESIGN directory. The position of the stored design data Sections can be listed by using the DIRECTORY DESIGN command. The design data for a particular Section can be extracted by using the commands:-

USE DESIGN

GET SECTION $N or FIT SECTION $N

When a new set of design data is read in, any existing data is overwritten.

The format of the different design files is described in Section 5. In the case of data in HFD or SFOLDS format, a check is made that the General Particulars are consistent with the current LINES general particulars. If not, an error message is displayed and the data is not read.

DESIGN /WRITE...

Data can be output in HFD or BRITFAIR file format. See File Formats for a description of the file formats.

In the case of an HFD file, only section data at user specified drafts is output. In the case of a BRITFAIR file, data describing any curve can be output.

Command Qualifiers

Examples

DESIGN /READ /HFD /FILE=fname
DESIGN /WRITE /BRITFAIR /SHIP=tanker /TOL=0.001 FOB /FILE=fname

DIGITISE

Purpose

Digitise curves.

Syntax

DIGITISE ( BUTTOCK  ) ( $N ) < WINDOW $N $N $N $N >
( SECTION  )
( WATERLINE )
---------------------------------
( STEM  ) < WINDOW $N $N $N $N >
( STERN  )

Description

This command allows the user to input data points for selected curves by using a digitising tablet attached to the host computer. Orthogonal curves may be digitised in their respective view and the Stem and Stern Profile curves may be digitised in Buttock view.

The first time the command is issued for a given line set the user must supply two coordinates which define the diagonal of the Window Box in which the digitisation is to take place, these will be used to offset and scale the input data. The user will then be prompted to pick the 4 corners of the drawing area. 4 points are necessary in order to calculate correct alignment.

Having defined the digitising window the user can then digitise the selected curve. The user selects points using the First button on the mouse/pen (or SPACEBAR on the keyboard) and the selects CANCEL CURSOR (or any other Button or Key) to terminate digitising for the curve. The curve becomes CURRENT and can be manipulated using the normal techniques. Subsequent curves of the same line-set can then be digitised without re-defining the window.

Examples

DIGITISE STEM WINDOW 0 0 5 7.5
DIGITISE SECTION 1 WINDOW 0 0 6.8 11.5
DIG SEC 2

DIRECTORY

Purpose

List required directory information.

Syntax

DIRECTORY ( ANGLE)  < SECTION  > < /FILE=$F >
                   < WATERLINE > </QUIET>
                    < BUTTOCK  >
          --------------------------------
          ( BOUNDARY    )       < /FILE=$F > </QUIET>
          ( BUTTOCK     )
          ( DESIGN      )
          ( FRAME       )
          ( PARTICULARS )
          ( SECTION     )
          ( WATERLINE   )
          ---------------------
          ( CAMBER      ) < $L >
          ( DIAGONAL    ) < $L >
          ( KNUCKLE     ) < $L >
          ( PLINE       ) < $L >
          ( SHEER       ) < $L >
          ( TANGENT     ) < $L >
          -----------------------------------
           ( CLINE ) < $L > < /ANGLE      > < SECTION   > < /FILE=$F >
                           < /CRANK       > < WATERLINE > </QUIET>
                         < /FLAT       > <BUTTOCK >
                         < /KNUCKLE    >
                         < /PARABOLIC  >
                         < /PROJECTION >
          ---------------------------------------------
          ( DECK  ) < $L > < /FULL > < /FILE= $F > </QUIET>
          ( PATCH ) < $L > < /FULL /REGENERATE >
          ---------------------------------------------
          ( PLATE ) < $W > < $W > < /FULL > < /FILE= $F > </QUIET>
          ---------------------------------------------
          ( SAC ) < $L > < /FULL > </QUIET>

Description

This command will list the contents of the specified directory.

The output is dependent on the type of entity but basic output contains the Name or Position of the item, the creation Date and Time and a flag to indicate whether the entity is SWITCHed ON or OFF.

DIRECTORY ANGLE

Lists the contents of the angle directory.

Command Modifiers

Examples

DIR ANGLE

DIRECTORY BOUNDARY

Lists the contents of the BOUNDARY directory. The boundary directory can contain the following curves:

• Flat of bottom (FOR)

• Flat of side (POS)

• Stem Profile

• Stem Radii

• Stem Tangent

• Stern Profile

• Stern Radii

• Stern Tangent

Examples

DIR BOU

DIRECTORY BUTTOCK or WATERLINE

Lists the contents of the BUTTOCK or WATERLINE directory.

Examples

DIR BUTT
DIR WAT

DIRECTORY CAMBER or SHEER

Lists the contents of the CAMBER or SHEER directories includes the names of the Clines that were used to create that curve.

Examples

DIR CAM
DIR SHE

DIRECTORY CLINE

Lists the contents of the CLINE directory. The directory list can be restricted to a selected geometry type and/or view using the appropriate modifiers.

Parameter Modifiers:

Examples

DIR CLINE
DIR CLINE /FLAT
DIR CLINE SECTION
DIR CLINE /PARABOLIC WATERLINE

DIRECTORY DECK

The brief output for DECKS shows the name(s) of the Camber and Sheer curves used to create the deck together with the size and extent of the Gunwhale if it has been defined.

The full output also shows the Deck Frames that have been created.

Selected Decks can be listed by either specifying their name explicitly or by using wildcards.

Examples

DIR DECK
DIR DECK MNDK /FULL

DIRECTORY DESIGN or SECTION

The Design and Section directories include the position of the curve in terms of its Constant Dimension ( CD ), its Station value and its Frame number ( if defined ).

Examples

DIR DES
DIR SEC

DIRECTORY DIAGONAL or KNUCKLE or PLINE or TANGENT

Lists the contents of the DIAGONAL, KNUCKLE, PLINE or TANGENT directory.

Examples

DIR DIA
DIR KNU
DIR PLI FL* AL*

DIRECTORY FRAME

Lists the currently defined Frame Spacing table.

Examples

DIR FRAME

DIRECTORY PARTICULARS

This lists the General Particulars of the ship and includes the following:

• External design name

• Internal Ship name

• Overall length

• Length Between Perpendiculars

• Beam

• Draft

• Depth of Centreline

• Flat of Keel( Half siding ) value

• Rise of Floor

• Bilge Radius

• Rake of Keel

• Stern Overhang

• Maximum z point

• Minimum z point

Examples

DIR PART

DIRECTORY PATCH < $L >

A PATCH definition is normally shown in brief form but the complete definition can be output by specifying the /FULL qualifier. The name(s) of the PATCH can be specified in full or by using wildcards. The /REGENERATE qualifier will refit the patches automatically if any changes have been done.

Examples

DIRECTORY PATCH
DIR PAT aft

DIRECTORY PLATE < Strake > < Plate >

A PLATE definition is normally shown in brief form but their complete definition can output by specifying the /FULL qualifier. All the PLATES in a particular Strake can be listed or a particular Plate can be selected. The Stake and Plate names can be specified in full or by using wildcards.

Examples

DIRECTORY PLATE
DIRECTORY PLATE strak1 aft*

DIRECTORY SAC

A list of SACs will be output with their respective drafts and trims. If no names are supplied, then all SACs will be listed. If the /FULL option is given then the properties for each SAC will be calculated and output in tabular form.

Command Qualifiers

DISPLAY

Purpose

To display the requested graphical information on the graphics device.

Syntax

DISPLAY ( BOUNDARY  ) < /AFT  > < /BOTH >
( STEM /PROFILE  ) < /FORWARD  > < /OFF  >
(  " /RADII  ) < /KURVATURE > < /ON  >
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /ENDSURFACE  )
(  " /HALFSIDING  )
(  " /TRANSITION  )
( STERN /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /ENDSURFACE  )
(  " /HALFSIDING  )
(  " /TRANSITION  )
        (PMB /AFT          )
        (PMB /FORWARD         )
-------------------------------------------------
( BUTTOCK  )( /ALL  ) < /AFT  > < /BOTH >
( SECTION  )( $N THRU $N INC $N ) < /FORWARD  > < /OFF  >
( WATERLINE )( $S  ) < /KURVATURE > < /ON  >
    -----------------------
        < /INTERSECT > < PATCH > $L </BUFFER>
                                                < CHECK >
          -----------------------------------------------------
( CAMBER  ) ( /ALL  ) < /AFT  > < /BOTH >
( CLINE  ) ( $L  ) < /FORWARD  > < /OFF  >
( DECK  )   < /KURVATURE > < /ON  >
( DIAGONAL )
( KNUCKLE  )
( PLINE  )
( SHEER  )
( TANGENT  )
------------------------------------------------------
( CURVE ) < /ALL > < /AFT  > < /BOTH >
    < /FORWARD  > < /OFF  >
    < /KURVATURE > < /ON  >
--------------------------------------------------------
( FOB ) < /INTERSECT > < WITH > < BUTTOCK > < /AFT  > < /BOTH >
      < SECTION > < /FORWARD > < /OFF  >
  < /KURVATURE  > < /ON  >
--------------------------------------------------------
...

...
--------------------------------------------------------
DISPLAY ( FOS ) < /INTERSECT > < WITH > < SECTION > < /AFT  > < /BOTH >
     <  WATERLINE > < /FORWARD > < /OFF  >
  < /KURVATURE        > < /ON  >
--------------------------------------------------------
( PATCH ) ( /ALL ) < /FULL  > < /NAME >
  ( $L  ) < /LIMITS= >
    </POINT  >
    < /STORED  >
------------------------------------------
( PLATE ) ( $W < $W > ) < /FULL > < /NAME >
  ( $L    )
------------------------------------------
( POINTS ) < /BUFFER >
  < /NUMBER >
----------------------------------
( SAC ) ( /ALL ) < /AFT  > < /BOTH >
  ( $L  ) < /FORWARD  > < /OFF  >
    < /KURVATURE > < /ON  >
----------------------------------
( KNOT  )
( KURVATURE )
( VERTEX  )

Description

This command will display the requested graphical information on the graphics device, that means, screen or plotter.

The information to be drawn is selected by specifying its class name for example, Section, Patch followed by additional parameters which choose items from within the class.

Command Qualifiers

Examples

DISPLAY CURVE
DISPLAY BOUNDARY
DIS POINT /BUFFER
DIS POI /NUMBER
DIS SECT /ALL /AFT
DIS PATCH p*
DIS WAT 1 THRU 10 INC 2.0
DIS SAC

DUMP

Purpose

To input/output selected data to/from the design. This is primarily used to transfer data between designs or to different computers.

Syntax

DUMP ( IN  ) < /FILE= > ( $F )
  ---------------------------------------------
  ( BUTTOCK  ) ( IGES ) < /FILE= > ( $F )
  ( FOB  )
  ( FOS  )
  ( KNUCKLE  )
  ( PLINE  )
  ( SECTION  )
  ( STEM /PROFILE  )
  ( STERN /PROFILE  )
           (PMB /AFT               )
           (PMB /FORWARD        )
  ( TANGENT  )
  ( WATERLINE  )
           (/AUTO )
  ---------------------------------------------
( OUT ) ( /ALL  ) < IGES    > < /BOTH >...
...< /FILE= > ( $F )
  ( BOUNDARY  ) < NURBS < $N > < /AXIS > > < /OFF  >
  ( BUTTOCK  ) < DXF    > < /ON  >
  ( CAMBER  ) <XYZ /TOL=$N
  ( CLINE  )    < /MAX_POINTS $N >
  ( DECK  )    < /NAME >
  ( DIAGONAL  )
  ( FOB  )
  ( FOS  )
  ( KNUCKLE  )
  ( PATCH  )
  ( PARTICULARS  )
  ( PLATE  )
  ( PLINE  )
  ( SAC  )
  ( SECTION  )
  ( SHEER  )
  ( STEM /PROFILE  )
  (  " /RADII  )
  (  " /TANGENT  )
  (  " /ECCENTRICITY  )
  (  " /HALFSIDING  )
...

...   ( STERN /PROFILE  )
  (  " /RADII  )
  (  " /TANGENT  )
  (  " /ECCENTRICITY )
  (  " /HALFSIDING  )
           (PMB /AFT               )
           (PMB /FORWARD         )
           ( TANGENT  )
           ( WATERLINE    )

Description

The command allows the user to output selected items from the design and subsequently read them back into another design or transfer to another AVEVA Marine module.

DUMP IN

This command allows data to be read into the current design. The data will replace any that exists already. The file can either be in Lines DMP format, see below, or for some curve types in IGES 126 format. When reading IGES data, if the /AUTO option is given then Lines will attempt to assign the appropriate curve type to curve curve.

DUMP OUT

The user may output all the stored data by using the /ALL option or select a particular group of items by specifying their type name for example, SECTION for all Sections, PATCH for all Patches.

By using the /ON, /OFF or /BOTH options the user can be more selective about which items in the group are output. Note that /BOTH is the default.

Command Qualifiers

Examples

DUMP OUT /ALL trawler
DUMP IN trawler
DUMP OUT SECTION /ON sec
DUMP IN FOS IGES /FILE= fos.Igs
DUM OUT SEC IGES /FILE= sections
DUM OUT BOU NURBS /FILE n020595

EXTRAPOLATE

Purpose

To linearly extrapolate two-dimensional curves.

Syntax

EXTRAPOLATE ( BUTTOCK ) ( /ALL                   ) ( /X= ) ( $N $N )
                      ( $N THRU $N < INC $N > ) ( /Z= )
                      ( $S    )
            --------------------------------
            (STEM ) (/ECCENTRICITY)
            (STERN) (/HALFSIDING)
                    (/TRANSITION)
             -----------------------------------------------
            ( CURVE )           ( /X= ) ( $N $N )
            (STEM ) (/TANGENT)  ( /Y= )
            (STERN)  (/TANGENT) ( /Z= )
              (FOB)
            (FOS)
            (KNUCLE ) ($W)
            (TANGENT)
            (PLINE  )
            (CAMBER )
            (SHEER  )
             -----------------------------------------------
            ( SECTION ) ( /ALL                 ) ( /Y= ) ( $N $N )
                    ( $N THRU $N < INC $N > ) ( /Z= )
                    ( $S                  )
            --------------------------------
            PMB ( AFT     )
            PMB ( FORWARD )
            ---------------------------------
            ( STEM  ) ( /PROFILE ) ( /X= ) ( $N $N )
                     ( /RADII   ) ( /Y= )
            ( STERN ) ( /PROFILE )
  ( /RADII   )
             ------------------------------------------------
             ( WATERLINE ) ( /ALL                   ) ( /X= ) ( $N $N )
                       ( $N THRU $N < INC $N > ) ( /Y= )
                          ( $S                    )

Description

This command allows the user to linearly extrapolate 2-D curves such as Stem and Stern Profile and Radii, Section, Waterline and Buttock curves. The user may extrapolate the current curve or a series of stored curves.

The method used calculates the tangent at the start point selected by the user, extrapolates a new point at another user selected position and then re-fits to the data points.

When extrapolating stored curves it is advisable to make sure that the curves to be extrapolated have been fitted to the data points as this command will automatically re-fit the curves through the points stored with that curve.

Examples

EXTRAPOLATE CURVE /Z= 10.5 13.87
EXT SEC 9 THRU 10 INC .25 /Z=11.0 12.25

FAIR

Purpose

A semi-automatic fairing capability for a curve.

Syntax

FAIR < /PSK > ( /X ) < /LOWER= $N > < /UPPER= $N > < /CURSOR > /TOL= $N
   ( /Y )
   ( /Z )

-----------------------------------------------------

/INTERACTIVE < /CLEAR > </BOUNDARY> </DELETE> </PREVIOUS> < $W >

Description

Allows the user to fair a current curve, using one of two methods.

The default method is based upon the work of Eck and Hadenfeld and has been made available due to the participation in the FAIRSHAPE project.

By using the /PSK optional qualifier a method developed at the National Technical University of Athens by Pigounakis, Sapids and Kaklis is employed. This method ensures the curves are constructed so that their curvature and torsion plots are as smooth as possible.

By using the /X, /Y or /Z options with the /LOWER and /UPPER options, a portion of the curve can be faired.

The cursor option allows the user to interactively select the portion of the curve to fair.

By selecting the /INTERACTIVE option, the Patch and Curve Editor is opened with those curves marked for editing/boundaries by the MODIFY command. By adding the /BOUNDARY qualifier, curves used as patch boundaries for an existing surface model will also be marked for editing/boundaries.

Adding the /CLEAR qualifier will clear all previously marked curves.

Specifying the /DELETE qualifier will delete all data associated with the selection.

Specifying the /PREVIOUS qualifier will edit the previous selection.

Specifying a name will cause that named selection to be edited.

Examples

FAIR
FAIR /Z /LOWER=5 /UPPER=10
FAIR /CURSOR

FIT

Purpose

To allow the user to fit a series of Sections, Waterlines, Buttocks or Deck Frames.

Syntax

FIT ( BUTTOCK                    ) ...
( SECTION                    )
( WATERLINE < /STERN > < /STEM > < NORMAL > < /POINT >)

... ( /ALL   ) < /ACCEPT  > < /SHOW > < CLOSE > </BUFFER>
( $N THRU $N < INC $N >) < /NOACCEPT  >
( $S   )
-----------------------------------------------
( DECK ) ( $W ) ( /ALL   ) < /ACCEPT  >
    ( $N THRU $N < INC $N >) < /NOACCEPT >
    ( $S   )
   ----------------------------------
    ( /TRANSITION ) < /CONSTANT > ( x1 x2 )
      < /VARYING  >
-----------------------------------------------
( SAC $W ) ( $N THRU $N < INC $N >) < /TRIM >
  ( $S   )

Description

The points for each required curve are extracted from the DESIGN directory or interpolated from stored curves and an automatic PREFIT takes place. The resultant curve is displayed on the graphics device and optionally save in the design.

FIT SECTION, WATERLINE or BUTTOCK

For orthogonal curves the FIT command is equivalent to executing the following sequence of commands:

GET 'curve specifier'
PREFIT
DISPLAY CURVE
ACCEPT

The user may fit an individual curve or a series of curves. By using the /ALL option the system will get a list of the stored curve positions and fit new curves at these positions. If USE DESIGN is in use then all curves in Design directory will be fitted.

The /CLOSE option allows the user close the curve that means, an extra point at the same coordinate as the first point is automatically inserted prior to fitting a curve to the points.

FIT WATERLINE /STEM or /STERN

This option adjusts the Waterline Endings to that defined by the End Surface. In this way the endings can be changed without altering (or fitting) the rest of the waterline. If the /POINT option is given, points are moved and generated to that, if the waterline is refitted, the resultant curve will approximate the updated curve.

FIT DECK

The FIT DECK command allows the user to fit a series of deck frames for a named Deck with a given Camber and Sheer and with or without a Gunwhale.

In order to fit decks the user must have previously created a Camber line and a Sheer line. If a Gunwhale is also to form part of the deck then it too must have been defined previously. The required Camber, Sheer and Gunwhale are selected with the USE command.

Deck frames are created by first translating the Camber line to a height defined by the Sheer line at a given frame position. Next the translated Camber line is intersected with the frame to give a deck edge point. Any points outside this deck edge point are discarded. If a Gunwhale is to be fitted then extra points will by added to ensure the correct radius. Finally a curve is fitted to the points which is then displayed and stored if required.

Transition deck Frames can be created between any two existing Deck Frames by using the TRANSITION option. In this case the user must specify the Start and End frame of the Transition piece and no intervening Deck Frames should exist. These two Deck Frames should be either Flat or Cranked to achieve a proper Transition. A Transition Deck Frame will be created at each Section which is switched ON, between the two positions. The angle at which the new Transition Deck Frames intersect the shell can be CONSTANT or VARYING by specifying the appropriate option.

Note that deck edge points are automatically stored in the POINTS BUFFER which may subsequently be used to form a deck edge curve.

FIT SAC

Fits a series of SACs where the number series specifies the draft for each SAC and the trim is constant for each SAC. If no trim is given, then it is assumed to be 0.0. Each SAC name is automatically generated by prefixing an ASCII representation of the draft height, with a given string ($W) having a maximum length of 3 characters.

Command Qualifiers

Examples

Fitting orthogonal curves

FIT SECTION 0 THRU 100 INCREMENT 2

FIT SE 0 THRU 50 INC 5

FIT SE 1 THRU 10

FIT BUTT 2.2

FIT WAT 0 THRU 10 0.5 /NOACCEPT

Fitting deck frames

USE CAMBER cam07
USE SHEER sh03
FIT DECK dk1 1 THRU 100 INCREMENT 1
FIT DECK dk1 201 THRU 300 INCREMENT 1
USE GUNWHALE /ON
FIT DECK dk1 101 THRU 200 INC 1

Create deck edge curve that means, after above commands have been executed.

CRE KNUCKLE dk1edge /BUFFER
SORT /X
PREFIT
DISPLAY CURVE
ACCEPT

Fitting Deck Transition Frames

FIT DECK dk2 /TRANSITION 55 65

Fitting a series of SACs

FIT SAC TST 6 THRU 8 INCR 0.1 /TRIM 1

GAUSSIAN

Purpose

Used to visually check the curvature of a patch.

Syntax

GAUSSIAN < PATCH > SW < /NUMBER $N >

Description

Gaussian curvature is shown at equidistant contours between the minimum and maximum and can only be displayed for individual patches. The default being set at eight, but this value can be changed by using the /NUMBER option and a value.

Negative curvature is shown in YELLOW and positive in RED.

GENERATE

Purpose

To generate patch data for interfacing with the BMT HULLSURF system and Plate data for input to the BMT BRITSHELL system.

Syntax

GENERATE ( PATCH $W ) ( curve ) ( curve ) ( curve ) ( curve ) ( /TYPE )...
---------------
      ( curve ) < NULL  >
---------------
      < NULL  > < NULL  >
  --------------------------------
  ( IDENTIFY        )

...( REGULAR  ) < /CURVE_TYPE < /AUTO  >> < /NOCONTINUITY >< /SHOW >
   < BUTTOCK  >
   < DECK $W  >
   < SECTION  >
   < WATERLINE >
------------------------------------------------------------
or..( SCATTERED ) < /CURVE_TYPE < SECTION > < WATERLINE > < BUTTOCK >>...
...< /NOCONTINUITY > < /SHOW >
------------------------------------------------------------
or..( BOUNDARY ) < /NOCONTINUITY > < /SHOW >





GENERATE ( PLATE $W $W ) ( curve ) ( curve ) ( curve ) ( curve ) ( /TYPE )..
---------------
       ( curve ) < NULL  >
---------------
       < NULL  > < NULL  >
  --------------------------------
  ( IDENTIFY        )

...( REGULAR  ) < /CURVE_TYPE < /AUTO  >> < plate_info >
   < BUTTOCK  >
   < DECK $W  >
   < SECTION  >
where 'curve' is:-
( BUTTOCK  ) ( $N )
( SECTION  )
( WATERLINE )
---------------------
( FOB  )
( FOS  )
( STEM /PROFILE  )
(  " /TANGENT  )
(  " /ECCENTRICITY  )
(  " /HALFSIDING  )
( STERN /PROFILE  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /HALFSIDING  )
                   (PMB /AFT                )
                   (PMB /FORWARD         )
---------------------
( DIAGONAL ) ( $W )
( KNUCKLE  )
( PLINE  )
( TANGENT  )

and 'plate_info' is:-
< /THICKNESS= $N > < /DENSITY= $N > < /GRADE= $N > < /NUMBER_OFF= $N >    < WATERLINE >

Description

A PATCH or PLATE is defined by a grid of data points which lie on the surface of the ship. The data points are calculated by girthing the mesh of defining curves of the Patch/Plate. Each Patch/Plate is GENERATED by specifying two, three or four stored curves as the boundaries. There are three types of patches available, Scatter, Boundary and Regular. Scatter patches are generated by the boundary curves and any other curves which cross the patch (that means,, FOB, FOS, knuckles, ). This generally gives the most accurate method of representing the curves. Boundary patches only use data from the boundary curves, and as such, are ideal for representing flat areas. Regular patches are fitted using data from one set of orthogonal curves, usually Sections, Waterlines or Buttocks but in the case of Patches other curves may be used, see ADD command.

The boundary curves are selected by specifying their name or, by using the IDENTIFY option, can be selected from any currently DISPLAYed curves using the cursor.

If FOUR curves are specified, then they are intersected to form the corner points of the Patch/Plate. Patches can also be generated using only 2 or 3 boundary curves by the NULL option. When PATCHES are generated they automatically use continuity between the boundaries with tangency continuity being the default. To change this use the /NOCONTINUITY option. (see CONTINUITY command)

The internal curve type for the Patch/Plate is automatically assigned. This is set by the DEFINE HULLSURF and DEFINE BRITSHELL commands. The internal curve type may be modified at any time without re-defining the boundaries by using the appropriate DEFINE command. In the case of Patches other non-orthogonal curves may be assigned as the internal curves by using the ADD command.

As an alternative to generating PATCHES from stored curves, a PATCH can be generated from a patch data file as output by LINES (see the OUTPUT command) or by the BMT PATCHGEN system. In this case the /FILE= option is used to specify the input patch data file name. The patch points contained within the file are fitted to generate a set of defining PLINES with the names:

The patch is then generated and stored as for other patches. Patch data files must be in CREATE format and names of patches generated in this way must not exceed six characters. Please refer to the PATCHGEN User Manual for further information.

The definition is stored in the appropriate directory and can be examined using the DIRECTORY PATCH / PLATE command. Definitions can be SWITCHed ON or OFF, DELETED and DISPLAYED. Note that only the definition is stored, data points for the Patch/Plate are not calculated until the OUTPUT command is used.

When defining PLATES the user must specify the Strake name as well as the Plate name and may also assign Plate attributes for DENSITY, GRADE, NUMBER_OFF and THICKNESS. If the plate attributes are not specified then the current default values, as set by the DEFINE BRITSHELL command, will be assigned.

Examples

GENERATE PLATE pl1 /IDENTIFY
GENER PATCH pat1 TYPE SCATTER SEC 10 SEC 24 WAT 2 KNU tt
GENER PATCH pat1 SEC 10 SEC 24 WAT 2 KNU tt /NOCONTINUITY
GEN PAT p1 SEC 10 PLINE pl1 STEM/PRO /CURSOR
GEN PAT po1 SEC 5 WAT NULL

GET

Purpose

To calculate/extract data points for the requested curve.

Syntax

GET ( BUTTOCK  ) ( $N )
( SECTION  )
( WATERLINE )
------------------------------------------
( DIAGONAL ) ( $W ) ( /CURSOR )
    -------------------------
    ( BUTTOCK  ) ( x1 y1 x2 y2 )
    ( SECTION  )
     ( WATERLINE )
----------------------------
( SAC ) ( $W ) < /AP= $N >
    < /AP= $N /FP= $N >
    < /AP= $N /TRIM= $N >
    < /FP= $N /TRIM= $N >
          < /MID= $N /TRIM= $N >

GET BUTTOCK or SECTION or WATERLINE

Section data may either be extracted from the DESIGN directory or interpolated from stored curves. Data for Buttocks and Waterlines can only be obtained by interpolating stored curves.

The user can select where the data is obtained from by using the SWITCH and USE commands.

In all cases only curves that are SWITCHED ON are interpolated.

Unless otherwise stated the following curves are always interpolated and a point with the indicated type is obtained:

• Point Lines} Ordinary points

The following curves are selected with the USE command:

In addition, if the Flat of Keel (FOK) is defined then curves fitted outside the FOB region will have extra points added to accommodate the FOS.

Similarly, if Waterline Endings or Frame Feet are required then extra points are added to accommodate the type of ending selected by the USE command.

Examples

GET SECTION 1.5
GET WAT 4

GET DIAGONAL

Diagonals can only be created in an Orthogonal view. The plane in which the diagonal is to be created is defined by specifying two coordinates in the selected view. The coordinates may be entered on the command line or via the cursor.

Having defined the Diagonal plane, stored curves are intersected to obtain data points. The procedure for selecting the curves to be intersected is the same as that for orthogonal curves. After a GET DIAGONAL command has been successfully executed the system automatically switches to the View Plane in which the Diagonal can be manipulated using the Conventional Fairing commands.

Parameter Modifiers

Examples

GET DIA bdia BUTTOCK 2.2 -1.0 2.8 8.064
GET DIANGONAL d1 /CURS

GET SAC

This option causes the system to calculate the areas under all Sections which are then used in the creation of the Sectional Area Curve( SAC ). This curve can then be used to calculate basic hydrostatic properties of the ship using the PROPERTIES command and also to perform distortions of the ship using the VARIATION command.

The $W represents a name prefix. The draft height will be used to generate a unique name for each SAC.

Parameter Modifiers

Examples

GET SAC /AP 10
GET SAC /AP 10 /FP 11
GET SAC /FP 10 /TRIM -5
GET SAC /MID 20 /TRIM= -2

GIRTH

Purpose

To calculate and output the girths of selected curves.

Syntax

GIRTH < POINTS $N > ( BUTTOCK  ) ( /ALL    ) < /BOTH >..
< SPACING $N > ( DECK $W  ) ( $N THRU $N < INC $N > ) < /OFF  >
  ( SECTION  ) ( $S    ) < /ON  >
  ( WATERLINE )
... < /X > < /LOWER= $N > < /UPPER= $N > </BUFFER> < /FILE= $F >
< /Y >
< /Z >
--------------------------------------------------
< POINTS $N > ( FOB  ) < /BOTH > < /X > ...
< SPACING $N > ( FOS  ) < /OFF  > < /Y >
   ( STEM /PROFILE  ) < /ON  > < /Z >
  (  " /RADII  )
  (  " /TANGENT  )
  (  " /ECCENTRICITY )
  (  " /HALFSIDING  )
  (  " /TRANSITION  )
  ( STERN /PROFILE  )
  (  " /RADII  )
  (  " /TANGENT  )
  (  " /ECCENTRICITY )
  (  " /HALFSIDING  )
  (  " /TRANSITION  )
                   (PMB /AFT                )
                   (PMB /FORWARD         )
... < /LOWER= $N > < /UPPER= $N > </BUFFER> < /FILE= $F >
  --------------------------------------------
  ( SAC ) ( /ALL ) < /BOTH > ...
    ( $L  ) < /OFF  >
      < /ON  >
... < /LOWER= $N > < /UPPER= $N > </BUFFER> < /FILE= $F >
-------------------------------------------------
< POINTS $N > ( KNUCKLE  ) ( $L ) < /BOTH > < /X > ...
< SPACING $N > ( TANGENT  )   < /OFF  > < /Y >
  ( PLINE  )   < /ON  > < /Z >
  ( DIAGONAL )
  ( SHEER  )
... < /LOWER= $N > < /UPPER= $N > </BUFFER> < /FILE= $F >
--------------------------------------------------
< POINTS $N > ( CURVE ) < /BUFFER > < /X > ...
< SPACING $N >     < /Y >
      < /Z >
... < /LOWER= $N > < /UPPER= $N > < /FILE= $F >

Description

Girths may be calculated and output for any stored curves between any two limits. The limits may just be the start and end of the curve ( the default ) or they may be defined by the user with the /LOWER and/or /UPPER options. The output is normally listed to the screen but may be sent to a file by use of the /FILE option.

Command Qualifiers

Examples

GIRTH SECTION /ALL /Z /LOWER=1 /UPPER=6
GIR PLI po1 /X /LOW 25 /UPP 45 /BOTH
GIR WAT 2 THR 6 .5 /X /LOW 10 /UPP 89.5

GRID

Purpose

To draw a grid in the current view.

Syntax

GRID ( /FILE  )
( /STANDARD )
( /STORED  )
( $N < $N >       ) < /TICKS >

Description

Various grid spacings can be used, these are described below in the command qualifiers section.

This command may also be used in Plot mode and allows the user to define different grid types for different views. The main difference between this command and the DEFINE PLOT GRID command is that the user needs to repeat the GRID command for every selected view whereas the effect under the DEFINE PLOT GRID is permanent until it is redefined.

Command Qualifiers

Examples

GRID 1
GR 1 2 /TICK

HELP

Purpose

To display HELP information

Syntax

HELP ( HELP )
( $W  )

Description

Lists the relevant help information on the screen. If a non-unique truncated command is specified the system will list the help information for all the commands commencing with the Specified Truncated command.

After each page of help information the system will pause and prompt the user with '...' in the bottom right hand corner of the screen. The user can choose to go on to the next page by clicking the <RETURN> key or quit the help by clicking the <Q> key and then <RETURN>.

Examples

HELP help
HELP adjust
HELP de

HULLFORM

Purpose

To create and maintain hull form definitions.

Syntax

HULLFORM CREATE $W < /MAINHULL > < /PORT      >
                   < /MAINDECK > < /STARBOARD >
                   < /DECK     > < /BOTH      >
                   < /OTHER    >
         -------------------------------------------
         DEFINE $W < /MAINHULL > < /PORT      >
                   < /MAINDECK > < /STARBOARD >
                   < /DECK     > < /BOTH      >
                   < /OTHER    >
         -------------------------------------------
         DISPLAY $W
         -------------------------------------------
         DELETE $W
         -------------------------------------------
         RELEASE ( $W   )
                 ( /ALL )
         -------------------------------------------
         RENAME $W $W
         -------------------------------------------
         ( ADD    )  ( FOB )
         ( REMOVE )  ( FOS )
                     ( PMB ) ( /AFT )
                             ( /FORWARD )
                     ( STEM  ) ( /PROFILE )
                     ( STERN ) ( /TANGENT )
                     ( KNUCKLE ) $W
                     ( TANGENT )
                     ( PLINE   )
                     ( PATCH   )
         -------------------------------------------
         DIRECTORY < $W >

Description

A Hull Form Definition is a collection of patches and curves which define a hull form (main hull, deck, appendage, ). They refer to existing curves and patches which will be used downstream in the Design process by Surface/Compartment, Structural Design and Hull.

The following options are available

CREATE

Create a hullform definition, providing a name, what the hull form will represent and which side of the centreline it is defined on.

DEFINE

Change what an existing hull form definition represents and which side of the centreline it is defined on.

DISPLAY

Display the hull form (the curves and patches).

DELETE

Delete the named hull form definition.

RELEASE

Release the named hull form ($W) or all hull forms (/ALL). This option makes the hull form available for downstream activated in Surface/Compartment and Hull.

RENAME

Rename an existing hull form definition giving the existing name then the new name.

ADD

Add a curve or patch to the hull form definition.

REMOVE

Remove a curve or patch from the hull form definition.

DIRECTORY

List the contents of a hull form definition to the Output Window.

Command Qualifiers

Examples

HULLFORM CREATE MAIN /MAINHULL /STARBOARD

HULLFORM ADD MAIN PATCH PACE*

HULLFORM ADD MAIN STEM/PROFILE

HULLFORM RELEASE MAIN

IDENTIFY

Purpose

To identify a curve on the graphics screen.

Syntax

IDENTIFY < /ALL  >
< /RANGE >
------------------
< PATCH  > < /ALL  >
  < /RANGE >

Description

Any curve DISPLAYed in the current view can be identified via the IDENTIFY command by placing the cursor on or near the curve to be identified and clicking a button or key. The name or position of the curve will be drawn along the identified curve at a position close to the cursor.

Patches can be identified in the same way using the PATCH option. This works best with stored patches but it will work with non-fitted patches although a little slower especially if the patches have been displayed with the FULL option.

Command Qualifiers

Examples

IDENTIFY
ID /ALL
IDENT /RANGE
ID PATCH
ID PAT /ALL

INSERT

Purpose

To add points to the current data points or to the points buffer.

To insert a parallel midbody section, by extending the existing one.

Syntax

INSERT < AFTER  > < /NUMBER $N > ( /CURSOR     )
< BEFORE >   ( $N $N < $N > < /BUFFER >)
    ( INTERPOLATE ( /U= $N)   )
     ( /V= $N )
       ---------------------------------------------
       PMB < /X > $N $N

Description

The new data point is added AFTER ( the default ) or BEFORE a user selected reference point. The reference point is identified either by the cursor or by specifying its reference number. Reference numbers can be determined by using the DATA POINTS command or the DISPLAY POINTS /NUMBER command.

The coordinate of the new point can be entered on the command line, defined using the cursor or by interpolating the current curve at a given U or V value.

A parallel midbody can be extended by giving the PMB option. The first value refers to the position at which the PMB will be extended and the second value refers to the length by which to extend it.

Command Qualifiers

Examples

INSERT BEFORE
INS 3.68 4.25
INS BEFORE 4.0 3.5 0.704
INS AFT /NUMBER 5 /CURSOR
INS BEF /NUM 3 2.35 4.56 7.01 /BUFF
INS BEF /NUM 7 INTERPOLATE /U=3.65

INTERPOLATE

Purpose

To calculate the coordinate(s) at one or more requested positions on the current curve.

To calculate the intersection coordinates of two curves.

Syntax

INTERPOLATE ( /U= $N ) ( THRU $N < INC $N > ) < /BUFFER >
( /V= $N ) ( $S    )
---------------------------------------------------
( BUTTOCK  )( $N  ) < WITH > ( BUTTOCK  )( $N  )< /BUFFER >
( DECK $W )( /ALL )     ( DECK $W )( /ALL )
( SECTION  )       ( SECTION  )
( WATERLINE  )       ( WATERLINE  )
---------------------------------------------------
( DIAGONAL  )( $W  ) < WITH > ( DIAGONAL  )( $W  )< /BUFFER >
( KNUCKLE  )( /ALL )     ( KNUCKLE  )( /ALL )
( PLINE  )       ( PLINE  )
( SHEER  )       ( SHEER  )
( TANGENT  )       ( TANGENT  )
            (CAMBER      )                 (CAMBER       )
            (CLINE        )                 (CLINE         )
--------------------------------------------------
( FOB  ) < WITH > ( FOB  )...
( FOS  )     ( FOS  )
( STEM /PROFILE  )     ( STEM /PROFILE  )
(  " /TANGENT  )     (  " /TANGENT  )
(  " /ECCENTRICITY  )     (  " /ECCENTRICITY  )
(  " /HALFSIDING  )     (  " /HALFSIDING  )
( STERN /PROFILE  )     ( STERN /PROFILE  )
           (PMB /AFT         )      (PMB /AFT    )
           (PMB /FORWARD     )      (PMB /FORWARD)
(  " /TANGENT  )     (  " /TANGENT  )
(  " /ECCENTRICITY )     (  " /ECCENTRICITY )
(  " /HALFSIDING  )     (  " /HALFSIDING  )
... < /BUFFER >

Description

To calculate the coordinate(s) at one or more requested U or V values on the current curve.

To calculate the intersection coordinates of any two curves that means, 2D with 2D, 2D with 3D or 3D with 3D. The user must be aware that when using the 3D/3D intersection the curves may appear to cross on the 2D graphics screen but may not intersect in 3D space.

Command Qualifiers

Examples

INTER /U=2.45
INTER /V=3.1 /BUFF
INT SEC 3 KNU knuo1
INT PLI p1 TAN t1

JOIN

Purpose

To join the two halves of a ship which have been modelled separately.

Syntax

JOIN $W ( SECTION $N ) < %SAVE < $W > >
( PLINE $W  )
( TANGENT $W )

Description

Using the JOIN command, a second design can be joined with the current ship at a common Section, Pline or Tangent. The merged ship can optionally be saved with a new name.

If two curves with the same name or position exist in the two designs and have a common intersection point, they will be joined and any discontinuity at the join will be removed. If no common intersection exists then the following actions are taken:-

• Knuckles, Tangents, Plines, Diagonals, Clines, Patches, - The curve from the joining design will be stored with the character "1" appended to the name. If this curve also exists, then the character "2" will be tried and then "3", and so on. If the curve name is 8 characters long then the 8th character will be replaced with "1", "2",

• Boundary curves - The curve from the joining design will be saved as a Tangent curve.

• Waterlines, Buttocks - The curve from the joining design will be stored as a Pline with name Wposition or Bposition. For example, Waterline 2.5 in the joining design which has no common intersection with Waterline 2.5 in the current design will be saved as Pline W25000.

Patch definitions only are merged into the current design. The Patches will need to be refitted by the user.

KNOT

Purpose

To insert or remove knots from the current curve.

Syntax

KNOT INSERT ( /CURSOR )
( /U= $N  )
( /V= $N  )
( /P= $N  )
-----------------
REMOVE < /CURSOR  >
< /TOL= $N >

Description

This command is used in conjunction with the ADJUST command which is used to make local modifications to the current curve. Since the ADJUST command only changes up to four spans in the current curve it can been determined that adding new Knots in the curve will further localise any changes made to the curve using the ADJUST command. the converse is true if Knots are removed.

During Knot insertion or removal every effort is made to maintain the shape of the curve however when removing some Knots this will obviously not be possible.

Command Qualifiers

Examples

KNOT REMOVE
KNO INSERT /CURSOR
KNO INS /U=2.125

LINE

Purpose

To fit a straight segment within the current curve.

Syntax

LINE < /PERMANENT >

Description

There are two methods for introducing a straight line segment within a curve. The first is a manipulation of the mathematics of the curve, similar in concept to the ADJUST command, and the other is by the adding special points which control the fitting algorithm.

Command Qualifiers

Examples

LINE
LINE /PERMANENT

MAGNIFY

Purpose

To magnify curvature value.

Syntax

MAGNIFY $N

Description

This command allows the user to change the magnification factor used by the DISPLAY CURVATURE command. The effect of this command is to emphasise the changes in slope of the curve. This is primarily of use when viewing very small or narrow windows.

If a negative number is input then the curvature will appear on the other side of the curve.

Examples

MAGNIFY 2
MAGNIFY -2
MAG 0.01

MANUAL

Purpose

To allow the user to manually select the position of the knots for the B-spline curve fit.

Syntax

MANUAL ( END  )
( KNOT  )
( KNUCKLE )
( POINT  )
( TANGENT )
-------------------------------
( START  ) < /RANGE < /NUMBER $S > >
  < /RANGE < /CURSOR  > >

Description

Manual selection of knots allows the user a large degree of control when fitting a Spline through scattered data by applying Least Square (LSQ) fit to facilitate the fairing process. By using manual selection, the user is able to identify the KNOT, KNUCKLE and TANGENT positions on the Spline for the whole curve or part of it by specifying a range through which the LSQ fit will be applied.

The user begins the MANUAL selection by issuing the MANUAL START command followed by any number of MANUAL KNOT, MANUAL KNUCKLE, MANUAL TANGENT or MANUAL POINT commands as required. When any of these options are issued the cursor will appear on the screen thus prompting the user to select the data points to be identified as either KNOTS, KNUCKLES, TANGENTS or POINTS. The cursor will remain active until it is cancelled by selecting the CANCEL CURSOR box.

Once all the points selected for the manual fit have been entered the user should then issue the command MANUAL END. The user should check that the manual fit has achieved the required result by displaying the curve before accepting it.

The PREFIT command must NOT be used with the MANUAL command as it re-fits the curve through the original points thus cancelling any MANUAL knot selection.

The user may also partly fit the spline with a LSQ by giving the range or ranges through which the LSQ fit will be made. In this case the user should issue the MANUAL START /RANGE command. The user is then required to define pairs of points defining the range of the LSQ fit. These points can be selected by using the cursor or by specifying their reference numbers.

Rules for Manual Knot Selection:

1. Maximum number of user knots = Number of data points - 4.

2. The user should not place any knots at the first and last two data points on the curve.

3. If a knuckle (3 coincident knots) is inserted into the curve no knots should be inserted at either of the data points adjacent to the knuckle point.

4. If a curvature (second derivative) discontinuity (2 coincident knots) is inserted into the curve a knot can only be inserted at the adjacent point on one side of the discontinuity point. The additional knot adjacent to the discontinuity is inserted on the side where the curvature is controlled.

Examples

MANUAL START
MAN KNOT
MAN TANGENT
MAN KNUCKLE
MAN POINT
MAN END
MAN START /RANGE /CU
MAN START /RANGE /NUMBER 3.1 9.5 102.0 109.5

MARK

Purpose

Assign curves to a Plate so that they appear as marked on lines.

Syntax

MARK < PLATE > ( $W < $W > ) ( BUTTOCK  ) ( $N )
  ( /ALL    ) ( SECTION  )
      ( WATERLINE )
      ---------------
      ( DIAGONAL ) ( $L )
      ( KNUCKLE  )
      ( PLINE  )
      ( TANGENT  )
      ----------
      ( FOB )
      ( FOS )
      -------
      ( /NONE) 

Description

In order to facilitate the assembling of the Plates, lines may be marked on the Plate for reference. The user can provide these reference lines by MARKing the Plate(s) with the appropriate curves.

The first name supplied is the Strake name. The second name, if supplied, is the Plate name. If only the Strake name is given then all Plates within that Strake are modified. Wildcards are allowed.

Examples

MARK straka * PLINE aft
MARK strakf fwd KNUCKLE kfwd

MODIFY

Purpose

To extract a stored curve from the design and make it current.

Syntax

MODIFY ( ANGLE  ) ( $W ) < /INTERACTIVE >
( CAMBER  )
( CLINE  )
( DIAGONAL )
( KNUCKLE  )
( PLINE  )
( SAC  )
( SHEER  )
( TANGENT  )
------------------------
( BUTTOCK  ) ( $N ) < /NEW >
( SECTION  )
( WATERLINE )
------------------------
( FOB )
( FOS )
-----------------------
( STEM  ) ( /PROFILE  )
( STERN ) ( /RADII  )
  ( /TANGENT  )
  ( /ECCENTRICITY )
  ( /HALFSIDING  )
  ( /TRANSITION  )
         ----------------------
        PMB ( /AFT     )
            ( /FORWARD )

Description

This command allows the user to modify a previously stored curve by retrieving the curve and the original points and making them current.

If the user wishes to interpolate new points the /NEW option should be used.

Note that if the retrieved curve has been previously manipulated with the ADJUST command the stored points may no longer match the displayed curve, the user should NOT PREFIT the curve as this fits a curve through the original data points.

By appending the /INTERACTIVE qualifier, the curve is not immediately modified, but is, instead, marked for editing/patch boundary with the Patch and Curve Editor.

Examples

MODIFY SEC 2
MODIFY BUT 4.0 /NEW
MOD PLI po1

MOVE

Purpose

Move selected points on the current curve to a new position. Move all points so they lie on the curve.

Syntax

MOVE ( /ALL )
----------------------
< /NUMBER $N > ( /CURSOR )
  ( $N $N  )

Description

This command allows the user to move a data point from the current curve by using the cursor or by specifying its new local axis coordinates that means, U and V on the command line.

Note:
If a point on a 3-D curve is to be moved the user may need to MOVE the point in two different views to achieve the desired result.

Command Qualifiers

Examples

MOVE /CU
MOV /CU
MOV 4.0 3.0
MOV 2.12 3.274
MOV /NUMBER 10 3.45 6.78
MOV /NUM 5 /CU
MOV /ALL

OFFSET

Purpose

Offset selected point on the current curve by a specified amount.

Syntax

OFFSET < /NUMBER $N > ( /U= $N )
  ( /V= $N )
  ( /U= $N /V= $N )

Description

This command allows the user to offset a selected point by a specified amount in the local axis system, that means, U and V.

Command Qualifiers

Examples

OFFSET /U=0.003 /V=0.01
OFF /V=0.004
OFF /NUM 17 /U=0.005 /V=-0.0046

OUTPUT

Purpose

To output PATCH data for use in the HULLSURF system and PLATE data for use in the BRITSHELL system.

Syntax

OUTPUT ( IGES ) ( /ALL )( /FILE= $F )
  ( $L  )
--------------------------------
( NURBS ) ( /ALL ) < $N > < /AXIS > /FILE= $F )
   ( $L  )
--------------------------------------------------
( PATCH ) ( /ALL < /STORED > ) < /NOCONT INUITY > < /SHOW >
  ( $L < /STORED  > )
  -----------------
  ( $L < /FILE= $F > )
  -----------------
  ( /AUTO )
-------------------------
( VRML ) ( /ALL )( /FILE= $F )
  ( $L  )
-------------------------
( PLATE ) ( $W < $W > )
  ( /ALL    )

Description

This command allows the user to output Patches or Plates which were defined using the GENERATE command.

The curves defining the Patch or Plate are extracted. These are then intersected and then girthed and a mesh of points is calculated. The number of points which are output for each curve is set by the DEFINE HULLSURF/BRITSHELL DATA_SIZE commands and are spaced on an equi- girth basis.

OUTPUT IGES

Outputs the Patches in IGES 128 format. The patches must previously have been fitted and stored using the /STORE option of this command.

OUTPUT NURBS

Output Patches to a Design Model ( DML ) file for subsequent access by other AVEVA Marine modules. The patches must previously have be fitted and stored using the /STORE option of this command. The optional number $N defines the layer onto which the Patch is stored in the DML. The /AXIS option specifies that the design's Axis convention should persist into the DML file.

OUTPUT PATCH

PATCH data can be output to a file, in HULLSURF CREATE format, or output to a PATCH data store.

The tolerance used to determine whether a Patch boundary intersects with other defining curves is set using the DEFINE HULLSURF /PATCH_TOL command, the default value is set at 0.001.

Parameter Qualifiers

OUTPUT VRML (Windows Only)

Patch data is output to a Virtual Reality Modelling Language (VRML) file (format version 2.0). This can be viewed using a standard VRML viewer.

OUTPUT PLATE

PLATE data is output to the currently open Plates Data Store ( PDS ). The first name supplied is the Strake name. The second name, if supplied, is the Plate name. If only the Strake name is given then all Plates within that Strake are output. Wildcards are allowed. Before a Plate can be OUTPUT for use in the BRITSHELL system a Plates Data Store must exist and be open for access

See also the commands ADD, DEFINE BRITSHELL, DEFINE HULLSURF, DISPLAY, GENERATE, CONTINUITY and PDS.

Examples

OUTPUT PATCH P1
OUT PAT /ALL /NOCONTINUITY /AUTO
OUT PAT /ALL
OUT PAT p01 /FILE= pat1.dat
OUT PLATE str1 p1
OUT PLATE str2
OUT IGES aft1 aft2 aft3 /FILE aft.igs
OUT NURBS /ALL 10 /FILE n161057

PAN

Purpose

To pan the design in a graphics view

Syntax

PAN < /CURSOR > < /REDISPLAY >
< $N $N  >

Description

The PAN command allows the user to move the view in the graphics window. The /CURSOR option allows the user to interactively pan by selecting two points in the window. Alternatively the offset can be given as arguments to the command.

Command Qualifiers

Examples

PAN /CURSOR /REDISPLAY
PAN 1.2 -3.5

Patch Offset

Purpose

To generate or check an offset surface.

Syntax

PATCH OFFSET $W $N
-------------------
CHECK ( $L  )
( /ALL )

Description

This command is used to generate or check an offset surface.

An offset surface is generated by providing a name and a distance. Each patch of the OUTER surface (the surface fitted from the orthogonal and 3d curves), is offset by the given distance in a direction normal to the OUTER surface. The resultant surface can be selected as the "current" surface using the DEFINE SURFACE command.

The integrity of an offset surface can be checked by using the CHECK option. In this case, some or all of the patches of the surface can be checked.

Examples

PATCH OFFSET INNER 0.1
PATCH OFFSET INNER CHECK /ALL
PATCH OFFSET INNER CHECK AFT1 AFT2 AFT3

PDS

Purpose

To manipulate a Plates Data Store.

Syntax

PDS ( CLOSE ) ( /NOSAVE )
  ( /SAVE  )
-------------------
( DELETE ) ( $W < $W > )
-------------------
( DIRECTORY )
-------------------------
( OPEN ) ( $F ) < /NEW >
    < /READ_ONLY >

Description

This command has several options for the manipulation of a Plates Data Sore ( PDS ). A PDS is used by the BRITSHELL system which is used in the production of output for Plate manufacturing.

Command qualifiers

Examples

PDS OPEN fwdsec.pds /NEW
PDS DIR
PDS CLOSE /SAVE

PREFIT

Purpose

Fits a B-Spline through the current data points using the prefit knot algorithm.

Syntax

PREFIT < /CENTRIPETAL > < /SCALE < /X= $N > > < /CLOSE >
   < /Y= $N >
   < /Z= $N >

Description

The prefit algorithm selects the knot positions to ensure that the B-spline passes through all the data points. It also automatically inserts knuckles and tangent constraints where appropriate, that means, at Knuckle and Tangent points which have either been Set by the user or through interpolating other curves. If any Knuckle or Tangent points have an Angle associated with them then this is also take into account.

Command Qualifiers

Examples

PREFIT /CENTRIPETAL
PREFIT /SCALE /X 10

PRINCIPAL

Purpose

Used to visually check the curvature of a patch.

Syntax

PRINCIPAL < PATCH > $L
  /ALL

Description

Principal curvature is shown at each mesh intersection and is displayed as TUFTS. Tufts can be displayed for one or more patches, with the number of being controlled by the MESH parameter (see DEFINE command).

DEFINE (Hullsurf) (Mesh_Size=) ($N)

PROJECT

Purpose

Project a stored 3D curve into two 2D CLINE curves.

Syntax

PROJECT ( KNUCKLE $W ) ( BUTTOCK ) ( SECTION  ) ...
( PLINE $W  )   ( WATERLINE )
( TANGENT $W )
  ----------------------
  ( SECTION ) ( BUTTOCK  ) ...
    ( WATERLINE )
  ----------------------
  ( WATERLINE ) ( BUTTOCK ) ...
    ( SECTION )

... <$W $W > < /AUTO < KNUCKLE > $W < NOSAVE > >
   < PLINE  >
   < TANGENT >

Description

The selected 3D curve will be projected into the two user selected views. Two different views must be chosen. This will cause two CLINE curves to be created with their names derived from the name of the 3D curve and the view. These new curves will be stored in the CLINE directory and will be Data points will NOT be calculated for the CLINES.

The system will automatically display the projected CLINES for fairing in turn, which can be modified using the ADJUST command and the ACCEPTing. When the required changes have been made to both CLINES the 3D curve can be reconstructed using the CREATE curve-type curve-name MERGE command. See the CREATE command for further details.

Naming Convention

The names of the CLINES will be derived as follows:

For example the command

Note that because of this naming convention the number of characters in the name of a 3D curve that is to be projected is limited to a maximum of 7.

This example will project PLINE bar into BUTTOCK and WATERLINE views using CLINE 1 and 2. The AUTO option indicates automatic 3D fairing. If no second curve is given, then the merged curve will be of the same type as the projected curve. If the NOSAVE option is given then the CLINES will be deleted after the merge.

PROJ PLI bar BUT WAT CLINE1 CLINE2 /AUTO KNUCKLE KNU1 /NOSAVE

Examples

PROJECT KNUCKLE aft SECTION BUTTOCK
PROJ PLI bar BUT WAT

PROPERTIES

Purpose

Calculates basic hydrostatic properties.

Syntax

PROPERTIES < /LOWER= $N > < /UPPER= $N > < /FILE= $F >

Description

This command allows the user to output basic hydrostatics properties for the whole ship or a part of it by using the appropriate option. In order for the PROPERTIES command to function the current curve must be a Sectional Area Curve (SAC).

The following properties are calculated at the Draft and Trim used when GETting the SAC, see also the GET SAC command:

• Volume for both port and starboard

• SAC draft at AP

• SAC draft at MIDSHIPS

• SAC draft at FP

• TRIM

• LCB (Longitudinal Centre of Buoyancy)

• Cm (midship Area Coefficient)

• Cb (Block Coefficient)

• Cp (Prismatic Coefficient for full ship, entrance and run)

• Maximum section area position

• Parallel body start and finish

When calculating properties for portions of a ship only the Volume and LCB are calculated.

Command Qualifiers

Examples

PROPERTIES
PROP /LOW 34.5
PROP /LOW 10 /UPP 56 /FILE= prop.dat

QUIT

Purpose

Quit manipulation of the current points and curve.

Syntax

QUIT < /BUFFER >

Description

The current set of points and associated curve are discarded. Any modification to the data is lost. If the user wishes to save any modifications the ACCEPT command should be used instead.

Command Qualifiers

Examples

QUIT
QUI /BUFF

REDO

Purpose

To redo the last operation on the current curve.

Syntax

REDO

Description

Whilst fairing a current curve, operations can be undone and then redone again, similar to Undo and Redo functions in a word processor. If an operation (remove point, adjust vertex, auto fair, ) has been undone, the REDO command will redo that operation. Up to 100 operations can be undone and redone.

Examples

REDO

REFIT

Purpose

Refits selected orthogonal curves.

Syntax

REFIT ( BUTTOCK    ) ( /ALL    ) ...
( SECTION    ) ( $N THRU $N < INC $N > )
( WATERLINE < /STEM  > ) ( $S    )
(  " < /STERN > )

... < /TOL= $N > < /DATE > < /NEW > < /CONFIRM >

Description

This command analyzes each selected curve and checks whether the curve needs to be adjusted. The criteria for refit are that the curve must intersect the other orthogonal curves and give a consistent result. If an appropriate view is set then the adjusted curve will be displayed.

• Sections are matched against Waterlines and buttocks at the appropriate X value.

• Waterlines are matched against Sections and Buttocks at the appropriate Z value.

• Buttocks are matched against Sections and Waterlines at the appropriate Y value.

It should be noted that an AUTOMATIC ADJUST of the B-Spline mathematics is performed, see the ADJUST command, and the curve is NOT actually refit through the data points.

For the command to perform with reasonably good results the user must ensure that the MATCHING curves are CONSISTENT and FAIR. If this is not the case then UNPREDICTABLE results may occur. Therefore, the command must be used with CARE.

Command Qualifiers

Examples

REFIT SECTION /ALL /CONFIRM
REFIT WATERLINE 1 THRU 9 /DATE /NEW /CONFIRM

REGENERATE

Purpose

Regenerate existing patches.

Regenerate existing 3D curves (Plines, Tangents, Knuckles)

Syntax

REGENERATE ( PATCH ) ( /ALL ) < /DATE >   ( $L  )
       -----------------------------
       (KNUCKLE) ( /ALL )
       (TANGENT) ( $L )
       (PLINE )

Description

The command is used to regenerate patches or 3D curves.

A patch can be forced to regenerate if the /DATE qualifier is omitted. The /DATE qualifier is used to regenerate patches where the bounding curves have changed since the patch was defined.

Command Qualifiers

REMOVE

Purpose

To remove requested data points from current curve or from the points buffer.

Syntax

REMOVE < /NUMBER $S > < /BUFFER >
< $N  >

Description

This command allows the user to remove selected data points from the current curve or from the POINTS BUFFER.

Note, the coordinates and type of the last points removed are remembered so they may be replaced using the REPLACE command.

Command Qualifiers

Examples

REMOVE
REM /BUFF
REM /NUMBER 29 30 31 34

REPLACE

Purpose

To replace points that have been REMOVED.

Syntax

REPLACE < /ALL >
< $N  >

Description

This command allows the user to replace the last 'n' points or all points removed by the REMOVE command. The points are replaced in the current points area and redisplayed on the graphics screen if a suitable view has been selected.

Command Qualifiers

Examples

REPLACE
REP 4
REP /ALL

RESET

Purpose

To reset the current view window to a previous window display or to the default display.

Syntax

RESET < $N > < /REDISPLAY >

Description

Each time the user performs a WINDOW command the limits of the window are recorded and assigned a reference number. Window reference numbers begin at 0 and increase sequentially by 1 up to a maximum of 10. The user can RESET to any of these windows by specifying its reference number. The VIEW command sets the window reference count 0.

Command Qualifiers

Examples

RESET
RES 2
RES /REDISPLAY
RES 1 /RE

SAVE

Purpose

Saves all modifications made to the design.

Syntax

SAVE < /RENAME= $F >

Description

In order to minimize the risk of corruption a design is only ever open for brief moments during the run of the system. Whenever a design is opened a copy is made of it to a WORKFILE and the original design is closed. All interactions are made with this WORKFILE and the original design is not modified until a CLOSE/SAVE, EXIT/SAVE or SAVE command is issued. The SAVE command copies the current contents of the WORKFILE to the active design thus preserving all changes.

Users should perform regular SAVEs at convenient intervals, especially before attempting operations where the results may be uncertain, and to avoid loss of work due to computer system problems.

Command Qualifiers

Examples

SAVE
SA /RENAME= trawler

SCALE

Purpose

To scale the principle ship dimensions

Syntax

SCALE ( BEAM= $N  ) < DEPTH= $N >
  -----------
< DRAFT= $N >
-----------------------
( DEPTH= $N )
-----------
( DRAFT= $N )
-----------------------------------
( LBP= $N  ) < BEAM= $N  > < DEPTH= $N >
    -----------
    < DRAFT= $N >

Description

This ship can be lineary scaled in the X,Y & Z directions by giving the new values for the LBP, BEAM and/or DEPTH. Note that the values in the General Particulars will also be scaled.

A change in the Z-height can be made in terms of DEPTH or Design DRAFT. When using the DRAFT option the system will work out the ratio of change between the old draft and the new draft and this will be used to calculate the new depth.

When scaling a design it should be noted that due to mathematical rounding , curves that were once at convenient whole number intervals may be shifted to less convenient values. Whereas this may be the desired result it may be necessary to re-fit the affected curves.

Examples

SCALE LBP 230
SCA LBP 180 BEAM 23 DRA 10

SET

Purpose

To set a point to an alternative type or to assign an Angle.

Syntax

SET < /NUMBER $S > ( KNUCKLE )
  ( POINT  )
  ( TANGENT )
----------------------------------
     < /NUMBER $N > ( ANGLE ) ( /LOWER= $N   )
                     ( /UPPER= $N   )
                     ( $N < $N >  )
                     -----------------
                     ( RESET ) < /LOWER >
             < /UPPER >

Description

This command allows the user to the set point type of any point in the current curve. After issuing the command the graphics cursor is used to indicate the point required. Positioning of the cursor need only be approximate as the nearest point is used.

For Knuckle and Tangent points the user can also assign an ANGLE to that point. When a curve is fitted with these ANGLE POINTS set the fitting algorithm will ensure that curve passes through these points with the specified angle. Knuckle points can have both a LOWER and UPPER angle whereas Tangents have only one angle. the angle can be removed from a point by using the OFF or RESET option, these have an identical function with OFF being the preferred syntax. The /NUMBER option allows the user to identify the point by its index rather that using the cursor.

Examples

SET KNU
SET ANGLE 45
SET ANGLE /UPPER 30
SET ANGLE 0 90
SET /NUM 5 POINT
SET /NUM 25 ANGLE 90 170

SORT

Purpose

• Sort current points.

• Reorganize patch generation order.

Syntax

SORT ( /AROUND ) ( CLINE $W )
  ( /CURSOR  )
--------------------
( /MANUAL  )
( /NEAREST )
( /X  )
( /Y  )
( /Z  )
      ------------------
      PATCH ( START         )

             ( /NAME $W   )

             ( END < /FIT > )

Description

This command allows the user to either

• re-order the points using one of the methods described below, or

• reorganize patch generation order

Command Qualifiers for point sorting

Command Qualifiers for patch organization

Examples

SORT /X
SORT /AROUND
SORT /NEAR
SORT /MANUAL

SORT PATCH START
SORT PATCH /NAME FOB1
SORT PATCH /NAME FOB2
...
SORT PATCH /NAME FWD23
SORT PATCH /NAME FWD24
SORT PATCH END /FIT

SPLIT

Purpose

To split a ship design into two separate designs.

Syntax

SPLIT ( SECTION $N ) < $W $W >
( PLINE $W  )
( TANGENT $W )

Description

Using the SPLIT command, a ship can be split at a given Section, Pline or Tangent. Two new designs are created. If new names are not given by the user then, for example, a design ship will be split into shipa and shipf.

If a Pline or Tangent is used as the split point, then the curve must be in an orthogonal x-plane.

When the ship is split, a new Tangent, with an associated Angle curve, is created and copied to the two new designs in order to maintain the correct tangency at the split. The Tangent will have the name Txposition. For example, if the ship is split a x=21.0, then a Tangent with name T21000 will be created.

Any patches which cross the split will be lost.

SWITCH

Purpose

To switch selected stored data on or off.

Syntax

SWITCH ( BOUNDARY  ) ( /OFF ) < /CONFIRM >
( FOB  ) ( /ON  )
( FOS  )
( STEM /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY  )
(  " /HALFSIDING  )
          (      "     /TRANSITION       )
( STERN /PROFILE  )
(  " /RADII  )
(  " /TANGENT  )
(  " /ECCENTRICITY )
(  " /HALFSIDING  )
       (      "      /TRANSITION      )
       (PMB /AFT            )
       (PMB /FORWARD        )
----------------------------------------
( ANGLE  ) ( /ALL ) ( /OFF ) < /CONFIRM >
( CLINE  ) ( /$L  ) ( /ON  )
( KNUCKLE  )
( TANGENT  )
( PLINE  )
( DIAGONAL )
( PATCH  )
( SAC  )
----------------------------------------------------
( BUTTOCK  ) ( /ALL    ) ( /OFF ) < /CONFIRM >
( DECK $W  ) ( $N THRU $N < INC $N > ) ( /ON  )
( DESIGN  ) ( $S    )
( SECTION  )
( WATERLINE )
-----------------------------------------
( PLATE $W < $W > ) ( /ALL ) ( /OFF ) < /CONFIRM >
    ( /$L  ) ( /ON  )

Description

The SWITCH command is a means of omitting data from calculations or outputs. For example, extra building Frames may be required for plotting purposes but not required for the generation of a Sectional Area Curve.

When an element is switched off it remains in the design but is not used by the LINES SYSTEM.

Note that a curve that is switched off is:

• Not used when interpolating data points for a new curve, for example, if the user has switched off a Waterline, then when a new section is to be interpolated from Waterlines, using the GET or FIT commands, the Waterline in question is not interpolated.

• Not normally displayed unless specifically requested with the DISPLAY /OFF or /BOTH qualifiers.

• not used when issuing the AREA /ALL command.

Also a switched off Patch or Plate is:

• Not output when the OUTPUT command is issued.

• Not displayed when the DISPLAY command is issued.

Command Qualifiers

Examples

SWITCH SECTION 1.0 /OFF
SW BUT 5.0 /ON
SW KN transom /OFF
SW WAT /ALL /ON
SW BOU /OFF
SW SECTION 1 THR 30 INC 2 /ON /CONFIRM
SW TAN aft* /ON

TRANSLATE

Purpose

To move the internal coordinates of all curves and patches in the design.

Syntax

TRANSLATE < $X= > $N < $Y= > $N < $Z= > $N

Description

All X, Y and Z coordinates of every curve and patch are moved by the values given in the command. General particulars and axes are also moved.

Examples

TRANSLATE /X=6.5

TRANSLATE 5 0 1

TRANSPOSE

Purpose

To transpose all Orthogonal, Boundary and 3-D curves after the SAC curve has been modified.

Syntax

TRANSPOSE < /ALL  > < /ACCEPT  > < /FILE=$F >
< BOUNDARY  > < /NOACCEPT >
< BUTTOCK  >
< DIAGONAL  >
< KNUCKLE  >
< PLINE  >
< SECTION  >
< TANGENT  >
< WATERLINE >

Description

This command allows the user to transpose stored curves based on the modifications performed on the Sectional Area Curve. See GET SAC and VARIATION commands.

If SECTIONS are transposed their old and new positions are tabulated to the screen or to a file.

Note that when TRANSPOSING individual line-sets for example, Sections, the required transformation may take some of the curves outside the ships boundaries. It is recommended that the BOUNDARIES and 3D space curves are also transposed.

It should also be taken into account that TRANSPOSING orthogonal curves that were once at convenient whole number intervals may be shifted to less convenient values. Whereas this may be the desired result it may be necessary to re-fit the affected curves.

Command Qualifiers

Examples

TRANSPOSE /ALL /NOACCEPT
TRAN SECTION /ACC /FILE=trans.sec
TRAN BOUND /ACC
TRAN PLI

UNDO

Purpose

To undo the last operation on the current curve.

Syntax

UNDO

Description

Whilst fairing a current curve, operations can be undone and then redone again, similar to Undo and Redo functions in a word processor. The UNDO command will undo an operation (remove point, adjust vertex, auto fair, ) on the current curve, returning it to its state previous to that operation. Up to 100 operations can be undone and redone.

Examples

UNDO

UPDATE

Purpose

To update the selected Orthogonal curves to match the changes made to the current curve.

Syntax

UPDATE < BUTTOCK  > < /NOACCEPT > < /LOCAL >
< SECTION  >
< WATERLINE >

Description

As a curve is being modified the user can at any time force an update of the related orthogonal curves to take account of the changes. The updated curves are displayed in an appropriate view.

Command Qualifiers

Examples

UPDATE SECTION
UPD WAT /NOACC
UPD BUT /LOCAL

USE

Purpose

To select/show parameters to control the following system facilities:

• Curves to be interpolated

• Fitting of Waterline Endings

• Section curves numbering convention

• (Un) Equal scaling of graphics

• Fitting of Decks

• Curve Endings

• Single Input/Output data file

• Normalised SAC representation

• Curvature representation

• Graphics Output device

• Loftbook Generation

• Tablet based menu

Syntax

USE ( /SHOW )
-------------------------------------
    ( CD         ) < /ON  > NOTE: /ON default
    ( DESIGN   ) < /OFF >
    ( DIAGONAL  )
    ( FOB      )
    ( FOS      )
    (PMB      )
    ( FRAME    )
    ( SCALE    )
    ( STATION  )
       -----------------------------------------------
       (SECTION     ) < /ALL >
( WATERLINE ) < $N < THRU $N < < INCREMENT > $N >
       (BUTTOCK     ) < $S >
-----------------------------------------------
( CAMBER ) ( $W  )
( CLINE  ) ( /OFF )
( SHEER  ) ( /ON  )
------------------------------------------------------
...

...
USE ( HALFSIDING ) < /STEM  > < /OFF >
( ELLIPSE  ) < /STERN > < /ON  >
( CIRCLE  )
( ENDSURFACE )
--------------------------------------
( DATA FILE ) ( /INPUT  ) ( /FILE= $F )
  ( /OUTPUT ) ( /OFF  )
-----------------------------------------------------
( GUNWHALE ) < /CONSTANT < /TANGENT > > < $N $N $N < $N $N > >
  < /VARYING  >
  -----------
  < /OFF >
  < /ON  >
---------------------------------------
( MANUAL  )
( PRESELECTED ) NOTE: PRESELECTED default
---------------------------------------
( NORMALISE_SAC ) < /OFF >
  < /ON  >
---------------------------------------
( TUFT ) ( /ON  )
  ( /OFF )
  ( $N  )
----------------------------------
( *LOFT ) ( /MODE=) ($N      ) ...
             (/CSV)
    ... </ROWS $N> </COLUMNS $N> ...
    ... </SURFACE </TOL=$N>> </FILE=> ($F)
---------------------------------------------------
( *PLOTTER ) < /SURFACE > < /FILE= > ( $F )
---------------------------------------------------
( *SCREEN )
( *TABLET )
( *VDU  )

USE /SHOW

Lists the current settings of all the USE parameters.

USE CAMBER or SHEER

The named Camber or Sheer is made current and will be used in the creation of any subsequent Deck frames.

Examples

USE CAMBER cammdk
USE SHEER shmdk
FIT DECK main /ALL

USE CD, FRAME or STATION

Selects the numbering convention to be used in specifying an x-value. Any x-value can be entered in terms of Constant Dimension (CD), a Frame number or a Station number. The CD number represents the true value on the x-axis, the Frame number is defined by a user input Frame Table (see CREATE FRAME command) and the Station number represents a user defined constant spacing (see the DEFINE AXIS command).

Examples

USE CD
USE FRAME
USE STATION

USE DATA FILE

This option allows the use of partitioned input and output files that means, all input data to be contained in one file and all output data to be written to another. The format of a partitioned data file is as follows:

The user may revert to separate data files by using the /OFF option.

The /SHOW option will show the user if the single data files are switched on or off and also the names of the files contained within the single input data file, if one is switched on.

Examples

USE DATAFILE /INPUT /FILE= mydata.In
CREATE STERN /PROFILE /FILE=sterndat
USE DATAFILE /OUTPUT /FILE= mydata.out
DATA POINTS /FILE= points.dat
USE DATAFILE /SHOW
USE DATAFILE /OFF

USE DESIGN, SECTION, WATERLINE, BUTTOCK or DIAGONAL

When performing a GET or FIT command the system either obtains point data from the DESIGN directory ( Sections only ), or by interpolating stored curves. This command is used to select the source of the required data.

The following table illustrates which data can be used to create these curves:

The table Illustrates which data can be used to create these curves.

If a range or series of values is given for sections, waterlines or buttocks, then these values will be used when generating a loftbook from the surface.

Examples

USE SEC
USE BUT /OFF
USE SEC 0 THRU 10 inc 0.1

USE FOS, FOB and PMB

When obtaining points for orthogonal curves using either the GET or FIT commands the system can be set to omit or include points within the Flat of Bottom (FOB), Flat of side (FOS) and Parallel Midbody (PMB) regions.

When set to OFF, which is the DEFAULT state, orthogonal curves within these regions are NOT interpolated but two Tangent points are inserted relating to the entry into and exit from the FOB and FOS areas

In order for this option to function correctly the FOB and FOS areas should be defined as closed curves that means, the curve being interpolated should cross the FOB or FOS curve twice. If the system cannot determine the flat area then all points will be included.

Examples

USE FOB /ON

USE GUNWHALE < /CONSTANT > Radius < fade-in-x > Aft-x Fwd-x < fade-out-x > < /VARYING >

This option is used when creating Decks and defines the Gunwhale or turns it ON or OFF.

A Gunwhale is defined by specifying its Radius followed by two to four values which define the longitudinal extent of the Gunwhale.

If only TWO longitudinal vales are given then the Gunwhale will be parallel between these two values.

If THREE values are given then these are taken to be a fade-in to a parallel section.

If FOUR values are given the Gunwhale is created as a fade-in, parallel and fade-out section.

In addition when using a fading Gunwhale the user may opt to have a CONSTANT ( the DEFAULT ) or VARYING radius over the fading regions by specifying the appropriate keyword.

Examples

USE GUNWHALE 0.5 60.0 70.0
USE GUN 0.75 40 50 60
USE GUN /VARYING .4 40 50 60 75

USE HALFSIDING, ELLIPSE, CIRCLE or ENDSURFACE

These options select the type of waterline endings and frame feet required at the Stem and Stern profiles.

Examples

USE HALF
USE ELLI

USE NORMALISE_SAC

This option indicates that the system should use normalised area values for the SAC. If this option is used then the maximum sectional area becomes 1.0.

USE MANUAL or PRESELECTED

When fitting a curve to a set of data points the user has the option to select the Knot positions (defined using the MANUAL command) or let the system automatically assign the Knot positions (PRESELECTED). This option selects which method to use.

USE SCALE

This option indicates that the system should use differential scaling for the U and V axes so that views will fill the entire graphics area. Normally the U and V scales are both the same.

Examples

USE SCALE
USE SCALE /OFF

USE TUFT < $N >

By default when the Curvature is displayed it is drawn as a continuous curve which follows the curve. When the USE TUFT command is used the curvature is drawn as vectors normal to the curve. The length of the vector indicates the magnitude of the curvature at that point. The number of TUFT vectors per span can be altered by supplying a number. See also MAGNITUDE command.

USE *LOFTBOOK

This option indicates that a loftbook is to be created with the given name. Subsequent CROSS and DIRECTORY command will be output to the loftbook. The loftbook is closed by issuing the USE *SCREEN command. The additional qualifier /MODE allows the user to select 80 or 132 column output or comma delimited (CSV) output. The number of rows and columns per page can be altered by specifying the /ROWS and /COLUMNS qualifiers.

If the /SURFACE qualifier is given, then the loftbook is created from the surface patches instead of curves. If the /TOL qualifier is given, then offset table data for 3D curves is checked and the user is warned if the data is further away from the surface than the given tolerance.

Examples

USE *LOFT LOFTBOOK.LIS
USE *LOFT /MODE=80 loft80.lis

USE *PLOTTER

This option indicates that a plot file is to be created with the given name. All subsequent graphical operations will cause plot instructions to be written to the plot file. The plot file is closed by issuing the USE *SCREEN command.

The plot file is a simple sequential text file. Each line of file contains one of the following commands starting in the first column:

The plot file commands.

The additional qualifier /SURFACE indicates that the sections, waterline and buttocks will be drawn from the surface, rather than from the curves.

Examples

USE *PLOT lines.plt
USE *PLOT /SURFACE surf.plt

USE *SCREEN

This option is used to close the Loftbook and Plotfile thus returning to normal interactive graphic manipulation.

USE *TABLET and *VDU

These options swap between keyboard and bitpad menu operation.

VARIATION

Purpose

To carry out either 1-CP or LACKENBY shifts to a current SAC.

Syntax

VARIATION ( /CP ) ( /CB=$N ) < /AFT  >
     < /FORWARD >
--------------------------------------------------
( /LACKENBY ) ( /CB=$N ) < /LCB=$N > < /PBA=$N > < /PBF=$N >
--------------------------------------------------
  ( /LCB=$N) < /CB=$N > < /PBA=$N > < /PBF=$N >
--------------------------------------
( /PBA=$N) < /CB=$N > < /LCB=$N > < /PBF=$N >
--------------------------------------
( /PBF=$N) < /CB=$N > < /LCB=$N > < /PBA=$N >

Description

The command VARIATION /CP or /LACKENBY carries out shifts of section positions according to the ONE MINUS PRISMATIC or LACKENBY methods.

VARIATION /CP

When using the 1-CP method the user is required to specify a new Block Coefficient (CB) value to which the shifts must be calculated. The user has the option to accommodate all the CB change in the AFT or FORWARD body by specifying the appropriate modifier.

Examples

VARIATION /CP /CB= 0.6
VAR /CP /CB=0.6 /AFT

VARIATION/LACKENBY

In the LACKENBY method the user has the option to modify one or more of the following parameters:

• Block Coefficient (CB)

• Longitudinal Centre of Buoyancy (LCB)

• Aft position of parallel midbody (PBA)

• Forward position of parallel midbody (PBF)

For any value not specified by the user the system assumes the original value by default.

Examples

VAR /LACKENBY /CB=0.6
VAR /LAC /CB=0.5 /LCB=80.5 /PBA=3 /PBF=5

VIEW

Purpose

To set the working view.

Syntax

VIEW ( ANGLE )
------------------------------------------
( BUTTOCK  ) < < /TITLE= > $W > < /REDISPLAY >
( DIAGONAL $W )
( SAC  )
------------------------------------------------------
( OBLIQUE ) < $N > < $N > < /NEGATE > < WINDOW > ...
... < /REFLECTION > < < /TITLE= > $W > < /REDISPLAY >
------------------------------------------------------
( SECTION < /BOW    >  ) < /REFLECTION > < < /TITLE= > $W > < /REDISPLAY >
( WATERLINE  < /DECK > )

Description

This command will set the specified view to the default window size as shown below:

The default window size.

Command Qualifiers

Examples

VIEW SAC
VI WAT /REDISPLAY
VI SEC/TITLE= "Section View"
VI BUT
VI DIA d1
VI OB 210 20
VIEW SEC /BOW

WINDOW

Purpose

View a selected portion of the design.

Syntax

WINDOW < /CURSOR      > < /REDISPLAY >
< $N $N < $N > $N $N < $N > >
------------------------------------------
< CURVE  > < /REDISPLAY >
< POINTS >
---------------------------------------------------
< BUTTOCK  > < CD > ( $N $N $N $N ) < /TITLE= < $W > > ...
... < /REDISPLAY >
< SECTION  >
< WATERLINE > < CD >
----------------------------------------------------
< DIAGONAL > ( $W $N $N $N $N ) < /TITLE= < $W > > ...
... < /REDISPLAY >
------------------------------------------------------
< OBLIQUE > < CD > < $N $N $N $N $N $N > < $N $N > ...
... < /NEGATE > < /TITLE= < $W > > < /REDISPLAY >
------------------------------------------------------
< SAC > < CD > < $N $N $N $N > < /TITLE= < $W > > < /REDISPLAY >

Description

This command allows the user to view a selected portion of the design. It can be used to examine particular areas in greater detail since the scaling is based on this window. Portions of the design outside this area are clipped.

The area to be viewed is specified by two coordinates, these coordinates may be entered using the cursor (DEFAULT) or on the command line. For Oblique views two 3D coordinates in real space are required, for other views the coordinates are in terms of the local axis convention.

In addition the user may specify the view in which the WINDOW is to take place by selecting the appropriate option, otherwise the current view is used. See the VIEW command for further information of the different views available.

The options CURVE and POINTS cause the system to calculate the Window extents from the current curve data.

Command Qualifiers

Examples

WINDOW
WIN 0 0 5.4 6.5 /REDISPLAY
WIN SEC 0.1 3.5 5 /TITLE= "Sections"
WIN OB 75 5
WIN POI
WIN CURV /RED

ZOOM

Purpose

To zoom in and out of the current view window.

Syntax

ZOOM ( IN  ) < /REDISPLAY >
( OUT  )
( /CURSOR )

Description

The ZOOM IN command reduces the current window limits by a factor of two, thus viewing a smaller portion of the design in greater detail.

The ZOOM OUT command increases the current window limits by a factor of two, thus viewing a larger portion of the design in reduced detail.

The ZOOM /CURSOR allows the user to increase or decrease the zoom factor interactively by dragging the mouse up (zoom in) or down (zoom out).

Command Qualifiers

Examples

ZOOM IN /REDISPLAY
ZOOM OUT
ZOOM /CURSOR