README FILE: RUAUMOKO-2D and RUAUMOKO-3D

Windows95/Windows98/WindowsNT/Windows2000/WindowsXP/WindowsVistaversion. (Compaq Visual FORTRAN 6.6B compiler version)

1. These versions of Ruaumoko2D and Ruaumoko3D run directly under the Windows95,Windows98, WindowsNT, WindowsXP or WindowsVista operating systems. The plotsave file Ruaumoko.tmp is created in the users current directory and the scratchdata-base file Ruaumoko.scr is created in the directory defined by the 'temp'environment variable set in the Autoexec.bat file in the users operating system. If the'temp' variable is not defined then the file is created in the users current workingdirectory. This is of no consequence on a single PC but if the program is being run froma server on a network then the scratch file should be on the local hard disk and NOT onthe server as the network traffic will be very large and program speed will be greatlyreduced. Both files are deleted by Ruaumoko2D or Ruaumoko3D at the end of theanalysis, but if they are left in the directories because of an abnormal programtermination this is of no consequence as they will be over-written in the next analysis. However, as both programs use the same file names do not run more that one version ofthe programs at any one time. In the latest versions of the programs the scratch file islargely emulated in memory, greatly speeding up the execution of the programs andthough the scratch file will be created, it it may not, in fact, be used unless the memorybuffer defined is exceeded in a very large analysis.

On all computers in the computer laboratories in the College of Engineering, Universityof Canterbury, the ‘temp’ variable is defined as being the local hard disk temporarydirectory C:\TEMP . In this operating system it is the only directory in which studentsare allowed to create files apart from their own directories on the student server. Theaim of putting the scratch file on the local hard disk is to minimise the network trafficwhich slows the program down by a factor of about 5 if the scratch file is located on thenetwork servers.

2. This version of Ruaumoko2D has a memory limitation set at 10000000 integers and Ruaumoko3D has a memory limitation set at 63000000 integers. If greaterrequirements are needed please let me know and I will arrange a version with morememory. (Note: With the current Fortran Compilers 63000000 integers appears to be aslarge a dimension that we can use without getting addressing errors from the compiler)These amounts of memory appear to be adequate for all current users. The amount ofmemory used in the analysis is shown in the statistics information at the end of the outputfile as is the memory available. If the user wants to know the "wall clock" time taken for

1

the analysis this is available by subtracting the analysis start time output at the beginningof the output file from the finish time output in the statistical information at the end ofthe output file.

3. The versions of Dynaplot and Combplot have a memory limitation of 2000000 integers.This should be ample for any plotting. For n lines there is a requirement of (n+1)*2integers per plot point. The number of points is equal to the number of data saves to the.res file and this is a function of the step interval KPA (or KPOST) and the total numberof time-steps in the Ruaumoko2D or Ruaumoko3D analysis.

4. The post-processor (.res) files created by Ruaumoko2D and Ruaumoko3D are binaryfiles as files created in an ASCII mode (and hence viewable on the screen) would be, atleast, twice the size of the binary files. However, there is an option to generate ASCII post-processor files for Dynaplot, please see the file ASCII.pdf in the manualsdirectory.

5. When running Ruaumoko2D or Ruaumoko3D in batch mode underWindowsNT/2000/XP the "start/w" command is not required in a 'batch' file asWindowsNT, Windows2000 or WindowsXP do not try and run all batch commandsconcurrently. The start/w command requires that the command line is completed beforethe system attempts to start the next command in the Batch2D.bat file for example. Thecommand is required under Windows95 or Windows98 in the .bat files.

6. Programs Dynaplot, and Combplot are the same for both Ruaumoko and Ruaumoko3D.

7. Much of Ruaumoko2D now uses the subroutines from Ruaumoko3D.

8. Comments about ease of use and usefulness of the program are appreciated. Suggestionsfor improvements to the programs or additional features are welcome. Similarly,suggestions for improvements, additions or corrections to the manuals are greatlyappreciated.

