----------------------------------------------------------------------- WAMIT Versions 6.41 Copyright (c) 1999-2008 WAMIT Incorporated Copyright (c) 1998 Massachusetts Institute of Technology FOR UPDATE NOTES SEE END OF FILE ----------------------------------------------------------------------- The use and distribution of WAMIT and associated programs and documentation is limited by the conditions in the license agreement. This program was compiled/linked with Intel Fortran Version 10. The following subdirectory tree outlines the software: main directory (default c:\WAMITv6) readme.txt (this file) wamit.exe (main programs) f2t.exe (stand-alone program for Fourier transform from frequency to time domian) geomxact.dll newmodes.dll (dynamic link libraries of WAMIT) geomxact.f newmodes.f (source code for above dll files) rg2wamit.dll rgkernel.dll (dlls of MultiSurf) libifcoremd.dll libmmd.dll (dlls of Intel Fortran Compiler) userid.wam (license identification file) defmod.f (stand-alone program for generalized modes) \testruns (Contains input files for standard test runs) \testruns\out (Contains output files for standard test runs) \source (SOURCE CODE license only. Contains complete set of WAMITV6.4 source code ) \source_f2t (SOURCE CODE license only. Contains complete set of F2T source code ) RelLic.dll (PERMANENT MACHINE license only) \SPDRVR (PERMANENT MACHINE license only. Contains drivers for the Sentinel Super Pro key and their setup executable) cki32j.dll crp32001.ngn (LEASE version only) \CKDRVR (LEASE version only. Contains setupex.exe and cks.exe files for NT drivers.) The use of WAMIT is documented in the comprehensive User Manual. The following notes are intended to provide supplementary information for installation and maintenance of WAMIT in the PC environment. Users can modify or extend the subroutines geomxact and newmodes, to provide their own specialized descriptions of body geometry and generalized modes, respectively. Instructions for performing these modifications are contained in the User Manual, Chapters 6 and 8. In order for these modified files to be linked with the PC-executable version of WAMIT.EXE at run time, new DLL files must be compiled using a Fortran compiler. This procedure is straightforward using the same compiler (Intel Fortran) as is used to build WAMIT.EXE. It may be possible to perform the same task using other Fortran compilers, but no responsibility or support for this can be provided by WAMIT, Inc. The files rg2wamit.dll rgkernel.dll are required to run WAMIT with input from MultiSurf geometric models (MS2 files). (An error message results if this option is used without an appropriate license for these files) INSTRUCTIONS FOR INSTALLING V6PC: Before testing it is recommended to make a new directory, for example C:\WAMITv6, and copy all of the software to this directory with the same sub-directories copied as listed above. If the software is received in a zip file by electronic transfer, it must be unzipped using a local utility. If the software is received on a CD, the following procedures can be used to copy the software from the CD disk, depending on the preference of the user: 1) use Windows Explore and copy entire CD drive to the preferred drive and directory on the hard disk or 2) open a DOS window and enter the command "xcopy/s d1: d2:\path\ " where d1, d2 are the system drive letters for the CD Rom (d1=source drive), hard disk (d2=target drive) and path is the directory on the target drive (path=target directory) After WAMIT is installed, the site-license version can be run immediately, following the instructions in the next section and in the User Manual. Users of the machine-license version and lease version must first refer to the section below entitled `MACHINE LICENSES' and 'LEASE LICENSES', and follow the instructions therein before testing or using WAMIT. Single machine permanent license is activated after attaching the hardware key to the USB port of the PC. Lease license is activated after acquiring the authorization code. RUNNING V6PC: The scratch files are deleted by the program before a normal termination. If the program is interrupted during execution by a power interruption, or end task command, some scratch files may remain on the disk, in two distinct forms. The first form are named scratch files with the filenames SCRATCHn (n=A,B,C,...). These may be deleted with the DOS delete command "del SCRATCH*". It is likely that unnamed scratch files will exist, and will be reported as `lost clusters' by the DOS instruction CHKDSK. When this occurs CHKDSK /F may be used to erase these files. Run times for POTEN depend primarily on the number of panels or patches, the water depth, and the clock speed of the hardware. The first period computed in a run requires extra time to evaluate the Rankine components of the influence function which are stored for subsequent use at each period. WAMIT V6.4 is compiled using FORTRAN 90 with dynamic dimensioning of most arrays at run time. Thus there are no fixed limits on the numbers of panels, wave periods, headings, bodies, generalized modes, or field points. In practice, on any system with finite RAM and hard disk space, practical limits will exist. The memory and diskspace requirements are explained in Chapter 10 of the User Manual. If the number of panels (especially) and other inputs becomes excessive the run time will increase and/or the execution may be terminated with an error message. It is impossible to give general information applicable to a variety of different systems, and users are advised to gain experience for their particular system to judge the practical limitations. In order to achieve maximum efficiency the scratch storage parameter MAXSCR should be specified in the CONFIG.WAM (or .CFG) file as explained in the User Manual, Chapters 3 and 10. To achieve maximum capacity the option SCRATCH_PATH can be used to store part of the large scratch arrays on a second hard disk or a separate partition of one disk. ---------------------------------------------------------------------------- MACHINE LICENSES Machine licenses are restricted to authorized use on a single PC. A hardware key, shipped with the software, must be attached to the USB port of the PC before attempting to test or use WAMIT. The Sentinel SuperPro hardware key for the USB port requires the Sentinel System Drivers, version 7.5. These drivers are included in the subdirectory SPDRVR. To install Sentinel System Drivers, run the executable in SPDRVR. ----------------------------------------------------------------------------- LEASE LICENSES Lease licenses are restricted to authorized use on a single PC. The following instructions must be followed after the WAMIT software is installed on the PC, and before attempting to test or use WAMIT. If Cyrpkey driver is not installed on the PC, run setupex.exe in CKDRVR first. A special site authorization key must be obtained, after installing WAMIT as described above in the section "Instructions for installing V6PC". The first step is to run WAMIT.EXE by entering the command "\wamitv6\wamit". This attempt to run WAMIT without the key will open the License Configuration window, with a unique Site Code with 18 alphanumeric characters. Copy and paste this site code into an an email message addressed to WAMIT, Inc, as instructed in the window. The site key will be returned to the user via email. (If email is not available, fax is recommended.) When the site key is returned, run WAMIT again to reopen the License Configuration window, and type in the site key. (The use of copy/paste is recommended with email to avoid mistakes.) A message confirming authorization should appear, and the program is ready to use. Note 1. The administrator's privilege is required for the installation and activation of WAMIT license Note 2. Users should have READ/WRITE privilege ------------------------------------------------------------------------------- Update from V6.40 V6.41 is extended to accept the RAO evaluated by the users. This option allows users to modify RAO before computing pressures, velocities and mean forces. F2T is extended for the transforms of pressures and velocities (options 5,6 and 7) when NBODY > 1. (see Section 13.5 of User Manual for the special notes on the application of F2T for opitions 5, 6 and 7). V6.41 is corrected to avoid the interruption when field quantities are computed for stuctures with internal tanks. V6.41 is corrected to accept mutliple bodies with IGDEF=2 F2T is corrected to accept IDIFF=-1 --------------------------------------------------------------------------------------- Update from V6.41