GHS Beta-Version Update History since Version 12.00
Version 12.00A
REPORT /BOX:COLOR|BW fancy report page headers were misformatted if the company
heading was more than 42 characters long (since 11.52 only).
WRITE/SAVE commands now write PERM and COMP /PERM|EFF changes to save files.
REPORT/DISK commands with no file name specified but with an open run file
now write the run file into the current directory (with name taken from the
run file) instead of the run file directory.
ENTER PM was failing under 64-bit operating systems (since 12.00 only, but could
be worked around by deleting any PM32.EXE then renaming PM.EXE to PM32.EXE
in the GHS program directory).
Version 12.00B
MACRO IDLE robustness was improved.
LEw flickering during IDLE macro processing was eliminated.
DISPLAY STATUS and ENTER GS were showing incorrect tank waterplane angles
(since 12.00 only; requires updated CG.EXE and GS.EXE).
Version 12.00C
LOAD EDIT /NOGMra parameter was added to disable toggling between waterplane
and RA-derived GMt by pressing Ctrl-R.
LEw /NOFReeze parameter was added to disable freezing or unfreezing tanks by
right-clicking in the Contents column.
RA /LIM:AT was reporting "LARGE" instead of the attained value if more than
100 times the limit value.
ENTER PM was trapping a fatal error for hull stations having excessive points
and rejecting COMMENT commands containing semicolons (requires updated PM.EXE).
Version 12.00D
WRITE/SAVE neglected to include the /QUIET parameter when writing PERM changes
(since 12.00A only).
Version 12.00E
LEw /INITSOLVE with an IDLE macro active was sometimes flickering.
Version 12.00G
REPORT /BOX:COLOR|BW fancy reports were trapping "Not enough cells on line"
when writing certain long LIMIT descriptions.
Version 12.00H
CRTPT creation beyond the maximum available was not trapping "Too many Critical
Points", instead sometimes triggering an "invalid location" run-time error
(since 7.50 only).
Version 12.00J
RA /LIM reports the absolute starting angle instead of relative angle 0
(e.g. "Residual Area Ratio from ABS 3.1p deg to Flood" instead of "Residual
Area Ratio from 0 deg to Flood" if the starting angle were 3.1p).
Version 12.00K
RA /LIM now report relative angle 0 as the absolute starting angle with the
same 3-decimal precision as "Relative angles measured from" note and with
negative sign only if opposite the direction of heeling in the RA curve.
LS/TORQUE commands ensure that all LSLIMIT points are represented in plots.
Version 12.02
DAMSTAB /SDI has probability of damage added to its reports.
Version 12.02A
ANGLES command range was extended from 180 to 360 degrees.
Version 12.02B
TEMPLATE dialogs containing a static image field could sometimes trap an
"invalid location" run-time error when executing subtemplates.
ENTER PM was causing a fatal error when CREATE OPPOSITE was followed by a
DEDUCT or COMPONENT statement (since 12.00 only; requires updated PM.EXE).
Version 12.02C
RA plot was not always precisely positioning the immersion or height point.
Version 12.04
WRITE/SAVE were not adjusting TYPE DECK /HW:height or TYPE PRESS /HEAD:height
for metric units.
TYPE DECK /HW 0 was trapping "Value out of range" if a colon or equal sign
appeared between "/HW" and "0" (since 11.94C only).
HEIGHT system variable was not always correct for DECK type tanks and was
sometimes provoking GAMMA FAULT errors (since 11.08B only).
Version 12.04A
HEIGHT system variable was further corrected (since 12.04 only).
Version 12.04B
DAMSTAB /SDI194 TRACE file now shows constant values from regulation 7-1.
Version 12.04C
SPECial WPLUP [ON] enables getting waterplane information for any part at zero
heel when at equilibrium. SPECial WPLUP OFF restores the default mode.
Version 12.04D
SPEC WPLUP mode also gets waterplane information when not at equilibrium but
currently at zero heel.
LIMIT (n) no longer traps unnecessary "Only one allowed" error when redefining
a deck, freeboard, or equilibrium plus angle type at limit number n.
Version 12.06
DAMSTAB /SDI194 was miscalculating the b21 factor that is involved in the
probability of damage. This resulted in slightly lower attained index
values in some cases than there should have been.
Version 12.06A
PERM RESTORE /QUIET was clearing the screen in split SCREEN COMMAND mode for
the default SCREEN SCROLL setting.
Version 12.06B
LIMIT FLOODHT AT POINT n1 [TO n2] > height was added to define a limit for
the height at equilibrium of the lowest downflooding point (either normal or
watertight) with Critical Point number ranging from n1 to n2 (if present).
Version 12.06C
RA /LIM was sometimes trapping "Length undefined" in WPLUP mode when a Roll
angle limit was in effect (since 12.04C only).
Version 12.08
LIMIT FLOODHT AT POINT n1 TO n2 was incorrectly storing n2 as an angle instead
of a Critical Point number (since 12.06B only).
Version 12.08A
SPEC OFF turns off all special settings. SPEC without parameters displays
current special settings to the screen.
RA /LIM was bolstered with a backup solving method to prevent trapping of
spurious "EQU0 is out of range" errors.
Version 12.08B
PRINT now preserves the original document name for use when writing PDFs
(requires updated PP.EXE).
Version 12.08C
PRINT PREVIEW now shows the original document name in the preview window
titlebar and system taskbar (requires updated PP.EXE).
Version 12.08D
SCREEN LOGO imagefile [:intensity] subparameter was added to specify the
image's visual intensity between 0.0 and default 1.0.
Version 12.08E
TEMPLATE field BREAK [LINE] [:area] subparameter was added to specify the area
number used to align future fields until the next BREAK. Normally the range of
fields before the first BREAK is area 0, after the first BREAK is area 1, after
the second BREAK is area 2, etc. with each area having separate field alignment.
Specifying a previous BREAK area number instead combines the upcoming area with
the previous area so all fields in the combined area line up the same way.
Version 12.10
LANGuage filename command translates future output using the named language
file. The default extension is ".LNG", and the default location is the
current directory, library path, or program directory. Language files must
be in Comma-Separated Values (CSV) format, with each line containing a phrase
followed by one or more comma-separated equivalents. A phrase may optionally
be enclosed by quote marks (") to allow inclusion of commas or doubled quote
marks within the phrase and to ignore any surrounding spaces (which otherwise
are included, as per CSV rules). When multiple equivalents are listed for a
phrase, they should be ordered by preference, because the first equivalent
that fits is used (or none if all are too big). Language translation is
currently implemented only for error messages and unit names. LANG without
parameters displays the current language. LANGuage OFF restores the program's
initial native English language.
Version 12.10A
LOAD EDIT and SCREEN GRAPH command area watermark display vessel profile views
using improved drawing methods that support bulbous bows and stern tubes.
Version 12.10B
WRITE/SAVE commands were incorrectly adjusting load values for all TYPEs
except DECK and PRESS (since 12.04 only).
WRITE (LOADS) was writing superfluous LOAD commands for TYPEs DECK and PRESS
which could trap "Value out of range" errors.
SAVE and WRITE [(SAVE)] commands added optional /NOREPort parameter which
omits writing any final STATUS and REPORT commands.
Version 12.12
DAMSTAB /SDI new parameter /ALLPEN causes all penetration distances to be
considered in multiple-division flooding.
DAMSTAB /SDI new parameter /AUTOFLOOD disables any special flooding assignments
given in the DIVISION subparameters Ii and Uj.
DAMSTAB /SDI improved equilibrium solving to find the equilibrium heel angle
more reliably, especially in cases where the stability is marginal.
DAMSTAB /SDI produces a follow-up report whenever there are cases of
user-assigned flooding that cause deferred flooding relative to when it would
naturally occur according to the geometry. This addendum lists such cases
along with the amount of the discrepancy (requires updated RGDEF.DAT and
RGSTYLE.DAT).
DAMSTAB /SDI now allows /SDI216C and /SDI216P as synonymous substitutes for
/SDI194C and /SDI194P respectively.
LIMIT ANGLE FROM EQU TO FLD > 0 was reporting zero margin and attained value
(indicating a just-passing condition) when a normal flood point was submerged
at equilibrium in the absense of any TIGHT points lower than normal FLOOD
points. None of the other limits involving FLD were affected.
SOLVE for equilibrium with free trim is less likely to miss the solution at
a short range of stability.
PRINT was sometimes misformatting the standard fixed font when in boldface
(such as the bold vessel name in the second header line) on non-English
language systems (requires updated PP.EXE).
Version 12.12A
DAMSTAB /SDI194C|P and /SDI216C|P method codes allow appending "SP" to indicate
a special purpose ship (for example, "/SDI216CSP").
Version 12.12C
LETANK system variable was added to return the currently-selected tank name
in Load Editor (or empty if LE is not active).
TC /SOUND /STOP:Full was occasionally not showing the precise full sounding
level due to tiny rounding errors preventing a tank registering as full.
Version 12.12D
LOAD EDIT displays the vessel plan view using improved drawing methods that
support fore and aft indentations.
Version 12.12E
WRITE (LINEs) filespec text was added to append a single line of capitalized
text to filespec (or if text begins with a quote mark, the remainder of the
text line preserving case). If text is empty, then subsequent consecutive
NOTE lines (beginning with a back slash) are appended preserving case.
Version 12.12G
LOAD EDIT plan view was distorted at single-point stations (since 12.12D only).
Version 12.12H
SOLVE was sometimes stopping short of finding a capsized heel angle (since
12.08A only).
Version 12.12I
SOLVE efficiency in capsized conditions has been improved.
Version 12.12J
REPORT /BOX:COLOR|BW fancy reports were slightly misformatting RA /LIM lines
ending with "Marg Imm." (since 11.72 only).
Version 12.12K
RA /LIM for n%DI deck immersion percentage LIMIT angle was sometimes returning
a close but not exact result, and in the absence of any flood points was showing
angles in radians within a "Height" column (instead of angles in degrees within
a properly-labeled "Angle" column).
Version 12.14
ENTER PM was writing tanks incompatible with the Deadweight program if PM was
entered from the main program before reading a geometry or setting sea water
(since 12.00 only; requires updated PM.EXE).
ENTER PM added a MODIFY command STANDARDIZE statement, which puts all station
curves in the stardard form starting at the lower left corner.
Version 12.14A
ENTER PM supports vertical dimensions up to 300 meters (requires updated
PM.EXE).
Version 12.14B
ENTER PM supports vertical dimensions up to 200 meters (fixing issues from
12.14A; requires updated PM.EXE).
Version 12.14C
REPORT plots were incorrectly showing a minus sign after "Axis rotated fwd".
ENTER PM was sometimes hanging during the FIT command (requires updated PM.EXE).
Version 12.14D
RA /LIM no longer omits plotting the GM tangent line if LIMIT GM UPRIGHT exists
and equilibrium is not at zero heel. (This backs out a change made in 10.88E;
any unwanted GM plot lines can be omitted using the RA /GRAPH:NOGM parameter.)
ENTER PM did not recognize CREATE/MODIFY REFerence statement (since 12.00 only;
requires updated PM.EXE).
Version 12.14E
TEMPLATE static text fields (aside from tags immediately preceding controls)
no longer replace an underscore ("_") with a keyboard hotkey.
SE filling of stations containing arc points was sometimes causing the program
to hang (requires updated SE.EXE).
Version 12.16
ENTER PM enhanced the ATTACH statement to allow tank attachment points to be
distributed over a specified distance, as follows:
ATTACH forward, aft, vertical [DISTribute[:distance]]
If the DISTRIBUTE parameter appears with the distance subparameter, the
weight at each attachment location is distributed over the given distance.
If the DISTRIBUTE parameter appears without the distance subparameter, the
tank weight is distributed linearly between the two attachment locations
(requires updated PM.EXE; note that geometry files created using this new
feature are incompatible with program versions earlier than 12.16).
Version 12.16A
TEMPLATEs with names containing underscores were triggering "invalid location"
run-time errors when executed (since 12.14E only).
LEw "Sounding" field was misformatted for flooded or damaged tanks (since
11.04B only).
DISPLAY STATUS /NOLEGEND parameter was ineffective (requires updated CG.EXE).
Version 12.16B
ENTER PM was incorrectly trapping "Missing parameter" for the CAMBER statement
with default longitudinal locations. The SHELL statement sometimes misbehaved
when missing a final centerline point at the top of stations (since 12.00 only;
requires updated PM.EXE).
Version 12.18
International operating system versions were not always showing special
characters correctly (requires updated GHSHELP.EXE, GHSVIEW.EXE, and PM.EXE).
Version 12.18A
ENTER PM fixed a FIT station interpolation problem (requires updated PM.EXE).
Version 12.18B
ENTER PM increased the maximum number of FIT statements in one component
CREATE or MODIFY command to 20 (requires updated PM.EXE).
Version 12.18C
PART HULL selects the first displacer part if no displacer named "HULL" exists;
if there is no displacer, the current part is turned off.
Version 12.18D
RA report footer note was sometimes including spurious wind speed information
when currently in WIND PRESSURE mode (since 7.00 only).
SOLVE was sometimes trapping spurious "Heel limit exceeded" errors.
Version 12.18E
WIND [REPort] [/HEIGHTs: h1, ..., hn] produces a table and plot of wind pressure
and any wind speed versus height above the waterplane for the given heights,
which must be in ascending order; if heights are omitted, any given in /LINEAR
or /STEPWISE pressure mode are used, otherwise a default list is furnished;
if REPORT is omitted, the display is on the screen only (requires updated
RGDEF.DAT and RGSTYLE.DAT).
MESSAGE PLOTSTART custom plots now default to a general scale from 0 to 10 if
all curves are marked with "%" to use a scale factor.
Version 12.18G
FSM formal values assigned to a tank are now automatically proportionally
changed when the tank's specific gravity changes.
Version 12.20
FSMMT Free form was added to behave the same as TRUE except that it uses the
waterplane inertia taken about the ship's centerline, as if the tank were
freely connected to its mirror image on the opposite side of the vessel. This
allows interconnected port and starboard tanks to be modeled separately so
their loads can be set differently (as if due to some pressurization).
READ added a safeguard that traps "Excessive section area on shape" for
stations that cross and loop around multiple times.
WIND (PRESSURE) p1 @ h1,... /LINEAR was not properly linearly interpolating
between the given points (instead just fitting a line between them).
WIND (PRESSURE) p1 @ h1,... now traps an error if not given a reasonable
pressure curve with positive monotonically-decreasing slope.
WIND [REPort] default height lists and plotting were improved.
MESSAGE PLOTSTART custom plots returned to pre-12.18E general scale based on
maximum of all curves if none are unscaled, but now ensures a power-of-10 scale
factor if only one curve.
Version 12.20A
WTPREFN system variable was addied to return the current weight prefix number
(0=none, -1=non-prefixed items).
TEMPLATE execution was sometimes hanging if an IDLE macro popped up a dialog
while another TEMPLATE dialog was currently active.
Version 12.20B
CONTENTS with extremely low density (less than 0.1) may only be changed from
FROZEN tank type if the native type is FROZEN.
DISPLAY STATUS was sometimes failing if the currently selected printer name
was extremely long and complicated (requires updated CG.EXE).
Version 12.20C
LOAD EDIT /NONEW parameter was added to prevent creating, renaming, or
deleting items in Load Editor.
LEMODE system variable was added to return the current Load Editor mode
(either "WEIGHT", "GROUND", "THRUST", "PULL", or empty if LE is showing Tanks
or not active).
LEITEM system variable was added to return the currently-selected item name
from the current Load Editor mode (or Weights if showing Tanks).
Version 12.20D
CHANGE, DELETE WEIGHT, and GROUND commands were inappropriately using any
weight prefix assigned by ADD PREFIX when matching ground point descriptions.
Version 12.22
RA /LIM with heeling moment now considers a second detached hump in the RA
curve for LIMIT evaluation if it is larger than the first and the absolute RA
does not go negative in the interval between the humps and a LIMIT on the
equilibrium angle is present.
Version 12.22A
LOAD EDIT /FSM:Change[:All] now shows three FSM options in the LEw right-click
menu: True, Max (for fixed at the maximum FSM value at zero heel and trim),
and Max always (for maximum even when empty or full).
LOAD EDIT /EVAL:FRA and INPUT /EVAL:FRA were not working for metric units.
Version 12.22B
MESSAGE PLOTSTART custom plots were not showing any negative signs in the scale
for the independent variable; now this negative sign is only suppressed if the
independent variable's PLOTLABEL contains "<-" followed by "->" (for example,
"Aft <-- Longitudinal Location --> Fwd").
Version 12.22C
RA was stopping with the error "Failed to find angle" in rare cases
(since 12.22 only).
MAXVCG and SOLVE MAXVCG added /RAMACRO[:name] parameter to execute the named
macro ("RAMACRO" by default) to set RAH_RA variable to the effective heel
righting arm value (same as RA /RAMACRO parameter).
Version 12.22D
RA evaluations of LIMITs involving FLD (downflooding angle) with HMMT=0
(not HMMT OFF) when the equilibrium angle was missing were producing a
false Fail.
Version 12.22E
RA /GM:MODU option was added to derive the GM by looking at a wider range of
heel angles in order to detect RA curves that remain close to zero. In such
cases it derives a GM value that reflects the low point of the curve. In the
presence of a heeling moment it looks only in the direction of the heel due to
the moment, otherwise it looks at the curve in both directions. This method
is useful for detecting a negative-going absolute RA curve between absolute
equilibrium and residual equilibrium.
GMMODU system variable was added to return the GM at the present heel angle
using the MODU method, but reverts to the GMRA method when neither at zero heel
nor at EQU0 (absolute RAH=0).
Version 12.24
DAMSTAB /STOPAT:n parameter was added to stop after n-division damage is
complete (unlike /STOP, it does not stop earlier if the required index has
been attained).
LOAD /FSM:Change[:All] right-click "Max" option was not always using zero
heel and trim when calculating maximum FSM.
Version 12.24A
RA /GM:MODU parameter was tweaked and extended to MAXVCG and SOLVE MAXVCG.
Version 12.24B
RA /AREA intervals involving FLD or CRT now only report actual downflooding
points, ignoring tight points in the Areas summary table.
GMMODU system variable also reverts to the GMRA method when the present heel
is greater than 10 degrees.
Version 12.24C
TEMPLATE variable field parameter /DEC:places supports optional "FA" or "PS"
following the places value to accept these suffixes on input and use them
instead of a leading sign on output.
Version 12.24D
CRTPT and GROUND commands were not enforcing 25-character maximum description.
Version 12.26
CRTPT /INside:tankname parameter was added to designate critical points
that are to be ignored unless the space they are INSIDE is of the FLOODED
or DAMAGED type. This is useful for guarding against insufficient stability
prior to progressive flooding, without being penalized when the interior
flood points are not exposed.
As a means of determining which tanks would become flooded in a progressive
flooding study, the /FLD parameter was added to the TANKS selector.
TANKS tanklist /FLD
excludes the tanks in tanklist that are not currently FLOODED or DAMAGED
but do have unprotected FLD Critical points below the current external
waterplane; i.e. there are Critical Points with FLD status that reference
the tank in their /TANK parameters. (Unprotected FLD Critical Points would
be those that have no /INSIDE tank, or if they are inside a tank it is
currently FLOODED or DAMAGED.) This command can be used to conveniently
advance to the next stage of progressive flooding. For example,
SOLVE
TANKS * /FLD
TYPE FLOOD
TANKS OFF
A new LOAD type FLOW was added. LOAD (tanklist) FLow [:ct] causes load
changes in certain tanks under certain conditions that are defined
via Critical Points with FLD status. The subject tank must be referenced by
a Critical Point in its /TANK parameter, and that point is considered
to be the location of the opening through which the flow takes place.
The magnitude of the flow (load increment) is determined by the size of
the opening, the head at the opening location, and the ct value given
with the LOAD FLOW command (ct is 1.0 by default). The magnitude of
the load increment is calculated as,
flow = Head x Opening x SGratio x ct
where SGratio is specific gravity of the source divided by the specific
gravity in the receiving tank. For example, if the Head is 2.5 meters,
the Opening is 0.5 square meters and ct is 3.0, then the volume of the flow is
2.5 x 0.5 x 3.0 = 3.75 cubic meters, assuming SGratio=1.0.
This is not intended to be a physically correct calculation. The actual
flow will depend on details such as the shape of the opening and its length
if it is a pipe. To accurately represent a particular case, the user must
adjust the Opening size parameter to compensate for these effects. The ct
parameter can incorporate a constant necessary to come to realistic flow
for a particular time interval.
The following sequence of commands can be used in a simulation.
MACRO FL
LOAD (*) FLOW
SOLVE
STATUS
/
.FL (number of steps)
The number of steps to be taken will depend on the details of the arrangement.
Ordinarily, it will converge toward a steady state.
If such critical points also name an /INSIDE tank, the flow will go from the
/INSIDE tank to the subject tank, with zero net change in the total weight.
The flow reverses if the pressure at the critical point is such that the
flow would go out of the tank. The specific gravity settings of the
contents of the tanks involved are not affected. If more than one Critical Point
references the subject tank, they all contribute to the flow. If the subject tank is
FLOODED or DAMAGED, the flow is zero.
DISPLAY and SE were sometimes leaving extra points on the screen when moving
between stations under Windows 7 (requires updated SE.EXE and PM.EXE).
Version 12.26A
CRTPT /OPening:size parameter was added to declare an opening size (in current
square length units) to be used in Flow calculations. The /OPENING:size
parameter is required along with /TANK:tankname before the critical point can
be used by the LOAD (tankname) FLOW command (requires updated RGSTYLE.DAT).
SCREEN COMMAND and LEw scrolling was sometimes temporarily showing extra blank
lines in the display area after a report until execution pauses for user input.
Version 12.26B
DISPLAY STATUS BODY view was not showing the portside mirror image of
/SYMMETRICAL critical points (requires updated CG.EXE).
Version 12.26C
COMP component /SKin[:All|Deck|Nodeck|Bottom] parameter was added to report
skin girths, areas, and centers at longitudinal intervals and plot girths
(superseding the old SA surface area program).
Version 12.26D
MAXVCG and RA were trapping "whole overflow" run-time errors in rare cases.
Version 12.26E
ENTER PM command SCALE was sometimes trapping "invalid location" run-time
errors (since 12.00 only; requires updated PM.EXE).
Version 12.28
TANK command was not trapping invalid tank names (since 12.24D only).
Version 12.28A
LOAD EDIT vessel profile view was sometimes triggering a "DEALLOCATE" run-time
error when changing conditions (since 12.10A only).
Version 12.28B
RA /GRAPH:CLEAN[:set] optional subparameter was added for fine control of
guide hair cleaning, omitting following hairs according to summed set of:
1=MAX; 2=30 & 40 degrees; 4=area; 8=EQU0; 16=EQU; 32=TFLD; 64=FLD; 128=DI.
Default clean remains 127 if set is omitted or exceeds 255.
Version 12.28C
REPORT /PPMERGE:file was added to merge PP commands from the specified file
into the current open report (see Print/Plot manual for PP command syntax).
READ was sometimes incorrectly trapping "Negative section area" for symmetric
components not having all stations with first & last points on the centerline
(since 12.20 only).
Version 12.28D
COMP /SECTIONS with no /DEPTH parameter now uses infinite depth for empty tanks.
Version 12.28E
SET arithmetic was failing for zero in scientific notation (e.g. "0.00E+00").
Version 12.28G
COMP /FORM and /SECT headers for components of tank parts show "Full load" or
"Zero load" instead of "Infinite depth" or "Infinite negative depth".
Version 12.28H
SOLVE MAXWEIGHT:"item" now can also be used for pull or thrust force items.
Version 12.28I
DISPLAY filename PRINT was failing when an explicit filename was specified
(since 12.00 only).
Version 12.30
FPULL and FTHRUST system variables were added to return the total magnitudes
from all pull or thrust forces.
Version 12.30A
REPORT was giving spurious damage warnings in rare cases (since 12.20 only).
Version 12.30B
SOLVE /EXTRAFSM was not allowing tank CGs to shift. This was causing a
"Roll angle must be first" error message from RA /EXTRAFSM.
Version 12.30C
ENTER PM added CRTPT /INside:name and /OPening:size parameters to match the
corresponding features of the CRTPT command in the main program.
DISPLAY PRINT added new parameter /YESCRtpt to include critical points (listed
and shown on plan and profile graphics), along with the following enhancements:
(1) origin point shown on plan and profile graphics; (2) heavier lines for
improved printouts; (3) improved section offsets margin; (4) section now show
line codes such as DK for deck edge (requires updated PM.EXE).
Main program startup by right-clicking a run file then choosing Open With was
sometimes showing Windows\System32 as the working directory due to a Vista/Win7
bug when multiple programs use Open With for the same file extension.
Version 12.30D
RUN [filename] /CALL:module defines a module name (up to 8 characters) that
is active while filename is running (if no filename, then assigns the module
for the current run, but only if no run file module is active).
The module is assigned to any MACROs, TEMPLATEs, or VARIABLEs defined during
the run, unless the name being defined starts with "." to mark a global name.
A module is also active while MACROs or TEMPLATEs it defined are executing.
While a module is active, any names in CLEAR [(name)] MACRO|VARIABLE or
WRITE (MACRO|VARIABLE) filename [/NAME:name] commands refer to the module
namespace, unless they start with "." to refer to the global namespace.
Absolute names are used in MACRO|TEMPLATE|VARIABLE /LIST:name and LIST name
commands, so "m.n" matches "n" within module "m", ".n" matches within global
namespace, and "n" within any active module (wildcards "*" or "?" permitted).
Either relative names (e.g. "n") or absolute names (e.g. ".n" or "m.n") may
be used elsewhere, such as in variable value lookups using braces (e.g. "{n}")
or in EXECUTE, SET, and IF [V]EXIST commands. Relative names first look in
any active module namespace, and if not found look in the global namespace.
Version 12.30G
MAXVCG /LOOKUP now is able to return values from data points that are adjacent
to gaps in the max VCG data.
Version 12.32
READ accepts geometry files containing internal frame data, which supersedes
any separate {GF}.FRA file.
CRTPT REPORT omits "Tank" column when no tanks are referenced (requires updated
RGSTYLE.DAT).
DISK filename.DAT /NOTEonly was added to put only NOTE text into the file.
MESSAGE" and SCREEN MESSAGE" no longer double quotes within retrieved variable
values unless explicitly surrounded by quotes.
PRINT CONFIGURE was trapping an "invalid location" run-time error for certain
printers.
RA /AREA:RAD plots were not always lining up for tiny maximum Righting Area
(requires updated PP.EXE).
DISPLAY STATUS body views were sometimes failing to fill in the contents color
below the waterline for portside tanks in heeling vessels (since 10.96D only;
requires updated CG.EXE).
DISPLAY and SE now draw implicit lines between separated first & last points
of stations using bright white instead of blue for better clarity (requires
updated SE.EXE).
Version 12.32A
SE was not cleanly displaying edit changes in Ctrl-B white background mode
(requires updated SE.EXE).
TEMPLATE /MIN parameter was added to include a minimize button in the template
dialog's title bar.
Version 12.32B
TEMPLATE dialog boxes now use Arial font by default (which can be overridden
using the /FONT parameter), with size corresponding to command area characters.
DISPLAY STATUS print legends were misformatted in a tiny font (since 12.32 only;
requires updated CG.EXE).
PRINT /FONT:"Courier" was misformatting the footer in landscape mode under
certain operating systems (requires updated PP.EXE).
Version 12.32C
MB reaching interaction equilibrium now implicitly does DISPLAY STATUS /UPDATE
whenever DISPLAY STATUS /SYNC is active.
ADD /LEN:length was not trapping negative length.
Version 12.32D
COMMENTS GFID was added to display the geometry file path, date, and time.
Version 12.32E
GROUND point maximum number was increased from 99 to 200.
TEMPLATE static text fields added /Underline parameter to underline the text.
/U also works with any execute button field to format its label like a static
text field with an underlined hotlink to execute its macro or subtemplate.
TEMPLATEs run within LEw were using too large a font.
Version 12.32G
TEMPLATEs using /SIZE:LARGE were using too large a font.
GROUND point maximum was increased to 200 in auxiliary programs (requires
updated CG.EXE).
Version 12.32H
TEMPLATE /Underline parameter restricts underlining to characters enclosed by
any single underscore ("_") characters occuring in the text (so "click _here_"
underlines "here"). Only one underline is allowed per field, so any subsequent
single underscores are stripped; doubled underscore "__" appears as single "_".
Version 12.34
DISPLAY PRINT formats tables using boxes if no report files is open (requires
updated PM.EXE).
TEMPLATE /Underline[:ucolor[:acolor]] optional subparameters were added to
specify the underline color (hotlink default=blue) and active color (hotlink
default=red) when the mouse points to the underlined text. Colors can be
specified as a MESSAGE COLOR number from 0 to 15 (0=black) or as a 6-digit
hexadecimal RGB value (FF0000=red).
Version 12.34A
DISPLAY STATUS report output was not printing properly (since 12.34 only;
requires updated CG.EXE).
Version 12.34B
VIEW was not skipping certain un-viewable portions of report files (since
12.34 only; requires updated GHSVIEW.EXE).
Further DISPLAY STATUS improvements (requires updated CG.EXE).
DISPLAY PRINT improvements (requires updated PM.EXE).
Version 12.34C
DISPLAY STATUS reports were sometimes slowing down with undefined point numbers
if any critical points were defined using the /OPENING parameter (since 12.26A
only; requires updated CG.EXE).
LS strips out any Tab characters from the .FRA file that could cause report
misformatting.
Version 12.34D
REPORT /BOX:COLOR|BW fancy reports were misformatting DISPLAY STATUS after
MESSAGE REPFONT and page headers after DISPLAY STATUS (since 12.34 only).
REPORT /BOX:COLOR|BW fancy reports were misformatting RA "Critical Point"
segments when a GM limit was present (requires updated RGSTYLE.DAT).
Version 12.34E
ROLL IMO "C" value was being reported in English units regardless of the
unit setting (this did not affect the roll angle or roll period results).
ROLL CONSTANT now allows a higher upper limit for the roll period constant.
Version 12.34G
NOTE {%IMAGE("file")%} was failing in MESSAGE REPFONT mode (now automatically
turned off for the line containing the image and restored for the next line).
TEMPLATE field VARIABLE varname /DEC:places sets field size of range-limited
numeric variables according to the maximum digits expected.
Version 12.36
DISPLAY STATUS /PAGE%:percent supports NOTE and table output on the same page
following condition graphics output.
DISPLAY STATUS|PRINT and plotting problems were addressed (since 12.34 only;
requires updated CG.EXE and PM.EXE; some report files output by 12.34 betas
need to be rebuilt using 12.36 to be printed or previewed properly).
Version 12.36A
CRTPT (n) *+d | *-d was added to move the nth point d length units up (+d)
or down (-d) in a direction perpendicular to the current waterplane.
LOAD FLOW was not keeping the total volume constand when going from tank to
tank (since 12.26 only).
REPORT /BOX:COLOR|BW fancy reports were sometimes misformatting HMMT REPORTs for
non-banded WIND heeling moments (requires updated RGSTYLE.DAT).
Version 12.36B
REPORT /BOX:COLOR|BW fancy reports in MESSAGE REPFONT mode were writing some
spurious lines before DISPLAY STATUS output (since 12.36 only).
TYPE DECK and PRESSURIZED tanks were enhanced and made more reliable (requires
updated CG.EXE).
HEIGHT (n) *+d | *-d was added to set the level of the waterplane so the height
of the nth point is moved d length units up (+d) or down (-d). HEIGHT (n) by
itself displays the current height of the nth point.
Version 12.36C
FSM longitudinal calculations were made more precise.
REPORT /BOX:COLOR|BW fancy reports were sometimes misformatting CRTPT REPORTs.
Version 12.36D
Load Editor field input now supports "*+n" and "*-n" to add or subtract from
the current field value. Unlike "+n" and "-n", the forms with "*" add to the
magnitude of longitudinal and transverse locations (for example, entering
"*+1" on top of "10.00f" increases the forward location to "11.00f").
The "+n" and "-n" forms now replace rather than add to vertical locations.
Version 12.36E
VARIABLE names followed by a colon then a digit and surrounded by braces
(e.g. "{X:3}") now support optional "FA" or "PS" following the digit to
indicate that a negative value should be replaced by its absolute value
followed by "f" or "p", a positive value should be followed by "a" or "s",
and a zero value should be followed by a space; if the digit is omitted,
it defaults to 2.
Version 12.36G
TYPE PRESSURIZED tank type was not solving properly (since 12.36B only).
Version 12.36H
DISPLAY PRINT problem was fixed (since 12.36C only; requires updated PM.EXE).
Version 12.36I
TEMPLATE static text fields now support /BOLD and /ITALic parameters to toggle
text to bold and italic.
Version 12.36J
LOAD EDIT|STAT /SCOL:Sounding|Ullage:Fsm parameter causes soundings (default),
ullages, or FSM values to be displayed initially in the rightmost tank column.
Note that the existing /ULlage parameter is equivalent to /SCOL:ULLAGE.
Ctrl-F can be used in Load Editor to toggle FSM column mode.
Version 12.36K
DISPLAY STATUS printing was further improved (requires updated CG.EXE).
Version 12.36L
DISPLAY STATUS /LEGEND was ineffective when used with /PAGE%, and other printing
improvements were made (since 12.36 only; requires updated CG.EXE and PM.EXE).
Version 12.36M
TEMPLATEs with no input or button fields now close when Esc or Enter is pressed.
Version 12.36N
TEMPLATE dialogs may no longer be cancelled when input data has been changed
without passing through an "Are you sure?" confirmation box, unless /NOConfirm
parameter was included on the TEMPLATE command line.
Version 12.38
EXTEND BONJEAN was added to write a Bonjean Data table to the current report
file (requires BONJEAN.XRF along with AF module). The Bonjean table can be
customized using the following optional parameters:
EXTEND BONJEAN [dinc [,d1 [,d2]] [,NLOC:nstas [,STA]] [,LOC:fwd,aft]
where dinc is draft increment, d1 is starting draft, d2 is ending draft,
NLOC:nstas sets number of station columns, STA shows station number instead
of any frame names, and LOC:fwd,aft sets forward and aft station locations
(requires updated GHSX.EXE).
OUTFLOW was sometimes computing too low minimum distances from tanks to hull,
which could lead to an excessively-conservative overall oil outflow parameter.
OUTFLOW without /LENGTH parameter traps an error if no deck edge was defined.
PRINT /PREView:"commands" drives the preview using the specified series of
displayable command characters shown in the preview right-click menu, along
with "Wn" to set wait time between commands to n milliseconds; "D[[*]n]" to page
down n times (default=1; "*" waits between pages); "U[[*]n]" to page up n times
(default=1; "*" waits between pages); "MD" to move down scrolling; "MU" to move
up scrolling; "ML" to move left scrolling; "MR" to move right scrolling;
"R" to repeat starting at the first command; and "X" to exit. Normal keyboard
entry resumes when all commands are done or if interrupted by pressing any key,
which is discarded (requires updated PP.EXE).
MC without /LINEAR parameter was sometimes unnecessarily filling stations using
linear interpolation; likewise for other auxiliary programs performing station
interpolation (since 11.66 only; requires updated CG.EXE, MC.EXE, PM.EXE, and
SE.EXE).
REPORT /BOX:COLOR|BW fancy reports were having problems with {%IMAGE("file")%}
output (since 12.36B only).
Version 12.38A
TEMPLATE dialogs with check boxes, radio buttons, and drop-down lists were
putting up unnecessary "Are you sure?" confirmation boxes when cancelled with
out-of-range initial data (since 12.36N only).
Version 12.38B
MESSAGE PLOTSTART custom plots sometimes reduced detail by using too wide a
range based at zero for the independent variable.
GHS command plots were reducing detail for small draft ranges.
Version 12.38C
VCG MAX and MAXVCG commands added /NOTOL parameter to prevent extrapolation
of maximum VCG data (same as existing LOAD EDIT /NOTOL parameter).
Version 12.38D
LIMIT was not trapping an error when DI, DI0, and EQUPlus angle types were
used both with and without percentage values, and other limit inconsistencies
were corrected.
FIXUP /MARGIN:OFF was failing when using metric units (requires updated MC.EXE).
Version 12.38E
STATUS FIXED:BRIEF was sometimes trapping "FIXED WEIGHT DISCREPANCY" if any
ADD PREFIX categories had been defined without a descriptive label (in such
cases the prefix category name is now shown in place of the missing label).
Version 12.40
TEMPLATE exit field /OK:n parameter was added to set TEMPLOK system variable
to n (instead of default ordinal field position) if the template exited due to
clicking that field button.
TEMPLATE variable field /BOK parameter was added to allow blank field values
even for numeric variables defined with minimum and maximum values.
PRINT was misformatting non-ASCII characters such as the degree mark (since
12.18 only; requires updated PP.EXE).
ENTER PM increased maximum transverse offset to 200 meters (requires updated
PM.EXE).
ENTER PM added a FRAME "description" @ location command to store the given
description (maximum 12 characters) along with its longitudinal location.
Up to 255 frame locations can be assigned. If the given description matches
an existing frame description, then its location is replaced with the new one.
Version 12.40A
EXIT macro was failing if macro was contained in a module that was no longer
active following the EXIT (since 12.30D only).
GROUND now finds the maximum penetration when given the reaction and the current
penetration (this was described in the manual but omitted in the program).
GROUND REPORT and LOAD EDIT Ground Points mode now show positive penetration for
negative as well as positive ground points when they are generating reactions.
Version 12.40B
TEMPLATE /SIZE:SMALL using default Arial font was clipping static text starting
with "W" for certain older operating system configurations.
Version 12.40C
LEw auto-solving was endlessly looping in rare cases.
Version 12.40D
TEMPLATEs run following LEw reentry were using too large a font.
Version 12.42
INCLANGL and INCLAXIS system variables were added to return the absolute
inclination angle and the axis angle in degrees at which trim would be zero;
these are the same as the Heel and Axis angles shown after doing AXIS *.
TYPE (sailparts) SET|UNSET /SCALE:fl,ft,fv parameter was added to multiply
sail point coordinates relative to the reference point by the given factors.
TYPE (sailparts) SET|UNSET /TOP:tt parameter was added to rotate longitudinal
and vertical sail coordinates about the reference point by the given angle.
TYPE (sailparts) SET|UNSET /SWING:ts parameter was added to rotate longitudinal
and transverse sail coordinates about the reference point by the given angle.
TYPE (sailparts) SET|UNSET /MOVE:dl,dt,dv parameter was added to move
sail point coordinates by the given vector relative to the reference point.
TYPE (sailparts) SET|UNSET /COLOR:cn parameter was added to set the sail color
to the given number in the range from 0 to 15 (see HELP NOTE for color list).
These parameters are used by Condition Graphics, not lateral plane calculations.
ENTER PMX added a SURFACE (complist) [mingap] command to generate surfaces for
shapes used by the listed parts or components. Optional mingap specifies the
smallest surface patch size in the longitudinal direction, which can be used to
prevent excessive detail in the surface model. DISPLAY STATUS recognizes shape
surfaces and will show the surface patches of components using such shapes
(requires updated PMX.EXE and CG.EXE).
Version 12.42A
EXTEND HOPPER has additional support for the updated sliding formula and for
flooding over the coaming, as well as wet hopper and solid cargo permeability
(requires updated GHSX.EXE along with AF module).
Version 12.42B
MC file1.GF [(component)] file2.SW7 was added to export a centerline component
(default=HULL\HULL.C) to a ShipmoPC seakeeping format file with .SW7 extension.
Geometry data is merged into a matching ShipmoPC file if it already exists,
otherwise a new file is created (requires updated MC.EXE).
EXTEND HOPPER should now only be accessed through the new HOPPER.WIZCO wizard
and associated HOPPER.LIB, as seen in the HOPPER.RF example (requires updated
GHSX.EXE along with HOPPER wizard files).
Version 12.42C
REPORT /BOX:COLOR|BW fancy reports were trapping "Not enough cells on line"
when writing STATUS lines with extremely large negative vertical magnitudes.
Version 12.42D
MACRO and TEMPLATE maximum code storage was doubled.
Version 12.42G
MACRO and TEMPLATE code storage is now unlimited and runs more quickly.
ENTER PM command SCALE now allows negative longitudinal scale factors
(requires updated PM.EXE).
EXTEND HOPPER was sometimes causing incorrect righting arms with flooding
(since 12.42A only; requires updated GHSX.EXE).
Version 12.42H
REPORT /BOX:COLOR|BW fancy reports were trapping "Not enough cells on line"
when writing STATUS lines with certain large GMT values.
Version 12.44
VARIABLE names followed by a colon then a digit and surrounded by braces
now support an optional comma preceding the digit (e.g. "{X:,2}") to indicate
that commas should be inserted every three integer digits.
TEMPLATE static text fields with /BOLD parameter were sometimes being truncated
(since 12.36I only).
TEMPLATE /SIZE:LARGE parameter now uses 50% larger character area than for
default medium size; note that previous use of maximized character size led to
same or smaller size for /SIZE:LARGE than /SIZE:MEDIUM for maximized windows.
Version 12.44A
SOLVE MAXVCG was sometimes incorrectly trapping "flooding before 1st angle".
Version 12.44B
NOTE lines ending with a "^" control character (e.g. ^CL) skip standard line
termination output, so any subsequent NOTE continues on the same line.
Version 12.44C
TEMPLATE variable field parameter /DEC:places supports an optional comma
preceding the places value to accept commas on input and insert commas every
three integer digits on output.
Version 12.44D
COPY file1.PF file2.PPF /CONVert converts a print file to a Public Print File,
which can be previewed or printed on any computer with GHS or the free GHS
Public Print Utility installled.
Version 12.44E
TEMPLATE static text fields with /BOLD parameter were still sometimes being
truncated (since 12.36I only).
Version 12.44G
LS was sometimes failing to find equilibrium when using pressurized tanks.
Version 12.46
TEMPLATE was sometimes inserting a superfluous blank line when no input or
button fields were present (since 12.36M only).
TEMPLATE variable field parameter /DEC:places was sometimes not allowing
enough space (since 12.44C only).
Version 12.46A
COMP /FORM was sometimes using incorrect volume units if the /VOLUME:units
parameter had earlier been used by another command.
Version 12.46B
ERROR command output and pop-up message boxes were truncating multi-line error
messages.
DISPLAY STATUS and ENTER HOPPER were sometimes turning LB units into KP units
(requires updated CG.EXE and GHSX.EXE).
ENTER PM was ignoring the SIDE statement (since 12.00 only; requires updated
PM.EXE).
Version 12.46C
ENTER GS was sometimes trapping "stack overflow" during printing (since 12.36
only; requires updated GS.EXE).
Version 12.46D
ENTER GS was sometimes endlessly reprinting the header (requires updated
GS.EXE restored from version 12.34B).
Version 12.46E
ENTER GS header issue was fixed (requires updated GS.EXE).
Version 12.48
LOAD EDIT, MAXVCG [/PRINT], and VCG MAX commands added /NOFSA parameter to
display the Free Surface Adjustment as "n/a" and ignore it when computing
Effective VCG.
Version 12.48A
ENTER PM was not always preserving any translation VECTORs after JOINing
(since 12.00 only; requires updated PM.EXE).
Version 12.48B
Macro menu was removed because it was misleading and had little use compared
to the newer Wizard menu.
Version 12.48C
MC file1.GF [(component)] file2.SW7 added support for /LOCrange:l1,l2 to
specify the beginning and ending stations locations (requires updated MC.EXE).
Version 12.50
MC file1.GF file2.SW7 export was not always starting stations precisely at
centerline (requires updated MC.EXE).
Copyright (C) 2010
Creative Systems, Inc.