===================

2

SETUP for Full License version

Create a directory in which you wish to put Ruaumoko.Note: All files copied from a cdrom are given the read-only attribute. Use Windows

Explorer, etc., to change the attribute of at least the data and .bat files toread-write so the you may edit them.

1. Copy the .pdf files from the root directory on the cdrom to get

Setup.pdf (These Set-up Notes)

It is suggested that these text files may be located in the same directory that will be used forthe executable files. It is suggested that the release notes (if present) be printed off and madeavailable to all program users or else copies be attached to the appropriate manuals. Alternatively, the updated manuals could be printed from the Manuals directory.

2. Copy the executable files from the directory Executable to get

Ruaumoko2D.exe (Ruaumoko-2D executable file)Ruaumoko3D.exe (Ruaumoko-3D executable file)Ruaumoko2N.exe (Ruaumoko-2D executable file, no graphics version for batch

execution)Ruaumoko3N.exe (Ruaumoko-3D executable file no graphics version for batch

execution)Ruaumoko2E.exe (Ruaumoko-2D executable file, version with arithmatics

exceptions check on)Ruaumoko3E.exe (Ruaumoko-3D executable file, version with arithmetic

exceptions check on)Dynaplot.exe (Post-processor program for Ruaumoko2D and Ruaumoko3D)Combplot.exe (Post-processor program for Dynaplot)Hysteres.exe (Hysteresis rule exerciser or tuner)Spectra.exe (Computes Earthquake Response Spectra)Inspect.exe (Computes Inelastic Earthquake Response Spectra)Simqke.exe (Generates artificial ground motions)Pquake.exe (Plots Earthquake Accelerograms)Fprint.exe (Printer program to use FORTRAN carriage controls)Surface.exe (Plots of Axial Force - Yield Moment interaction diagrams for

Ruaumoko3D)Fqwin.hlp (Microsoft Quick-Windows Help file)Batch2D.bat (Example of Ruaumoko2D.bat for batch execution)Batch3D.bat (Example of Ruaumoko3D.bat for batch execution)

The Fqwin.hlp file MUST be in the PATH for any of the programs to run.

It is suggested that the directory with these executable files be added to the system Path in theAutoexec.bat file (or else to the users Path in the WindowsNT or Windows2000 operatingsystems).

3

Notes:1. The Ruaumoko2N, Ruaumoko3N, Ruaumoko2E and Ruaumoko3E etc.

versions are not always provided.2. The Ruaumoko2N and Ruaumoko3N versions are compiled with no graphics

routines and as such are more efficient for running in "Batch" mode as there is norisk of a graphics call terminating the batch process. The data is unchanged fromthat of the normal versions of Ruaumoko2D or Ruaumoko3D respectively and theoutput and post-processor files are identical to those of the standared versions ofRuaumoko. As these versions of Ruaumoko do not use Microsoft QuickWindows(see section on Windows) the problem of the operating system taking too long tofind its own dynamic-link-libraries does not occur and the time delay used with theother versiosn of Ruaumoko to overcome this problem are not needed.

3. Microsoft Windows does not check for arithmetic exceptions such as arithmeticunderflow, overflow and divide by zero. It is possible to get problems with, inparticular, underflow where the result of a multiplcation or subtraction results in anumber smaller than that which can be represented by the precision of the computer. In this case the exponents are modified as in the normal numerical operation but thenumber cannot now be represented and results in a NaN (Not a Number). Once aNaN occurs in the arithmetic they tend to propagate right through the solutionmaking results useless. The programs attempt to trap for NaNs, and assumming thatthey are resulting from an underflow where they can be found at no significantoperational cost, they are replaced by 0.0. There are parts of the program where they would be expensive to trap for NaNs andthere may be also be cases where they may not be from an underflow, so the user should check the output files for undeflows. The Ruaumoko2E and Ruaumoko3E versions have exceptrions checking turned on, resulting in considerably slower execution but avoiding the risk of NaNs occuring. If problems with NaNs do occur with Ruaumoko2D and Ruaumoko3D then the problem could be tried with Ruaumoko2E or Ruaumoko3E.Most other computing operating systems automatically check for arithmetic exceptions.

