GHS Release Notes

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 displaying 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 Deadweight if PM was entered from GHS 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 (default height list is 0, 10, ..., 200 feet or 0, 5, ..., 60 meters); 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 maked 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 /FSM:Change[:All] now shows three FSM options in the LEw right-click menu: True, Max (for fixed atthe 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 command LIMIT evaluations with HMMT=0 (not HMMT OFF) involving FLD (downflooding angle) 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

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.

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 invervals 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

LOAD EDIT /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 modules are currently 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", while "n" or ".n" matches "n" within global namespace (wildcard characters "*" 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.

RA /AREA:RAD plots were not always lining up for tiny maximum Righting Area (requires updated PP.EXE).

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 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 somespurious 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.
field number)
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).

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 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 following the digit (e.g. "{X:2,}") to indicate that commas should be inserted every three decimal places.
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 turing 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 (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).