4. As a user, I prefer to run my analyses from the directory where I have my data sets and where my output and post-processor files are generated. This is my working directory. I keep all my executable files in one executable directory which is in the system or user path. When I have finished with the analyses of a given structure andI have plotted all the results I need, I delete output and post-processor files and move the data files to a separate data directory from where they can be retrieved if necessary at a later time.

4

SETUP for Student version

Create a directory in which you wish to put Ruaumoko.Note: All files copied from a cdrom are given the read-only attribute. Use Windows

Explorer, etc., to change the attribute of at least the data and .bat files to read-writeso the you may edit them.

1. Copy the .pdf files from the root directory on the cdrom to get

Setup.pdf (These Set-up Notes)

It is suggested that these text files may be located in the same directory that will be used for theexecutable files. It is suggested that the release notes (if present) be printed off and madeavailable to all program users or else copies be attached to the appropriate manuals. Alternatively, the updated manuals could be printed from the Manuals directory.

2. Copy the executable files from the directory Student to get

Ruaumoko2D.exe (Ruaumoko-2D executable file)Ruaumoko2N.exe (Ruaumoko-2D executable file, no graphics version for batch

execution)Dynaplot.exe (Post-processor program for Ruaumoko2D and Ruaumoko3D)Combplot.exe (Post-processor program for Dynaplot)Spectra.exe (Computes Earthquake Response Spectra)Pquake.exe (Plots Earthquake Accelerograms)Fprint.exe (Printer program to use FORTRAN carriage controls)Surface.exe (Plots of Axial Force - Yield Moment interaction diagrams for

Ruaumoko3D)Fqwin.hlp (Microsoft Quick-Windows Help file)Batch2D.bat (Example of Ruaumoko2D.bat for batch execution)

The Fqwin.hlp file MUST be in the PATH for any of the programs to run.

It is suggested that the directory with these executable files be added to the system Path in theAutoexec.bat file (or else to the users Path in the WindowsNT or Windows2000 operatingsystems).

For the Stident version of Ruaumoko2D the memory limit is set at 30,000 integers and themaximum number of joints, or nodes, in the structure is limited to 25 joints.

5

Notes:1. The Ruaumoko2N version is not generally provided.2. The Ruaumoko2N version is compiled with no graphics routines and as such are

more efficient for running in "Batch" mode as there is no risk of a graphics callterminating the batch process. The data is unchanged from that of the normalversions of Ruaumoko2D.

3. As a user, I prefer to run my analyses from the directory where I have my data sets and where my output and post-processor files are generated. This is my working directory. I keep all my executable files in one executable directory which is in the system or user path. When I have finished with the analyses of a given structure andI have plotted all the results I need, I delete output and post-processor files and move the data files to a separate data directory from where they can be retrieved if necessary at a later time.

6

3. Copy the directory Quake to get the following earthquake accelerograms. It is suggestedthat these be kept in a separate directory, i.e. C:\Quake to keep the path short as thesenames will be required to be input each time Ruaumoko2D, Ruaumoko3D, Inspect orSpectra are run and the longer the path name the more characters that have to be typedwith increased chance of error.

Aps94ml.eqs (Arthur's Pass, NZ, June 1994, North-South Component)Aps94mt.eqs (Arthur's Pass, NZ, June 1994, East-West Component)Aps94mv.eqs (Arthur's Pass, NZ, June 1994, Vertical Component)Buchnsc.eqb (Bucharest 1977, North-South component)El40nsc.eqb (El Centro May 1940 North-South Component)El40ewc.eqb (El Centro May 1940 East-West Component)Hallc5.eqf (Artifical record in FREE format)Kobe95ns.eqn (Kobe January 1995 North-South Component)Kobe95ew.eqn (Kobe January 1995 East-West Component)Kobe95up.eqn (Kobe January 1995 Vertical Component)Mexsct1l.eqc (Mexico City, 1985, SCT site)Norway.eqc (Artificial Accelerogram - Norwegian Off-shore Spectra)Pacmsw.eqb (Pacoima Dam, San Fernando, 1971, Southern Component)Pacm941.eqs (Pacoima Dam,Northridge,Jan.1994 North-South Component)Pacm942.eqs (Pacoima Dam,Northridge,Jan.1994 Vertical Component)Pacm943.eqs (Pacoima Dam,Northridge,Jan.1994 East-West Component)Siszkav.eqs (S.Iceland Seismic Zone, Selfoss,Jun.2000, East-West)Siszkns.eqs (S.Iceland Seismic Zone, Selfoss,Jun.2000, North-South)Siszkun.eqs (S.Iceland Seismic Zone, Selfoss,Jun.2000, Vertical)Sisz103a.eqs (S.Iceland Seismic Zone, Site103,Jun.2000, North-South)Sisz103b.eqs (S.Iceland Seismic Zone, Site103,Jun.2000, Vertical)Sisz103c.eqs (S.Iceland Seismic Zone, Site103,Jun.2000, East-West)Sylm949.eqs (Sylmar Hosp,Northridge,Jan.1994 North-South Component)Sylm941.eqs (Sylmar Hosp,Northridge,Jan.1994 Vertical Component)Sylm94d.eqs (Sylmar Hosp,Northridge,Jan.1994 East-West Component)Equake.pdf (Description of earthquake files)

7

4. Copy the directory Examples to get the following example data sets. It is suggested thatthese files be kept in a separate directory. These data files may be edited with Notepad

Example.dat (Ruaumoko2D)Pushover.dat (Ruaumoko2D)Frame12e.dat (Ruaumoko2D)Frame12a.dat (Ruaumoko2D)Frame12d.dat (Ruaumoko2D)Frame12l.dat (Ruaumoko2D)Frame12p.dat (Ruaumoko2D)Frame12p.dat (Ruaumoko2D)Frame12m.dat (Ruaumoko2D)Pounding.dat (Ruaumoko2D)Isolated.dat (Ruaumoko2D)GraceKao.dat (Ruaumoko2D)Exampl3D.dat (Ruaumoko3D)Pushov3D.dat (Ruaumoko3D)Frame3Di.dat (Ruaumoko3D)Frame3Dm.dat (Ruaumoko3D)Frame3De.dat (Ruaumoko3D)Frame3Da.dat (Ruaumoko3D)Sac3D.dat (Ruaumoko3D)H2b.dat (Ruaumoko3D)H3b.dat (Ruaumoko3D)Wpe1x.dat (Ground displacement history for H2b.dat & H3b.dat)Dz4203eq.dat (Simqke)ReadData.txt (Description of example files)

5. Copy the RESULTS directory to get the following example results sets. It is suggestedthat these be kept in a separate directory. These files may be deleted from this directoryonce your use for them is finished. They may be re-copied from the cdrom at a later dateif desired.

Adaptive.wri (Results from Adaptive.dat)Adaptive.res (input to the post-processor program Dynaplot)Exampl3D.wri (Results from Exampl3D.dat and El40nsc.eqb)Exampl3D.res (input to the post-processor program Dynaplot)Example.wri (Results from Example.dat and El40nsc.eqb)Example.res (input to the post-processor program Dynaplot)Frame12e.wri (Results from Frame12e.dat and El40nsc.eqb)Frame12e.res (input to the post-processor program Dynaplot)Frame3Di.wri (Results from Frame3Di.dat, El40nsc.eqb & El40ewc.eqb)Frame3Di.res (input to the post-processor program Dynaplot)Pushover.wri (Results from Pushover.dat)Pushover.res (input to the post-processor program Dynaplot)

8

6. Copy the ICONS directory to get the following icons that may be used to create shortcutsto the programs on the desktop. It is suggested that the files themselves be kept in aseparate directory or in the same directory as the executable files.

Ruaumoko2D.icoRuaumoko3D.icoDynaplot.icoCombplot.icoHysteres.icoSpectra.icoInspect.icoSimqke.icoPquake.icoFprint.icoReadIcon.pdf

7. If desired you may copy the directory Source to get the following sample hysteresis source file as an example if you wish to have your own hysteresis rule incorporated intoRuaumoko2D, Ruaumoko3D, Inspect and Hysteres. You could write the subroutinefollowing the programming rules implied in the sample program, send it to me to integrateinto the programs and send you back the updated programs. It is suggested that these filesbe in a separate directory.

Sample.for (Sample Bi-linear hystersis rule subroutine)Condedit.for (Conditional Pre-editor used before passing FORTRAN source code

to the compiler)Readfor.txt (Description of source files)TinyClip.pdf (Description of way Ruaumoko command processor works)

(usage:Condedit Sample.for Sample.fthen call compiler e.g.F90 Sample.fthen delete system specific source fileDel Sample.fyou are left with compiled code and original non-system specific source file,In my case, all done with a Fortran.bat file i.e.Fortran Sample )

8. Copy the files from the directory Rui and then run Setup.exe to set up the RuaumokoUser Interface program. See the ReadRui.pdf file in the Rui directory. It is suggestedthat these files be kept in a separate directory. (This is only for Ruaumoko and notRuaumoko3D) This version of the user interface will be not be continued as theperformance and the ease of upgrading the program in Visual Basic has not been asuccess. Work is underway to find an alternative means of creating a better user interfaceprogram. It has also been found that the Visual Basic graphics has an unpredictablebehaviour on some laptop displays.

9

9. The manuals are in the directory Manuals as bookmarked .pdf files. These may beprinted if required. The manuals are also available for download from the Ruaumokoweb site www.ruaumoko.co.nz

There are 5 manuals:1. RuaumokoTheory.pdf. The theory manual.2. Ruaumoko2D.pdf The manual for the Ruaumoko 2-D. 3. Ruaumoko3D.pdf The manual for the Ruaumoko 3-D. 4. RuaumokoOther.pdf The manual for the support programs.5. RuaumokoAppendices.pdf The manual for the hysteresis loops.

10

Release Notes

This contains features not covered in the user manuals for Ruaumoko etc. Copies shouldbe distributed to all users or appended to the user manuals

Running the program DYNAPLOT in Batch Mode

Dynaplot has always had the option of not actually plotting the graphs that it generates,though they may still be saved for spreadsheet use with the Keep option.

To turn the graphics off follow the name of the post-processor file (the .res or .ras file)with the word no in upper or lower case (or mixed case).

The user can also run the program using the $add option of the command processor ofhaving responses already prepared for production analyses. These are most easilygenerated using the $log option of the command processor whilst running Dynaplot in theconventional interactive mode. The resulting file can then be edited, with any text editorsuch as Notepad etc. to form the input for later runs. Please see the exampleDynaplot.txt file in the Results directory on the cdrom.

Dynaplot now has an option to be run in batch mode. This is useful for researchersrunning large numbers of parameter studies and who wish to use some features of thepost-processing. In the batch mode the graphics is automatically turned off. To run the Dynaplot in batch mode the command Dynaplot must be followed by at least3 arguments, i.e.

Dynaplot Output.wri Example Input.txt

where Output.wri is the name of the output file. This file contains the maximum andminimum values of every line drawn in every plot drawn by Dynaplot. Anyextension may be used, i.e. .wri or .txt etc. This file MUST NOT exist or theprogram will terminate.Example is the name of the postprocessor file. This file MUST exist. The file willhave the extension .res or .ras depending on whether it is binary or ASCII post-processor file. The extension is NOT supplied with the name.Input.txt is the name of the data file containing all the command input for Dynaplot,which is very similar to the example file Dynaplot.txt in the Results directory onthe cdrom. This file MUST exist.

The input data file is probably best generated during a conventional interactive use ofDynaplot saving a copy of all the commands and data with the $log option of thecommand processor. The only difference is that in the batch mode there is only oneoutput file and the Open option in Dynaplot works in a different manner. In theinteractive mode in Dynaplot when the Open option is used, the existing output file (ifnot screen) is closed and the user is prompted for a new output file name. The user isthen prompted for a new post-processor file name. In the batch mode there is only oneoutput file, that given in the command line. If the Open option is invoked, the commandOpen must be followed (on the same line) by the name of the new post-processor file.

11

The file name has the .res or .ras implied and the extension therefore MUST NOT beapplied.

12

RUAUMOKO Graphics and Microsoft Windows

There have been some difficulties with the graphics when running the Ruaumoko suite ofprograms in the WindowsXP operating system. The programs run without any problems inWindows95, Windows98, WindowsME, WindowsNT 4.0 and Windows2000. The causes ofthese difficulties have been isolated and this note is being sent out to all licence holders sothat they can remove the problems. I am still investigating if there are simpler fixes and alsowhat to do where the files are located on Windows2000 servers with WindowsXP clients.

Child Windows

The movie-like effects in Ruaumoko2D, Ruaumoko3D and Dynaplot are obtained bycreating two child windows, one window is viewable and the other is active but invisible, i.e.drawings can be created. When the new drawing is complete the windows status is reversedand the next drawing is prepared. In WindowsXP there appears the outline of a WindowsXPwindow superimposed on the child window and this does not appear in the same place ineach child window which means that the there is jittering effect on the screen.

To fix this problem.• Go to Windows Explorer and open the directory which contains the executable files

Ruaumoko2D.exe, Ruaumoko3D.exe and Dynaplot.exe.• Right click on the executable program, such as Ruaumoko2D.exe, and select

Properties.• Select Compatibility and check the box Disable Visual Themes.• Repeat this process for Ruaumoko3D.exe and Dynaplot.exe.

This will remove the superimposed WindowsXP windows from the graphics. If the changesto the properties is also done for the other executable files, such as Spectra.exe etc. it willhave no effect apart from, apparently, speeding up the execution of the programs.

The other graphics problem detected with all the programs in the Ruaumoko suite is that thesmall font appears very faint grey, being very hard to see, and the printed graphs are nobetter. On each computer running the programs the following needs to be done the fix theproblem.

• Go to Control Panel.• Select System. You may have to change the View option to Show Details to find the

System option.• Select Advanced.• Select Performance.• Select Settings.• Un-check Smooth Edges of Screen Fonts.• Click ok all the way back to Control Panel.

The small font is now back to full black characters to match the large font. For more information, go to Help, topic Screen Fonts, then Making them more readable.

I am not aware, as yet of any new difficulties with the WindowsVista and Windows 7operating systems

13

Start-up Delays.

The programs all use Microsoft QuickWindows routines for the graphis as well as the whitescreen background with black text, as oppopsed to the standard DOS black screen with whitetext.

The QuickWindows routine use Microsoft Dynamic-Link-Libraries (.dll) which are supposedto be loaded by the operating system at program start up. However, with the newer andfaster operating systems and faster processors the operating system does not always seem tobe able to find the necessary .dll files before the program starts to execute. This leads to anoperating system error and the programs fail to start. The only suggestion, so far from thecompiler manufacturers, is to give the program a time-delay on start-up so as to give theoperating system time to find its own dynamic link libraries. At present the programs withthe child windows etc are given a 6 seconds time-delay on start-up (a delay on pressnt theenter key and the first prompt appearing on the window). The other programs at presenthave no delay so there are occasions where the program will have to be called a second time. The 6 seconds is not always sufficient. If persistent problems on start-up occur please let meknow.

Athol J. Carr. 24th January 2012

14