Getting Started Building a Simple System Adding a Line Adjusting the View Static Analysis Dynamic Analysis Multiple Views Looking at Results Getting Output Input Data
21 21 21 22 22 23 23 24 24 24
3 USER INTERFACE 3.1
3.2
3.3
25
Introduction
25
3.1.1 3.1.2 3.1.3 3.1.4 3.1.5 3.1.6
25 25 26 27 28 28
Program Windows The Model Model States Toolbar Status Bar Mouse and Keyboard Actions
View Parameters View Control Navigating in 3D Views Shaded Graphics How Objects are Drawn Selecting Objects Creating and Destroying Objects Dragging Objects Connecting Objects Printing, Copying and Exporting Views
Replays
59
3.7.1 3.7.2 3.7.3 3.7.4 3.7.5
60 60 61 61 63
Replay Parameters Replay Control Custom Replays Custom Replay Wizard Superimpose Times
Producing Results Selecting Variables Summary and Full Results Statistics Linked Statistics Offset Tables Line Clashing Report Time History and XY Graphs Range Graphs Offset Graphs Spectral Response Graphs
Introduction OrcaFlex Spreadsheet Instruction Format Pre-‐defined commands Basic commands Time History and related commands Range Graph commands Data commands Instructions Wizard Duplicate Instructions
5 THEORY 5.1 5.2 5.3 5.4 5.5
5.6
111
Coordinate Systems Direction Conventions Object Connections Interpolation Methods Static Analysis 5.5.1 5.5.2 5.5.3
97 98 100 101 102 103 103 104 105 107
111 112 113 113 115
Line Statics Buoy and Vessel Statics Vessel Multiple Statics
115 119 119
Dynamic Analysis
120
5
w
Contents
5.6.1 5.6.2
5.7 5.8 5.9 5.10
Calculation Method Ramping
121 123
Friction Theory Spectral Response Analysis Extreme Statistics Theory Environment Theory 5.10.1 5.10.2 5.10.3 5.10.4 5.10.5 5.10.6
123 126 127 129
Buoyancy Variation with Depth Current Theory Seabed Theory Seabed Non-‐Linear Soil Model Theory Morison's Equation Waves
5.11 Vessel Theory 5.11.1 5.11.2 5.11.3 5.11.4 5.11.5 5.11.6 5.11.7
129 129 130 131 137 138
145
Vessel Rotations RAOs and Phases RAO Quality Checks Hydrodynamic and Wind Damping Stiffness, Added Mass and Damping Impulse Response and Convolution Wave Drift Loads
Overview Structural Model Details Calculation Stages Calculation Stage 1 Tension Forces Calculation Stage 2 Bend Moments Calculation Stage 3 Shear Forces Calculation Stage 4 Torsion Moments Calculation Stage 5 Total Load Line End Orientation Line Local Orientation Treatment of Compression Contents Flow Effects Line Pressure Effects Pipe Stress Calculation Pipe Stress Matrix Hydrodynamic and Aerodynamic Loads Drag Chains Line End Conditions Interaction with the Sea Surface Interaction with Seabed and Shapes Clashing
5.13 6D Buoy Theory 5.13.1 5.13.2 5.13.3 5.13.4 5.13.5
177
Overview Lumped Buoy Added Mass, Damping and Drag Spar Buoy and Towed Fish Added Mass and Damping Spar Buoy and Towed Fish Drag Contact Forces
6
177 179 180 182 184
w
Contents
5.14 3D Buoy Theory 5.15 Winch Theory 5.16 Shape Theory
185 186 187
6 SYSTEM MODELLING: DATA AND RESULTS 6.1 6.2 6.3
Modelling Introduction Data in Time History Files Variable Data 6.3.1
General Data 6.4.1 6.4.2 6.4.3 6.4.4 6.4.5 6.4.6 6.4.7 6.4.8 6.4.9 6.4.10
202
Sea Data Sea Density Data Seabed Data Wave Data Data for Regular Waves Data for Random Waves Data for JONSWAP and ISSC Spectra Data for Ochi-‐Hubble Spectrum Data for Torsethaugen Spectrum Data for Gaussian Swell Spectrum Data for User Defined Spectrum Data for Time History Waves Data for User Specified Components Data for Response Calculation Waves Preview Modelling Design Waves Setting up a Random Sea Current Data Wind Data Drawing Data External Functions Results Wave Scatter Conversion
269 Line Data Line Types Attachments Rayleigh Damping Line Results Drag Chain Results Flex Joint Results Line Setup Wizard Line Type Wizard Chain Rope/Wire Line with Floats Homogeneous Pipe Hoses and Umbilicals Modelling Stress Joints Modelling Bend Restrictors Modelling non-‐linear homogeneous pipes Line Ends Modelling Compression in Flexibles
Wings Common Data Applied Loads Wing Data Wing Type Data Lumped Buoy Properties Lumped Buoy Drawing Data Spar Buoy and Towed Fish Properties Spar Buoy and Towed Fish Added Mass and Damping Spar Buoy and Towed Fish Drag Spar Buoy and Towed Fish Drawing Shaded Drawing Other uses External Functions Properties Report Results Buoy Hydrodynamics Hydrodynamic Properties of a Rectangular Box Modelling a Surface-‐Piercing Buoy
Commands Data Load Cases Data for Regular Analysis Load Cases Data for Rainflow Analysis Load Cases Data for Spectral Analysis Load Cases Data for SHEAR7 Components Data Analysis Data S-‐N and T-‐N Curves Integration Parameters Results Fatigue Points How Damage is Calculated
Wake Oscillator Models Vortex Tracking Models VIV Drawing
420 423 429
10
w
Introduction, Installing OrcaFlex
1
INTRODUCTION
Welcome to OrcaFlex (version 9.4a), a marine dynamics program developed by Orcina for static and dynamic analysis of a wide range of offshore systems, including all types of marine risers (rigid and flexible), global analysis, moorings, installation and towed systems. OrcaFlex provides fast and accurate analysis of catenary systems such as flexible risers and umbilical cables under wave and current loads and externally imposed motions. OrcaFlex makes extensive use of graphics to assist understanding. The program can be operated in batch mode for routine analysis work and there are also special facilities for post-‐processing your results including fully integrated fatigue analysis capabilities. OrcaFlex is a fully 3D non-‐linear time domain finite element program capable of dealing with arbitrarily large deflections of the flexible from the initial configuration. A lumped mass element is used which greatly simplifies the mathematical formulation and allows quick and efficient development of the program to include additional force terms and constraints on the system in response to new engineering requirements. In addition to the time domain features, modal analysis can be performed for individual lines and RAOs can be calculated for any results variable using the Spectral Response Analysis feature. OrcaFlex is also used for applications in the Defence, Oceanography and Renewable energy sectors. OrcaFlex is fully 3D and can handle multi-‐line systems, floating lines, line dynamics after release, etc. Inputs include ship motions, regular and random waves. Results output includes animated replay plus full graphical and numerical presentation. If you are new to OrcaFlex then please see the tutorial and examples. For further details of OrcaFlex and our other software, please contact Orcina or your Orcina agent. Copyright notice
Copyright Orcina Ltd. 1987-‐2010. All rights reserved.
1.1
INSTALLING ORCAFLEX
Hardware Requirements OrcaFlex can be installed and run on any computer that has: x
Windows XP, Windows Vista or Windows 7. Both 32 bit and 64 bit versions of Windows are supported.
x
If you are using small fonts (96dpi) the screen resolution must be at least 1024×768. If you are using large fonts (120dpi) the screen resolution must be at least 1280×1024.
However, OrcaFlex is a powerful package and to get the best results we would recommend: x
A powerful processor with fast floating point and memory performance. This is the most important factor since OrcaFlex is a computation-‐intensive program and simulation run times can be long for complex models.
x
At least 2GB of memory. This is less important than processor performance but some aspects of OrcaFlex do perform better when more memory is available, especially on multi-‐core systems. If you have a multi-‐core system with a 64 bit version of Windows then you may benefit from fitting even more memory.
x
A multi-‐core system to take advantage of OrcaFlex's multi-‐threading capabilities.
x
As much disk space as you require to store simulation files. Simulation files vary in size, but can be 100's of megabytes each for complex models.
x
A screen resolution of 1280×1024 or greater with 32 bit colour.
x
A DirectX 9 compatible graphics card with at least 256MB memory for the most effective use of the shaded graphics facility.
x
Microsoft Excel (Excel 2000, or later) in order to use the OrcaFlex automation facilities. This requires the 32 bit version of Excel. Note:
Although OrcaFlex is a 32 bit program, the 64 bit versions of Windows run 32 bit programs very efficiently and have certain advantages over 32 bit versions of Windows. Most notably the 64 bit versions of Windows are able to make use of larger amounts of memory. This can benefit OrcaFlex, and indeed other programs. In addition we have found the 64 bit versions of Windows to be more effective at multi-‐threaded calculations. For these reasons we currently recommend 64 bit Vista/7 as the best platforms for running OrcaFlex.
11
w
Introduction, Installing OrcaFlex
Installation To install OrcaFlex: x
You will need to install from an account with administrator privileges.
x
If installing from CD, insert the OrcaFlex CD and run the Autorun.exe program on the CD (on many machines this program will run automatically when you insert the CD). Then click on 'Install OrcaFlex'.
x
If you have received OrcaFlex by e-‐mail or from the web you will have a zip file, and possibly a number of licence files (.lic). Extract the files from the zip file to some temporary location, and save the licence files to the same folder. Then run the extracted file Setup.exe.
x
You will also need to install the OrcaFlex dongle supplied by Orcina. See below for details.
For further details, including information on network and silent installation, click on Read Me on the Autorun menu or open the file Installation Guide.pdf on the CD. If you have any difficulty installing OrcaFlex please contact Orcina or your Orcina agent. Orcina Shell Extension When you install OrcaFlex the Orcina Shell Extension is also installed. This integrates with Windows Explorer, and associates the data and simulation file types (.dat and .sim) with OrcaFlex. You can then open an OrcaFlex file by simply double-‐clicking the filename in Explorer. The shell extension also provides file properties information, such as which version of OrcaFlex wrote the file and the Comments text for the model in the file. For details see the file CD:\OrcShlEx\ReadMe.htm on the OrcaFlex CD. Installing the Dongle OrcaFlex is supplied with a dongle, a small hardware device that must be attached to the machine or to the network to which the machine is attached. Note:
The dongle is effectively your licence to run one copy (or more, if the dongle is enabled for more copies) of OrcaFlex. It is, in essence, what you have purchased or leased, and it should be treated with appropriate care and security. If you lose your dongle you cannot run OrcaFlex.
Warning:
Orcina can normally resupply disks or manuals (a charge being made to cover costs) if they are lost or damaged. But we can only supply a new dongle in the case where the old dongle is returned to us.
Dongles labelled 'Hxxx' (where xxx is the dongle number) must be plugged into the machine on which OrcaFlex is run. Dongles labelled 'Nxxx' can be used in the same way as 'Hxxx' dongles, but they can also be used over a network, allowing the program to be shared by multiple users. In the latter case the dongle should be installed by your network administrator; instructions can be found in the Dongle directory on the OrcaFlex CD. Types of Dongle
Dongles are available for either parallel or USB ports, and these are functionally equivalent so far as OrcaFlex is concerned. In general, USB dongles are preferred, since they seem to be more reliable. In any case, parallel ports are becoming less common on new machines. By default, 'N' dongles can hold up to 10 OrcaFlex licences for use over a network. We can supply dongles with larger capacities on request. Dongle Troubleshooting We supply, with OrcaFlex, a dongle utility program called OrcaDongle. If OrcaFlex cannot find the dongle then this program may be used to check that the dongle is working correctly and has the expected number of licences. For details see the OrcaDongle help file. The OrcaDongle program is included on the OrcaFlex CD, and you may choose to install it from the Autorun menu in the same way as OrcaFlex. It is also available for download from www.orcina.com/Support/Dongle. Also on our website, users of network dongles may find the Orcina Licence Monitor to be useful. This application keeps track of the number of OrcaFlex licences claimed on a network at any time. Diagnostics
If OrcaFlex fails to start, with the error that it can't obtain a licence, then please check the following. x
If you are using a network dongle, are all the licences in use? The Orcina Licence Monitor may be of use in determining this. If they are, you will need to wait until a licence becomes free before you can run OrcaFlex.
12
w
Introduction, Running OrcaFlex
x
If you are using a local dongle, is it plugged into your machine? If so, is the dongle device driver installed? You can check this by running OrcaDongle. If the driver is not present, it may have been uninstalled by another program: if so, you can fix this by Repairing the OrcaFlex installation (from the Windows Control Panel, select 'Add or Remove Programs' (XP) or Programs / Programs and Features (Vista), select the OrcaFlex entry, select Change then Repair). If this still fails, you can install the driver by downloading from our website, and running, the file Hasp-‐Setup.msi.
x
Does the dongle you are using have an OrcaFlex licence on it? Again, you can check this with OrcaDongle.
x
Do you have a licence file for the dongle you wish to access? This file will be named Nxxx.lic or Hxxx.lic (where xxx is the dongle number) and will be in the OrcaFlex installation folder. If not, then you should be able to copy the required file(s) from the root level of the OrcaFlex CD into the installation folder.
If none of these help, then please contact us at Orcina with a description of the problem. Ideally, please also email to us the diagnostics file named OrcLog.txt which OrcaFlex will have written on failing to find a licence. This file can be found in the folder "%appdata%/Orcina/OrcaFlex": to open this folder, select Start menu | Run... and enter the text between the quotes (including the '%' characters).
1.2
RUNNING ORCAFLEX
A shortcut to run OrcaFlex is set up on the Start menu when you install OrcaFlex (see Start\Programs\Orcina Software\). This shortcut passes no parameters to OrcaFlex so it gives the default start-‐up behaviour; see below. If this is not suitable you can configure the start-‐up behaviour using command-‐line parameters, for example by setting up your own shortcuts with particular parameter settings. Default Start-‐up OrcaFlex has two basic modules: full OrcaFlex and statics-‐only OrcaFlex. A full OrcaFlex licence is needed for dynamic analysis. When you run OrcaFlex it looks for an Orcina dongle from which it can claim an OrcaFlex licence (either a full licence or a statics-‐only licence). By default, it first looks for a licence on a local dongle (i.e. one in local mode and connected to the local machine) and if none is found then it looks for a licence on a network dongle (i.e. one in network mode and accessed via a licence manager over the network). This default behaviour can be changed by command-‐line parameters. If OrcaFlex finds a network dongle and there is a choice of which licences to claim from it, then OrcaFlex displays a Choose Modules dialog to ask you which modules you want to claim. This helps you share the licences with other users of that network dongle. For example if the network dongle contains both a full licence and a statics-‐only licence then you can choose to use the statics-‐only licence, if that is all you need, so that the full licence is left free for others to use when you do not need it yourself. The Choose Modules dialog can be suppressed using command-‐line parameters. Command Line Parameters OrcaFlex can accept various parameters on the command line to modify the way it starts up. The syntax is: OrcaFlex.exe Filename Option1 Option2 ... etc. Filename is optional. If present it should be the name of an OrcaFlex data file (.dat or .yml) or simulation file (.sim) and after starting up OrcaFlex will automatically open that file. Option1, Option2 etc. are optional parameters that allow you configure the start-‐up behaviour. They can be any of the following switches. For the first character of an option switch, the hyphen character '-‐' can be used as an alternative to the '/' character. Dongle Search switches
By default the program searches first for a licence on a local dongle and then for a licence on a network dongle. The following switches allow you to modify this default behaviour. x
/LocalDongle Only search for licences on a local dongle. No search will be made for network dongles.
x
/NetworkDongle Only search for licences on a network dongle. Any local dongle will be ignored. This can be useful if you have a local dongle but want to use a network dongle that has licences for more modules.
13
w
Introduction, Parallel Processing
Module Choice switch
This switch is only relevant if the dongle found is a network dongle and there is a choice of licences to claim from that dongle. You can specify your choice using the following command line switch: x
/DisableDynamics Choose the statics-‐only basic licence. This is sometimes useful when using a network dongle since it allows you to leave full licences free for other users when you only need a statics-‐only licence.
If you do not specify all the choices then the program displays the Choose Modules dialog to ask for your remaining choices. You can suppress this dialog using the following switch. x
/DisableInteractiveStartup Do not display the Choose Modules dialog. The program behaves the same as if the user clicks OK on that dialog without changing any module choices.
Batch Calculation switches
These switches allow you to instruct OrcaFlex to start a batch calculation as soon as the program has loaded. The following switches are available: x
/Batch Start a batch calculation as soon as the program has loaded. The batch calculation will contain all the files specified on the command line (you can have more than one) in the order in which they are specified. You can use relative paths which will be relative to the working directory.
x
/CloseAfterBatch Instructs the program to close once the batch is complete.
x
/BatchAnalysisStatics, /BatchAnalysisDynamics specify what type of analysis to perform to the specified files. If these parameters are missing then the program defaults to dynamic analysis.
Process Priority switches
These switches determine the processing priority of OrcaFlex. The available switches are /RealtimePriority, /HighPriority, /AboveNormalPriority, /NormalPriority, /BelowNormalPriority, /LowPriority. ThickLines switch
The /ThickLines switch allows you to specify a minimum thickness for lines drawn on OrcaFlex 3D View windows. For example using the switch /ThickLines=5 forces OrcaFlex to draw all lines at a thickness of at least 5. If no value is specified (i.e. the switch is /ThickLines) then the minimum thickness i s taken to be 2. This switch has been added to make OrcaFlex 3D Views clearer when projected onto a large screen. ThreadCount switch
The /ThreadCount switch allows you to set the number of execution threads used by OrcaFlex for parallel processing. For example /ThreadCount=1 forces OrcaFlex to use a single execution thread which has the effect of disabling parallel processing.
1.3
PARALLEL PROCESSING
Machines with multiple processors or processors with multiple cores are becoming increasingly common. OrcaFlex can make good use of the additional processing capacity afforded by such machines. For up to date information on hardware choice for OrcaFlex please refer to www.orcina.com/Support/Benchmark. OrcaFlex performs the calculations of the model's Line objects in parallel. This means that, interactively at least, performance is only improved for models with more than one Line object. However, for models with more than one Line performance is significantly improved. Both batch processing and fatigue calculations process their jobs and load cases concurrently, using all available processor cores. Note, however, that the OrcaFlex spreadsheet is currently only able to make use of a single processor core. We plan to address this limitation in a future release. Thread count
OrcaFlex manages a number of execution threads to perform the parallel calculations. The number of these threads (the thread count) defaults to the number of physical processor cores available on your machine as reported by the operating system. This default will work well for most cases. Should you wish to change it you can use the Tools | Set Thread Count menu item. The thread count can also be controlled by a command line switch.
14
w
Introduction, Distributed OrcaFlex
Hyperthreading
Some Intel processors offer a technology called hyperthreading. Such processors can process multiple execution threads in parallel by making use of under-‐used resources on the processor. Hyperthreaded processors appear to the operating system as 2 distinct, logical processors. Sadly, the real world performance of such chips does not live up t o the marketing hype. At best this technology can give improvements of around 10-‐20%. However, the performance of hyperthreading under OrcaFlex varies considerably with the OrcaFlex model being analysed. In the worst cases using hyperthreading results in performance twice as slow as without! For this reason we recommend that you don't attempt to use hyperthreading when running OrcaFlex. By default OrcaFlex will use as many threads as there are true physical cores available to your system. To help understand this consider a dual processor, dual core machine with hyperthreading support. The operating system will recognise 8 processors. Of these processors, 4 are true physical processor cores and the other 4 are virtual hyperthreaded processors. Accordingly OrcaFlex will default to using 4 calculation threads.
1.4
DISTRIBUTED ORCAFLEX
Distributed OrcaFlex is a suite of programs that enables a collection of networked, OrcaFlex licensed computers to run OrcaFlex jobs, transparently, using spare processor time. For more information about Distributed OrcaFlex please refer to www.orcina.com/Support/DistributedOrcaFlex. Distributed OrcaFlex can be downloaded from this address. OrcaFlex can also make use of machines with multiple processors using parallel processing technology.
1.5
ORCINA LICENCE MONITOR
The Orcina Licence Monitor (OLM) is a service that monitors the current number of OrcaFlex licences claimed on a network in real time. Other programs that use the OrcaFlex programming interface (OrcFxAPI) such as Distributed OrcaFlex and the OrcaFlex spreadsheet are also monitored. You can obtain information on each licence claimed that includes: x
Network information: the computer name, network address and the user name.
x
Licence information: the dongle name, the dongle type (network or local) and the time the licence was claimed.
x
Program information: which modules are being used, the version, and the location of the program which has claimed the licence (usually this is OrcaFlex.exe but it can be Excel.exe for the OrcaFlex spreadsheet for example).
OLM can be downloaded from www.orcina.com/Support/OrcinaLicenceMonitor.
1.6
DEMONSTRATION VERSION
For an overview of OrcaFlex, see the Introduction topic and the tutorial. The demonstration version of OrcaFlex has some facilities disabled Ȃ you cannot calculate statics or run simulation, and you cannot save files, print, export or copy to the clipboard. Otherwise the demonstration version is just like the full version, so it allows you to see exactly how the program works. In particular the demonstration version allows you to open any prepared OrcaFlex data or simulation file. If you open a simulation file then you can then examine the results, see replays of the motion etc. There are numerous example files provided on the demonstration DVD. These example files are also available from www.orcina.com/SoftwareProducts/OrcaFlex/Examples. If you have the full version of OrcaFlex then you can use the demonstration version to show your customers your OrcaFlex models and results for their system. To do this, give them the demonstration version and copies of your OrcaFlex simulation files. The demonstration version can be downloaded from www.orcina.com/SoftwareProducts/OrcaFlex/Demo.
1.7
ORCAFLEX EXAMPLES
OrcaFlex is supplied with a DVD containing a comprehensive collection of example files. These examples can also be found at www.orcina.com/SoftwareProducts/OrcaFlex/Examples.
15
w
Introduction, Validation and QA
1.8
VALIDATION AND QA
The OrcaFlex validation documents are available from www.orcina.com/SoftwareProducts/OrcaFlex/Validation.
1.9
ORCINA
Orcina is a creative engineering software and consultancy company staffed by mechanical engineers, naval architects, mathematicians and software engineers with long experience in such demanding environments as the offshore, marine and nuclear industries. As well as developing engineering software, we offer a wide range of analysis and design services with particular strength in dynamics, hydrodynamics, fluid mechanics and mathematical modelling. Contact Details Orcina Ltd. Daltongate Ulverston Cumbria LA12 7AJ UK Telephone: +44 (0) 1229 584742 Fax: +44 (0) 1229 587191 E-‐mail: [email protected] Web Site: www.orcina.com Orcina Agents We have agents in many parts of the world. For details please refer to www.orcina.com/ContactOrcina.
1.10
REFERENCES AND LINKS
References API, 1993. API RP 2A-‐WSD, Recommended Practice for Planning, Designing and Constructing Fixed Offshore Platforms Ȅ Working Stress Design. American Petroleum Institute. API, 1998. API RP 2RD, Design of Risers for Floating Production Systems and Tension-‐Leg Platforms. American Petroleum Institute. API, 2005. API RP 2SK, Design and Analysis of Stationkeeping Systems for Floating Structures. American Petroleum Institute. API. Comparison of Analyses of Marine Drilling Risers. API Bulletin. 2J. Aubeny C, Biscontin G and Zhang J, 2006. Seafloor interaction with steel catenary risers. Offshore Technology Research Center (Texas A&M University) Final Project Report (http://www.mms.gov/tarprojects/510.htm). Aubeny C, Gaudin C and Randolph M, 2008. Cyclic Tests of Model Pipe in Kaolin. OTC 19494, 2008. Barltrop N D P and Adams A J, 1991. Dynamics of fixed marine structures. Butterworth Heinemann for MTD. 3rd Edition. Batchelor G K, 1967. An introduction to fluid dynamics. Cambridge University Press. Blevins R D, 2005. Forces on and Stability of a Cylinder in a Wake. J. OMAE, 127, 39-‐45. Bridge C, Laver K, Clukey E, Evans T, 2004. Steel Catenary Riser Touchdown Point Vertical Interaction Models. OTC 16628, 2004. Carter D J T, 1982. Prediction of Wave height and Period for a Constant Wind Velocity Using the JONSWAP Results, Ocean Engineering, 9, no. 1, 17-‐33. Casarella M J and Parsons M, 1970. Cable Systems Under Hydrodynamic Loading. Marine Technology Society Journal 4, No. 4, 27-‐44. Chapman D A, 1984. Towed Cable Behaviour During Ship Turning Manoeuvres. Ocean Engineering. 11, No. 4. Chung J and Hulbert G M, 1993. A time integration algorithm for structural dynamics with improved numerical dissipation: The generalized-‐ȽǤASME Journal of Applied Mechanics. 60, 371-‐375.
16
w
Introduction, References and Links
CMPT, 1998. Floating structures: A guide for design and analysis. Edited by Barltrop N D P. Centre for Marine and Petroleum Technology publication 101/98, Oilfield Publications Limited. Coles S, 2001. An Introduction to Statistical Modelling of Extreme Values. Springer. Cummins W E, 1962. The impulse response function and ship motions. Schiffstechnik, 9, 101-‐109. Dean R G, 1965. Stream function representation of non-‐linear ocean waves. J. Geophys. Res., 70, 4561-‐4572. Dirlik T, 1985. Application of computers in Fatigue Analysis. PhD Thesis University of Warwick. DNV-‐OS-‐F201, Dynamic Risers. DNV-‐RP-‐C205, Environmental Conditions and Environmental Loads. ESDU 71016. Fluid forces, pressures and moments on rectangular blocks. ESDU 71016 ESDU International, London. ESDU 80025. Mean forces, pressures and flow field velocities for circular cylindrical structures: Single cylinder with two-‐dimensional flow. ESDU 80025 ESDU International, London. Falco M, Fossati F and Resta F, 1999. On the vortex induced vibration of submarine cables: Design optimization of wrapped cables for controlling vibrations. 3rd International Symposium on Cable Dynamics, Trondheim, Norway. Faltinsen O M, 1990. Sea loads on ships and offshore structures. Cambridge University Press. Fenton J D, 1979. A high-‐order cnoidal wave theory. J. Fluid Mech. 94, 129-‐161. Fenton J D, 1985. A fifth-‐order Stokes theory for steady waves. J. Waterway, Port, Coastal & Ocean Eng. ASCE. 111, 216-‐234. Fenton J D, 1990. Non-‐linear wave theories. Chapter in "The Sea Ȃ Volume 9: Ocean Engineering Science", edited by B. Le MeHaute and D. M. Hanes. Wiley: New York. 3-‐25. Fenton J D, 1995. Personal communication Ȃ pre-‐print of chapter in forthcoming book on cnoidal wave theory. Gregory R W and Paidoussis M P, 1996. Unstable oscillation of tubular cantilevers conveying fluid: Part 1:Theory. Proc. R. Soc.293 Series A, 512-‐527. Hartnup G C, Airey R G and Fraser J M, 1987. Model Basin Testing of Flexible Marine Risers. OMAE Houston. Hoerner S F 1965. Fluid Dynamic Drag, Published by the author at Hoerner Fluid Dynamics, NJ 08723, USA. Huse E, 1993. Interaction in Deep-‐Sea Riser Arrays. OTC 7237, 1993. Isherwood R M, 1987. A Revised Parameterisation of the JONSWAP Spectrum. Applied Ocean Research, 9, No. 1 (January), 47-‐50. Iwan W D, 1981. The vortex-‐induced oscillation of non-‐uniform structural systems. Journal of Sound and Vibration, 79, 291-‐301. Iwan W D and Blevins R D, 1974. A Model for Vortex Induced Oscillation of Structures. Journal of Applied Mechanics, September 1974, 581-‐586. Kotik J and Mangulis V, 1962. On the Kramers-‐Kronig relations for ship motions. Int. Shipbuilding Progress, 9, No. 97, 361-‐368. Larsen C M, 1991. Flexible Riser Analysis Ȃ Comparison of Results from Computer Programs. Marine Structures, Elsevier Applied Science. Longuet-‐Higgins M S, 1983. On the joint distribution of wave periods and amplitudes in a random wave field. Proceedings Royal Society London, Series A, Mathematical and Physical Sciences.389, 241-‐258. Maddox S J, 1998. Fatigue strength of welded structures. Woodhead Publishing Ltd, ISBN 1 85573 013 8. Morison J R, O'Brien M D, Johnson J W, and Schaaf S A, 1950. The force exerted by surface waves on piles. Petrol Trans AIME. 189. Mueller H F, 1968. Hydrodynamic forces and moments of streamlined bodies of revolution at large incidence. Schiffstechnik. 15, 99-‐104. Newman J N. 1974. Second-‐order, slowly-‐varying forces on vessels in irregular waves. Proc Int Symp Dynamics of Marine Vehicles and Structures in Waves, Ed. Bishop RED and Price WG, Mech Eng Publications Ltd, London. Newman J N, 1977. Marine Hydrodynamics, MIT Press.
17
w
Introduction, References and Links
NDP, 1995. Regulations relating to loadbearing structures in the petroleum activities. Norwegian Petroleum Directorate. Ochi M K and Hubble E N, 1976. Six-‐parameter wave spectra, Proc 15th Coastal Engineering Conference, 301-‐328. Ochi M K, 1973. On Prediction of Extreme Values, J. Ship Research, 17, No. 1, 29-‐37. Ochi M K, 1998. Ocean Waves: The Stochastic Approach, Cambridge University Press. Oil Companies International Marine Forum, 1994. Prediction of Wind and Current Loads on VLCCs, 2nd edition, Witherby & Co., London. Paidoussis M P, 1970. Dynamics of tubular cantilevers conveying fluid. J. Mechanical Engineering Science, 12, No 2, 85-‐103. Paidoussis M P and Deksnis E B, 1970. Articulated models of cantilevers conveying fluid: The study of a paradox. J. Mechanical Engineering Science, 12, No 4, 288-‐300. Paidoussis M P and Lathier B E, 1976. Dynamics of Timoshenko beams conveying fluid. J. Mechanical Engineering Science, 18, No 4, 210-‐220. Palmer A C and Baldry J A S, 1974. Lateral buckling of axially constrained pipes. J. Petroleum Technology, Nov 1974, 1283-‐1284. Pode L, 1951. Tables for Computing the Equilibrium Configuration of a Flexible Cable in a Uniform Stream. DTMB Report. 687. Principles of Naval Architecture. Revised edition, edited by J P Comstock, 1967. Society of Naval Architects and Marine Engineers, New York. Puech A, 1984. The Use of Anchors in Offshore Petroleum Operations. Editions Technique. Randolph M and Quiggin P, 2009. Non-‐linear hysteretic seabed model for catenary pipeline contact. OMAE paper 79259, 2009 (www.orcina.com/Resources/Papers/OMAE2009-‐79259.pdf). Rawson and Tupper, 1984. Basic Ship Theory 3rd ed, 2: Ship Dynamics and Design, 482. Longman Scientific & Technical (Harlow). Rienecker M M and Fenton J D, 1981. A Fourier approximation method for steady water waves. J. Fluid Mech.104, 119-‐137. Roark R J, 1965. Formulas for Stress and Strain. 4th edition McGraw-‐Hill. Sarpkaya T, Shoaff R L, 1979. Inviscid Model of Two-‐Dimensional Vortex Shedding by a Circular Cylinder. Article No. 79-‐0281R, AIAA Journal,17, no. 11, 1193-‐1200. Sarpkaya T, Shoaff R L, 1979. A discrete-‐vortex analysis of flow about stationary and transversely oscillating circular cylinders. Report no. NPS-‐69SL79011, Naval Postgraduate School, Monterey, California. Rychlik I, 1987. A new definition of the rainflow cycle counting method. Int. J. Fatigue 9, No 2, 119-‐121. Skjelbreia L, Hendrickson J, 1961. Fifth order gravity wave theory. Proc. 7th Conf. Coastal Eng. 184-‐196. Sobey R J, Goodwin P, Thieke R J and Westberg R J, 1987. Wave theories. J. Waterway, Port, Coastal & Ocean Eng. ASCE 113, 565-‐587. Sparks C, 1980. Le comportement mecanique des risers influence des principaux parametres. Revue de l'Institut Francais du Petrol, 35, no. 5, 811. Sparks C, 1983. Comportement mecanique des tuyaux influence de la traction, de la pression et du poids lineique : Application aux risers. Revue de l'Institut Francais du Petrol 38, no. 4, 481. Standing RG, Brendling WJ, Wilson D, 1987. Recent Developments in the Analysis of Wave Drift Forces, Low-‐ Frequency Damping and Response. OTC paper 5456, 1987. Tan Z, Quiggin P, Sheldrake T, 2007. Time domain simulation of the 3D bending hysteresis behaviour of an unbonded flexible riser. OMAE paper 29315, 2007 (www.orcina.com/Resources/Papers/OMAE2007-‐29315.pdf). Taylor R and Valent P, 1984. Design Guide for Drag Embedment Anchors, Naval Civil Engineering Laboratory (USA), TN No N-‐1688. Torsethaugen K and Haver S, 2004. Simplified double peak spectral model for ocean waves, Paper No. 2004-‐JSC-‐193, ISOPE 2004 Touson, France.
18
w
Introduction, References and Links
Thwaites, 1960. Incompressible Aerodynamics, Oxford, 399-‐401. Timoshenko S,1955. Vibration Problems in Engineering, van Nostrand. Triantafyllou M S, Yue D K P and Tein D Y S, 1994. Damping of moored floating structures. OTC 7489, Houston, 215-‐ 224. Tucker et al, 1984. Applied Ocean Research, 6, No 2. Tucker M J, 1991. Waves in Ocean Engineering. Ellis Horwood Ltd. (Chichester). Wichers J E W, 1979. Slowly oscillating mooring forces in single point mooring systems. BOSS79 (Second International Conference on Behaviour of Offshore Structures). Wichers J E W, 1988. A Simulation Model for a Single Point Moored Tanker. Delft University Thesis. Wu M, Saint-‐Marcoux J-‐F, Blevins R D, Quiggin P P, 2008. Paper No. ISOPE-‐2008-‐MWU10. ISOPE Conference 2008, Vancouver, Canada. (www.orcina.com/Resources/Papers/ISOPE2008-‐MWU-‐10.pdf) Young A D, 1989. Boundary Layers. BSP Professional Books, 87-‐91. Suppliers of frequency domain VIV software SHEAR7
SBM Atlantia 1255 Enclave Parkway, Suite 1200 Houston, TX 77077, USA Attention: Dr. S. Leverette Email: [email protected] Tel: +1 281 899 4300 Fax: +1 281 899 4307 VIVA
JD Marine 11777 Katy Freeway, Suite 434 South Houston, TX 77079, USA Phone: +1 281 531 0888 Fax: +1 281 531 5888 Email: [email protected]
19
w
Tutorial, Getting Started
2
TUTORIAL
2.1
GETTING STARTED
This short tutorial gives you a very quick run through the model building and results presentation features of OrcaFlex. On completion of the tutorial we suggest that you also look through the pre-‐run examples Ȃ see Example Files. On starting up OrcaFlex, you are presented with a 3D view showing just a blue line representing the sea surface and a brown line representing the seabed. At the top of the screen are menus, a tool bar and a status bar arranged in the manner common to most Windows software. As usual in Windows software, nearly all actions can be done in several ways: here, to avoid confusion, we will usually only refer to one way of doing the action we want, generally using the mouse.
Figure:
2.2
The OrcaFlex main window
BUILDING A SIMPLE SYSTEM
To start with, we will build a simple system consisting of one line and one vessel only. Using the mouse, click on the new vessel button on the toolbar. The cursor changes from the usual pointer to a crosshair cursor to show that you have now selected a new object and OrcaFlex is waiting for you to decide where to place it. Place the cursor anywhere on the screen and click the mouse button. A "ship" shape appears on screen, positioned at the sea surface, and the cursor reverts to the pointer shape. To select the vessel, move the cursor close to the vessel and click the mouse button Ȃ the message box (near the top of the 3D view) will confirm when the vessel has been selected. Now press and hold down the mouse button and move the mouse around. The vessel follows the mouse horizontally, but remains at the sea surface. (To alter vessel vertical position, or other details, select the vessel with the mouse, then double click to open the Vessel data window.)
2.3
ADDING A LINE
Now add a line. Using the mouse, click on the new line button . The crosshair cursor reappears Ȃ move the mouse to a point just to the right of the vessel and click. The line appears as a catenary loop at the mouse position. Move the mouse to a point close to the left hand end of the line, press and hold down the mouse button and move the mouse around. The end of the line moves around following t he mouse, and the line is redrawn at each position. Release the mouse button, move to the right hand end, click and drag. This time the right hand end of the line is dragged around. In this way, you can put the ends of the lines roughly where you want them. (Final positioning to exact locations has to be done by typing in the appropriate numbers Ȃ select the line with the mouse and double click to bring up the line data form.) Move the line ends until the left hand end of the line is close to the bow of the ship, the right hand end lies above the water and the line hangs down into the water.
21
w
Tutorial, Adjusting the View
At this point, the line has a default set of properties and both ends are at fixed positions relative to the Global origin. For the moment we will leave the line properties (length, mass, etc.) at their default values, but we will connect the left hand end to the ship. Do this as follows: 1.
Click on the line near the left hand end, to select that end of the line; make sure you have selected the line, not the vessel or the sea. The message box at the left hand end of the status bar tells you what is currently selected. If you have selected the wrong thing, try again. (Note that you don't have to click at the end of the line in order to select it Ȃ anywhere in the left hand half of the line will select the left hand end. As a rule, it is better to choose a point well away from any other object when selecting something with the mouse.)
2.
Release the mouse and move it to the vessel, hold down the CTRL key and click. The message box will confirm the connection and, to indicate the connection, the triangle at the end of the line will now be the same colour as the vessel.
Now select the vessel again and drag it around with the mouse. The left hand end of the line now moves with the vessel. Leave the vessel positioned roughly as before with the line in a slack catenary.
2.4
ADJUSTING THE VIEW
The default view of the system is an elevation of the global X-‐Z plane Ȃ you are looking horizontally along the positive Y axis. The view direction (the direction you are looking) is shown in the Window Title bar in azimuth/elevation form (azimuth=270; elevation=0). You can move your view point up, down, right or left, and you can zoom in or out, using the view control buttons near the top left corner of the window. Click on each of the top 3 buttons in turn: then click again with the SHIFT key held down. The SHIFT key reverses the action of the button. If you want to move the view centre without rotating, use the scroll bars at the bottom and right edges of the window. By judicious use of the buttons and scroll bars you should be able to find any view you like. Alternatively, you can alter the view with the mouse. Hold down the ALT key and left mouse button and drag. A rectangle on screen shows the area which will be zoomed to fill the window when the mouse button is released. SHIFT+ALT+left mouse button zooms out Ȃ the existing view shrinks to fit in the rectangle. Warning:
OrcaFlex will allow you to look up at the model from underneath, effectively from under the seabed! Because the view is isometric and all lines are visible, it is not always apparent that this has occurred. When this has happened, the elevation angle is shown as negative in the title bar.
There are three shortcut keys which are particularly useful for controlling the view. For example CTRL+P gives a plan view from above; CTRL+E gives an elevation; CTRL+Q rotates the view through 90° about the vertical axis. ( CTRL+P and CTRL+E leave the view azimuth unchanged.) Now click the button on the 3D View to bring up the Edit View Parameters form. This gives a more precise way of controlling the view and is particularly useful if you want to arrange exactly the same view of 2 different models Ȃ say 2 alternative configurations for a particular riser system. Edit the view parameters if you wish by positioning the cursor in the appropriate box and editing as required. If you should accidentally lose the model completely from view (perhaps by zooming in too close, or moving the view centre too far) there are a number of ways of retrieving it: x
Press CTRL+T or right click in the view window and select Reset to Default View.
x
Press the Reset button on the Edit View Parameters form. This also resets back to the default view.
x
Zoom out repeatedly until the model reappears.
x
Close the 3D View and add a new one (use the Window|Add 3D View menu item). The new window will have the default view centre and view size.
2.5
STATIC ANALYSIS Note:
If you are running the demonstration version of OrcaFlex then this facility is not available.
To run a static analysis of the system, click on the calculate statics button . The message box reports which line is being analysed and how many iterations have occurred. When the analysis is finished (almost instantly for this simple system) the Program State message in the centre of the Status Bar changes to read "Statics Complete", and the Static Analysis button changes to light grey to indicate that this command is no longer available. The appearance of the line will have changed a little. When editing the model, OrcaFlex uses a quick approximation to a catenary
22
w
Tutorial, Dynamic Analysis
shape for general guidance only, and this shape is replaced with the true catenary shape when static analysis has been carried out. (See Static Analysis for more details). We can now examine the results of the static analysis by clicking on the Results button Selection window.
. This opens a Results
You are offered the following choices: x
Results in numerical and graphical form, with various further choices which determine what the table or graph will contain.
x
Results for all objects or one selected object.
Ignore the graph options for the moment, select Summary Results and All Objects, then click Table. A summary of the static analysis results is then displayed in spreadsheet form. Results for different objects are presented in different sheets. To view more static analysis results repeat this process: click on the Results button and select as before.
2.6
DYNAMIC ANALYSIS
We are now ready to run the simulation. If you are running the demonstration version of OrcaFlex then you cannot do this, but instead you can load up the results of a pre-‐run simulation Ȃ see Examples. Click the Run Dynamic Simulation button . As the simulation progresses, the status bar reports current simulation time and expected (real) time to finish the analysis, and the 3D view shows the motions of the system as the wave passes through. Click the Start Replay button . An animated replay of the simulation is shown in the 3D view window. Use the view control keys and mouse as before to change the view. The default Replay Period is Whole Simulation. This means that you see the simulation start from still water, the wave building and with it the motions of the system. Simulation time is shown in the Status bar, top left. Negative time means the wave is still building up from still water to full amplitude. At the end of the simulation the replay begins again. The replay consists of a series of "frames" at equal intervals of time. Just as you can "zoom" in and out in space for a closer view, so OrcaFlex lets you "zoom" in and out in time. Click on the Replay Parameters button , edit Interval to 0.5s and click OK. The animated replay is now much jerkier than before because fewer frames are being shown. Now click again on Replay Parameters, set Replay Period to Latest Wave and click on the Continuous box to deselect. The replay period shown is at the end of the simulation and has duration of a single wave period. At the end of the wave period the replay pauses, then begins again. Now click on the Replay Step button to pause the replay. Clicking repeatedly on this button steps through the replay one frame at a time Ȃ a very useful facility for examining a particular part of the motion in detail. Click with the SHIFT key held down to step backwards. You can then restart the animation by clicking on 'Start Replay' as before. To slow down or speed up the replay, click on Replay Parameters and adjust the speed. Alternatively use the shortcuts CTRL+F and SHIFT+CTRL+F to make the replay faster or slower respectively. To exit from replay mode click on the Stop Replay button
2.7
.
MULTIPLE VIEWS
You can add another view of the system if you wish by clicking on the View button . Click again to add a third view, etc. Each view can be manipulated independently to give, say, simultaneous plan and elevation views. To make all views replay together, click on Replay Control and check the All Views box. To remove an unwanted view simply close its view window. To rearrange the screen and make best use of the space, click Window and choose Tile Vertical (F4) or Tile Horizontal (SHIFT+F4). Alternatively, you can minimise windows so that they appear as small icons on the background, or you can re-‐size them or move them around manually with the mouse. These are standard Windows operations which may be useful if you want to tidy up the screen without having to close a window down completely.
23
w
Tutorial, Looking at Results
2.8
LOOKING AT RESULTS
Now click on the Results button
. This opens a Results Selection window.
You are offered the following choices: x
Results as Tables or Graphs, with various further choices which determine what the table or graph will contain.
x
Results for all objects or one selected object.
Select Time History for any line, then select Effective Tension at End A and click the Graph button. The graph appears in a new window. You can call up time histories of a wide range of parameters for most objects. For lines, you can also call up Range Graphs of effective tension, curvature, bend moment and many other variables. These show maximum, mean and minimum values of the variable plotted against position along the line. Detailed numerical results are available by selecting Summary Results, Full Results, Statistics and Linked Statistics. Time history and range graph results are also available in numerical form Ȃ select the variable you want and press the Values button. The results can be exported as Excel compatible spreadsheets for further processing as required. Further numerical results are available in tabular form by selecting Summary Results, Full Results, Statistics and Linked Statistics. Results Post-‐Processing
Extra post-‐processing facilities are available through Excel spreadsheets.
2.9
GETTING OUTPUT
You can get printed copies of data, results tables, system views and results graphs by means of the File | Print menu, or by clicking Print on the pop-‐up menu. Output can also be transferred into a word processor or other application, either using copy+paste via the clipboard or else export/import via a file. Note:
2.10
Printing and export facilities are not available in the demonstration version of OrcaFlex.
INPUT DATA
Take a look through the input data forms. Start by resetting the program: click on the Reset button . This returns OrcaFlex to the reset state, in which you can edit the data freely. (While a simulation is active you can only edit certain non-‐critical items, such as the colours used for drawing.) Now click on the Model Browser button
. This displays the data structure in tree form in the Model Browser.
Select an item and double click with the mouse to bring up the data form. Many of the data items are self explanatory. For details of a data item, select the item with the mouse and press the F1 key. Alternatively use the question mark Help icon in the top right corner of the form. Have a look around all the object data forms available to get an idea of the capabilities of OrcaFlex. End of Tutorial We hope you have found this tutorial useful. To familiarise yourself with OrcaFlex, try building and running models of a number of different systems. The manual also includes a range of examples which expand on particular points of interest or difficulty. Finally, please remember that we at Orcina are on call to handle your questions if you are stuck.
24
w
User Interface, Introduction
3
USER INTERFACE
3.1
INTRODUCTION
3.1.1
Program Windows
OrcaFlex is based upon a main window that contains the Menus, a Tool Bar, a Status Bar and usually at least one 3D view. The window caption shows the program version and the file name for the current model.
Figure:
The OrcaFlex main window
Within this main window, any number of child windows can be placed which may be: 3D View Windows
showing 3D pictorial views of the model
Graph Windows
showing results in graphical form
Spreadsheet Windows
showing results in numerical form
Text Windows
reporting status
Additional temporary windows are popped up, such as Data Forms for each object in the model (allowing data to be viewed and modified) and dialogue windows (used to specify details for program actions such as loading and saving files). While one of these temporary windows is present you can only work inside that window Ȃ you must dismiss the temporary window before you can use other windows, the menus or toolbar. The actions that you can perform at any time depend on the current Model State. Arranging Windows 3D View, Graph, Spreadsheet and Text Windows may be tiled so that they sit side-‐by-‐side, but they must remain within the bounds of the main window. The program rearranges the windows every time a new window is created.
3.1.2
The Model
OrcaFlex works by building a mathematical computer model of your system. This model consists of a number of objects that represent the parts of the system Ȃ e.g. vessels, buoys, lines etc. Each object has a name, which can be any length. Object names are not case-‐sensitive, so Riser, riser and RISER would all refer to the same object. This behaviour is the same as for Windows file names. The model always has two standard objects: x
General contains general data, such as title, units etc.
x
Environment represents the sea, seabed, waves, current etc.
You can then use the Model Browser or the toolbar to add other objects to represent the parts of your system. There is no limit, other than the capacity of your computer, to the number of objects you can add to the model. At any time, you can save your model to a data file.
25
w
User Interface, Introduction
3.1.3
Model States
OrcaFlex builds and analyses a mathematical model of the system being analysed, the model being built up from a series of interconnected objects, such as Lines, Vessels and Buoys. For more details see Modelling and Analysis. OrcaFlex works on the model by moving through a sequence of states, the current state being shown on the status bar. The following diagram shows the sequence of states used and the actions, results etc. available in each state.
RESET Calculate Static Position Reset
Calculating Statics
Edit or Reset
STATICS COMPLETE Reset Run Pause SIMULATION UNSTABLE
Simulating
SIMULATION Reset PAUSED
Run Extend Simulation SIMULATION COMPLETE
Reset
Figure:
Model States
The states used are as follows: Reset
The state in which OrcaFlex starts. In Reset state you can freely change the model and edit the data. No results are available. Calculating Statics
OrcaFlex is calculating the statics position of the model. You can abort the calculation by CLICKING the Reset button. Statics Complete
The statics calculation is complete and the static position results are available. You are allowed to make changes to the model when in this state but if you make any changes (except for very minor changes like colours used) then the model will be automatically reset and the statics results will be lost. Simulating
The dynamic simulation is running. The results of the simulation so far are available and you can examine the model data, but only make minor changes (e.g. colours used). You cannot store the simulation to a file while simulating Ȃ you must pause the simulation first.
26
w
User Interface, Introduction
Simulation Paused
There is a simulation active, but it is paused. The results so far are available and you can examine the model data. You can also store the part-‐run simulation to a file. Simulation Complete
The simulation is complete. The simulation results are available and you can store the results to a simulation f ile for later examination. You must reset the model, by CLICKING on the Reset button, before significant changes to the model can be made. You can use the Extend Dynamic Simulation facility if you wish to simulate for a further period of time. Simulation Unstable
The simulation has become unstable. The simulation results are available and you can store the results to a simulation file for later examination. This allows you to try and understand why the simulation has become unstable. You may also want to examine the results up until the point at which the simulation became unstable. However, please treat these results with caution Ȃ because the simulation eventually went unstable this indicates that the dynamic simulation may not have converged at earlier simulation times. You must reset the model, by CLICKING on the Reset button, before significant changes to the model can be made. Typical model state flow
To illustrate how model states work, here is an example of a typical working pattern: 1.
In Reset state, open a new model from a data file or use the current model as the starting point for a new model.
2.
In Reset state, add or remove objects and edit the model data as required for the new model. It is generally best to use a very simple model in the early stages of design and only add more features when the simple model is satisfactory.
3.
Run a static analysis (to get to Statics Complete state) and examine the static position results. Make any corrections to the model that are needed Ȃ this will automatically reset the model. Steps (2) and (3) are repeated as required.
4.
Run a simulation and monitor the results during the simulation (in Simulating state).
5.
If further changes to the model are needed then Reset the model and edit the model accordingly. Steps (2) to (5) are repeated as required.
6.
Finalise the model, perhaps improving the discretisation (for example by reducing the time step sizes or increasing the number of segments used for Lines). Run a final complete simulation (to reach Simulation Complete state) and generate reports using the results.
3.1.4
Toolbar
The toolbar holds a variety of buttons that provide quick access to the most frequently used menu items. The selection of buttons available varies with the current Program State. Button Action
Equivalent Menu Item
Open
File | Open
Save
File | Save
Model Browser
Model | Model Browser
New Vessel
Model | New Vessel
New Line
Model | New Line
New 6D Buoy
Model | New 6D Buoy
New 3D Buoy
Model | New 3D Buoy
New Winch
Model | New Winch
New Link
Model | New Link
27
w
User Interface, Introduction
Button Action
3.1.5
Equivalent Menu Item
New Shape
Model | New Shape
Calculate Statics
Calculation | Single Statics
Run Simulation
Calculation | Run Dynamic Simulation
Pause Simulation
Calculation | Pause Dynamic Simulation
Reset
Calculation | Reset
Start Replay
Replay | Start Replay
Stop Replay
Replay | Stop Replay
Step Replay Forwards
Replay | Step Replay Forwards
Edit Replay Parameters
Replay | Edit Replay Parameters
Add New 3D View
Window | Add 3D View
Examine Results
Results | Select Results
Help Contents and Index
Help | OrcaFlex Help
Status Bar
The Status Bar is divided into three fields: The Message Box
This is at the left hand end. It shows information about the progress of the current action, such as the name of the currently selected object, or the current iteration number or simulation time. Error messages are also shown here. When a statics calculation is done messages showing the progress of the calculation are shown in the message box. To see all the messages from the statics calculation CLICK on the message box Ȃ the Statics Progress Window will then be opened. The Program State Indicator
In the centre and shows which state the program is in (see Model States). The Information Box
This is on the right. It shows additional information, including: x
The global coordinates of the position of the cursor, in the current view plane.
x
Distances when using the measuring tape tool.
3.1.6
Mouse and Keyboard Actions
As well as the standard Windows mouse operations such as selection and dragging OrcaFlex uses some specialised actions. Clicking the right mouse button over a 3D View, Graph or Text Window displays a pop-‐up menu of frequently used actions, such as Copy, Paste, Export etc. For wire frame 3D Views and Graph Windows the mouse can be used for zooming. Simply hold the ALT key down and using the left mouse button, drag a box over the region you want to view. All of the menu items can be selected from the keyboard by pressing ALT followed by the underlined letters. Example:
To exit from the program (menu: File | Exit) press ALT+F then X, or ALT then F then X
A number of frequently used menu items may also be accessed by shortcut keys, such as CTRL+R to start a replay. See the tables below. The shortcut keys are also displayed on the OrcaFlex menus. We suggest that as you become more familiar with the operation of OrcaFlex that you memorise some of the shortcut keys for actions that you use frequently.
28
w
User Interface, Introduction
Keys on Main Window
New model
CTRL+N
Open file
CTRL+O
Save file
CTRL+S
Open data
SHIFT+CTRL+O
Save data
SHIFT+CTRL+S
Help
F1
Print
F7
Show / hide Model Browser
F6
Switch between Model Browser and Main Window
SHIFT+F6
Calculate static position
F9
Run dynamic simulation
F10
Pause dynamic simulation
F11
Reset
F12
Open results selection form
F5
Go to next window
CTRL+F6
Go to previous window
SHIFT+CTRL+F6
Tile windows vertically
F4
Tile windows horizontally
SHIFT+F4
Close selected window
CTRL+F4
Close program
ALT+F4
Keys on Model Browser
Edit data
Enter
Rename object
F2
Switch to Main Window
SHIFT+F6
Locate
F3
Move selected objects
CTRL+M
Hide
CTRL+H
Show
CTRL+S
Hide all objects
SHIFT+CTRL+H
Show all objects
SHIFT+CTRL+S
View by Groups
SHIFT+CTRL+G
View by Types
SHIFT+CTRL+T
Lock / Unlock objects
CTRL+L
Cut
CTRL+X
Copy
CTRL+C
Paste
CTRL+V
Delete
DELETE
Close browser
ESC
Keys on Data Forms
Help
F1
Go to next data form
F6
Go to previous data form
SHIFT+F6
29
w
User Interface, Introduction
Display batch script names for currently selected data item or table.
F7
Display Properties Report
ALT+ENTER
Show connections report
F8
Copy form
F9
Export form
F10
Print form
CTRL+P
Open calculator
F12
Data Selection Keys
Go to next data item or table
TAB
Go to previous data item or table
SHIFT+TAB
Go to data item or table labelled with underlined letter
ALT+LETTER
Move around within a table
ĸĺĹĻ
Select multiple cells in table
SHIFT + ĸĺĹĻ SHIFT+HOME SHIFT+END
Go to first or last column in table
HOME END
Go up or down table several rows at a time
PGUP PGDN
Data Editing Keys
Enter new value for selected cell Edit current value of selected cell
Type new value F2
Open drop-‐down list
ALT + ĹĻ
Move around within new data value being entered
ĸĺHOME END
Accept edit
RETURN
Accept edit and go to adjacent cell in table
ĹĻ
Cancel edit
ESC
Cut selected cell(s) to clipboard
CTRL+X
Copy selected cell(s) to clipboard
CTRL+C
Paste from clipboard
CTRL+V
Fill selection from top (copy top cell down)
CTRL+D
Fill selection from left (copy leftmost cell to right)
CTRL+R
Fill selection from bottom (copy bottom cell up)
CTRL+U SHIFT+CTRL+D
Fill selection from right (copy rightmost cell to left)
CTRL+L SHIFT+CTRL+R
Insert new rows in table
INSERT
Delete selected rows from table
DELETE
3D View Control Keys
Elevation view
CTRL+E
Plan view
CTRL+P
Rotate viewpoint up (increment view elevation angle)
CTRL+ALT+Ĺ
Rotate viewpoint down (decrement view elevation angle)
CTRL+ALT+Ļ
Rotate viewpoint right (increment view azimuth angle)
CTRL+ALT+ĺ
Rotate viewpoint left (decrement view azimuth angle)
CTRL+ALT+ĸ
30
w
User Interface, OrcaFlex Model Files
Rotate viewpoint +90°
CTRL+Q
Rotate viewpoint -‐90°
SHIFT+CTRL+Q
Zoom In
CTRL+I
Zoom Out
SHIFT+CTRL+I
Move view centre Ȃ fine adjustment
ĸĺĹĻ
Move view centre Ȃ coarse adjustment
CTRL + ĸĺĹĻ
Edit view parameters for current 3D view
CTRL+W
Reset to default view
CTRL+T
Set as default view
SHIFT+CTRL+T
Show entire model
CTRL+ALT+T
3D View Control Keys (for wire frame graphics only)
Show / Hide local axes
CTRL+Y
Show / Hide node axes
CTRL+ALT+Y
Undo most recent drag
CTRL+Z
Lock/Unlock selected object
CTRL+L
Place new object
SPACE or RETURN
Edit selected object
CTRL+F2
Cut selected object to clipboard
CTRL+X
Copy selected object, or view if none selected, to clipboard
CTRL+C
Paste object from clipboard (followed by mouse click or RETURN to position the new object)
CTRL+V
Delete selected object
DELETE
Measuring tape tool
SHIFT+CTRL+drag
Replay Control Keys
Start / Stop replay
CTRL+R
Replay faster
CTRL+F
Replay slower
SHIFT+CTRL+F
Step forwards one frame in the replay and pause
CTRL+A
Step backwards one frame in the replay and pause
CTRL+B
Edit replay parameters
CTRL+D
3.2
ORCAFLEX MODEL FILES
3.2.1
Data Files
OrcaFlex models are saved to either binary data files (.dat) or text data files (.yml). All versions of OrcaFlex can read binary data files. Text data files were only introduced in version 9.3a and so cannot be read by older versions of the program. Binary data files have strong version compatibility features. For example, when OrcaFlex attempts to open a binary data file written by a later version of the program it is able to report informative compatibility warnings. The program is not able to be as helpful and informative when working with text data files across program versions. Whilst we strive to achieve as much compatibility as possible for text data files across program versions, we cannot achieve the same level of compatibility as that for binary data files. Text data files, as written by OrcaFlex, contain only data that is active in the model. For example, if implicit time integration is selected in the model then all data relating to explicit time integration is excluded from the text data file. On the other hand, binary data files contain all data whether or not it is active. The fact that the binary data file
31
w
User Interface, OrcaFlex Model Files
contains inactive data can be very useful and so, in general, we would recommend that model building and development is performed using the binary data file. Text data files can be created without the use of OrcaFlex simply by entering text into a text editor. In general we would not advocate this approach to model building. For very simple systems it may be a practical approach but more complex models are usually much easier to build and inspect using the full capabilities and visualisation strengths of OrcaFlex. On the other hand, text data files can be very effective when making minor changes to existing models. Using text data files for such minor variations of existing models makes it much easier to monitor just what has been changed, for example by using standard text differencing programs. Text data files are highly readable and self-‐documenting which makes them ideal for QA and archival purposes. Another application well suited to the use of text data files is automation.
3.2.2
Text Data Files
Text data files are used to define and represent OrcaFlex models in a human readable and easily editable format. Text data files can be opened and saved by OrcaFlex. A very simple example is shown below: General: StageDuration: - 10.0 - 50.0 Lines: - Name: Line1 Length, TargetSegmentLength: - [60.0, 5.0] - [40.0, 2.0] - [120.0, 10.0]
This example first defines a 10s build-‐up stage followed by stage 1 with 50s duration. Then a Line is created and named "Line1". Finally the section data is specified: three sections are created with varying section lengths and segment lengths. Default values are used for all data which are not specified. Note:
The formatting (colour, bold, italic etc.) in the examples here has been added to aid readability, and is not a feature or requirement of text data files themselves.
YAML file format Text data files use a standard file format called YAML and should be saved with the .yml file extension. The YAML file format was chosen because it is extremely easy to read and write. YAML files are plain text files and so can be edited in any text editor. We have found Notepad++ to be a very effective editor for YAML files. Notepad++ has a tabbed interface for easy editing of multiple files and has code folding and syntax highlighting facilities that work well with YAML files. Note:
YAML files must be saved with the UTF-‐8 character encoding.
More details on the YAML format and Notepad++ can be obtained from the following web sites: x
http://en.wikipedia.org/wiki/YAML Ȃ YAML page on Wikipedia.
x
http://www.yaml.org/ Ȃ Official YAML homepage.
x
http://www.yaml.org/spec/ Ȃ Complete technical specification of YAML.
Elements of a text data file The most basic element of a text data file is the name/value pair: UnitsSystem: SI The name (UnitsSystem) is written first, followed by a colon (:), then a SPACE, and then the value (SI). The names used in text data files are the same as used to identify data items in batch script files. Names and values in YAML files can contain spaces and other punctuation: General: StaticsMethod: Whole System statics Lines:
This example also contains a list. New items in a list are introduced by a dash ( -‐) followed by a SPACE. Items in a list can span more than a single line: Lines: - Name: Riser TopEnd: End B ContentsDensity: 0.8 - Name: Umbilical TopEnd: End A ContentsDensity: 0.0 Outline indentation is used to delimit blocks in a YAML file. This concept, known as significant indentation, is perhaps a little unusual as most data formats and programming languages use symbols to indicate the beginnings and ends of blocks. To understand this better consider the following example: General: UnitsSystem: SI StaticsMethod: Whole System statics Environment: WaterDepth: 80 The two lines immediately following General: which are indented by two spaces, form a single block. This block is ended by Environment: because it is not indented. A second block follows Environment: containing a single name/value pair which defines the water depth. Indentation must be made with SPACE characters rather than TAB characters. It does not matter how many spaces are used so long as the indentation is consistent within each block. However, it is good practice to use the same indentation throughout a file. OrcaFlex itself uses indentation of two spaces when it writes YAML files. Lists are commonly used to represent tables of data: Lines: - Name: Line1 LineType, Length, TargetSegmentLength: - [Line Type1, 60, 5] - [Line Type1, 40, 2] - [Line Type2, 120, 10]
The name LineType, Length, TargetSegmentLength indicates three columns of data, LineType, Length and TargetSegmentLength which are interpreted in that order. The comma (,) character is used as a separator. Note that you do not have to present the data in the same o rder as it appears in OrcaFlex. The following example is equivalent to the previous example: Lines: - Name: Line1 Length, TargetSegmentLength, LineType: - [60, 5, Line Type1] - [40, 2, Line Type1] - [120, 10, Line Type2]
You can, if you wish, omit columns, in which case default values will be used: Lines: - Name: Line1 LineType, Length: - [Line Type1, 60] - [Line Type1, 40] - [Line Type2, 120]
Some data are closely related to each other and can naturally be grouped in a text data file: 3DBuoys: - Name: 3D Buoy1 InitialPosition: [0, 0, 10]
33
w
User Interface, OrcaFlex Model Files
DragArea: [100, 100, 30] Pen: [4, Solid, Yellow]
Without grouping the file would be significantly longer: 3DBuoys: - Name: 3D Buoy1 InitialX: 0 InitialY: 0 InitialZ: 10 DragAreaX: 100 DragAreaY: 100 DragAreaZ: 30 PenWidth: 4 PenStyle: Solid PenColour: Yellow The majority of grouped data are X,Y,Z components and we adopt the convention that these components appear in that order when grouped. YAML files may contain comments which are introduced by a hash (#) character followed by a SPACE. All subsequent text on the same line is comment and is ignored when OrcaFlex reads a text data file. Comments are not preserved by OrcaFlex and any user comments in a manually edited YAML file opened with OrcaFlex will be lost if the file is saved. Comments are formatted in green in the following example: General: # Statics StaticsMethod: Whole System statics BuoysIncludedInStatics: Individually Specified # Dynamics StageDuration: - 8 - 16 TargetLogSampleInterval: 0.1 # Integration SimulationIntegrationMethod: Implicit ImplicitConstantTimeStep: 0.1
A text data file can be rather large, particularly if it contains vessel hydrodynamic data. Code folding editors can help somewhat, but even so such files can be awkward to work with. The IncludeFile identifier allows you to move data into a separate file which is then included in the main file: # File: C:\Desktop\main.yml VesselTypes: - Name: FPSO IncludeFile: FPSO.yml Vessels: - Name: Vessel1 VesselType: FPSO The included file contains just the data for the vessel type: # File: C:\Desktop\FPSO.yml Length: 240 RAOResponseUnits: degrees RAOWaveUnit: amplitude WavesReferredToBy: period (s) # ... remainder of large file omitted ... As well as making the main file shorter and more readable, using this approach can offer significant QA benefits. In this example we have used a relative path and so the program will look for FPSO.yml in the same directory as the main text data file. A text data file saved by OrcaFlex contains some extra information: %YAML 1.1
The section between the --- and ... lines is the main body of the file and is known in YAML terminology as a document. Everything else is in fact optional and can be omitted. A YAML file can contain multiple documents, separated by --- lines but OrcaFlex has no special treatment for such multi-‐document files and all data is read into a single OrcaFlex model. The first line (%YAML 1.1) is known as the YAML directive and specifies which version of YAML the file adheres to. The YAML directive can be omitted. The rest of the header contains a number of comments detailing the version of OrcaFlex which created the file, the file name etc. Again, these comments can be omitted. Ordering issues The order in which the data appear in a text data file is very important. OrcaFlex processes the file line by line in the order in which it appears in the file. Any references (e.g. Lines referring to Line Types) must be ordered so that the referenced object appears before any references to it. So Line Types appear before Lines in the file. Similarly Vessels and 3D/6D Buoys appear before Lines, Links, Winches and Shapes so that any connection references (e.g. a Line connected to a Vessel) can be ordered correctly. The other ordering issue relates to inactive data. Data which are not currently available are known as inactive data. For example, data relating to the explicit solver are inactive when the implicit solver is selected. Inactive data cannot be specified in a text data file. This rule has implications for the order in which data are presented in the text data file. Consider the following example: General: InnerTimeStep: 0.01 SimulationIntegrationMethod: Explicit Since the default integration method is the implicit solver the attempt to set the explicit time step (InnerTimeStep) will fail because it is inactive data. The solution is to set the integration method before setting the time step: General: SimulationIntegrationMethod: Explicit InnerTimeStep: 0.01
35
w
User Interface, OrcaFlex Model Files
This principle applies in general Ȃ you should set as soon as possible all data which influences whether other data are active. Automation Text data files can easily be modified and/or generated by computer programs/scripts. This means that the text data file format, combined with a text processing script language (e.g. Python, Perl, Ruby etc.), can form a very effective automation tool. The OrcaFlex Spreadsheet provides a simple, yet effective, facility for automating the production of text data files. Some specialist features have been included in the text data file to aid with automation tasks, as illustrated in the following example: BaseFile: base.dat Riser: ContentsDensity: 0.8 Length[1]: 180 When this text data file is loaded in OrcaFlex the program does the following: 1.
Opens the OrcaFlex binary data file named base.dat, located in the same directory as the text data file.
2.
Sets the contents density for the OrcaFlex Line called "Riser" to 0.8.
3.
Sets the length of the first section of "Riser" to 180.
The BaseFile identifier differs from IncludeFile in that it is able to load either binary or text data files (IncludeFile only works with text data files). In addition BaseFile clears all existing data in the model before loading the contents of the specified file. On the other hand, IncludeFile acts incrementally, starting from whatever state the model is in when the IncludeFile identifier is encountered. Standard text data files typically specify the entire model. The common automation task of making systematic variations to a base case requires the ability to specify an existing object for which data modifications are to be made. This is done using the object's name Ȃ in the example above the Riser: line performs this step. In a similar vein it is a common requirement to modify data for certain items in a list or table without specifying the entire table. The indexing syntax (Length[1] in the example) performs this task. Note that as for batch script files the indices are always 1-‐based. Manually edited text data files Saving a text data file, then editing it is a good way to create a base file for automation, or to discover data names and data structure for an object. However, please be aware that this is a one way process. OrcaFlex reads and interprets a text data file line by line to build the model incrementally, discarding the lines once processed. When saving a file OrcaFlex exports each object, including any default values. Consequently the save process is not the inverse of the load process and any manual modifications to the input file will be overwritten when the file is saved by OrcaFlex. In the short automation example above, if the model created when this file is loaded is saved, the text data file would contain data for all the objects imported by the BaseFile command, the full data for the line Riser and other default data not specified in the input file.
3.2.3
Simulation Files
Results from OrcaFlex calculations (statics or dynamics) are saved to simulation files (.sim). These are binary files containing the following sections: x
The model data. This section is essentially a binary data file.
x
The latest calculated state (positions, loads etc.) of the model. This section allows static state results to be retrieved and also enables partially-‐run dynamic simulations to be continued.
x
The log file which contains results for a dynamic simulation. This section is not present for static state simulation files.
Simulation files can be generated in a number of different ways: x
Interactively from the main OrcaFlex window. After a calculation (statics or dynamics) has performed then a simulation can be saved using the File | Save or File | Save As menu items.
36
w
User Interface, Model Browser
x
From the batch processing form.
x
From Distributed OrcaFlex.
x
From the OrcaFlex programming interface (OrcFxAPI).
Similarly, results can be post-‐processed from simulation files in a number of different ways: x
Interactively from the results form.
x
From the OrcaFlex spreadsheet.
x
From the OrcaFlex programming interface.
3.3
MODEL BROWSER
At any time you can use the Model Browser to see what objects you have in your model. To display the model browser, use the model browser button (F6 to open the model browser).
or the Model | Model Browser menu item or use the keyboard shortcuts
Figure:
Model Browser
The Model Browser consists of a list of all the objects in the model, arranged into categories according to object type. Several symbols are used in the list of objects:
Categories can be opened, to show their contents, or closed, to simplify viewing a complex model.
Objects. Use double click to view or edit the object's data.
Locked. These objects cannot be dragged by the mouse in the 3D View.
37
w
User Interface, Model Browser
You can navigate the list and select the object required by clicking with the mouse, or using the arrow keys and return. If the list is longer than the window then you can either enlarge the window or use the scroll bar. Note:
More than one object can be selected in the model browser. This allows you to perform the same action (e.g. delete, copy, hide, show, locate) on many objects at once. To select more than one object you use the standard Windows key presses CTRL+CLICK to add to a selection and SHIFT+CLICK to extend a selection.
Hint:
If you have all objects in the model browser selected then it can be difficult to de-‐select them. The simplest way is to use CTRL+CLICK to de-‐select one item and then to CLICK that item again to select it alone.
Model Browser Facilities The model browser menus, and its pop-‐up menu, provide the following model management facilities. For details of keyboard shortcuts see Keys on Model Browser. Add
Add a new object to the model. Delete
Delete the selected object from the model. Cut/Copy
Cut or Copy the selected object to the clipboard. Paste
Paste an object from the clipboard into the model. If the object is the Variable Data then all the variable data tables are pasted in, with tables being renamed if necessary to avoid clashing with existing variable data n ames. Note:
You can use Cut/Copy and Paste to transfer objects between two copies of OrcaFlex running on the same machine. You can also use it to transfer objects between two OrcaFlex data files (open the source file and copy the object to the clipboard, t hen open the destination file and paste the object back from the clipboard), but the Library facility (see below) provides an easier way of achieving the same thing.
Move Selected Objects
Opens the Move Selected Objects Wizard. Locate
Finds and highlights the object in any open 3D view windows. This is useful in complex models where many objects are on the 3D view. The highlighting method is determined by the Locate Object Method preference. Edit
Open the object's data form. This action can also be invoked by double-‐clicking an item, or by selecting it and pressing RETURN. Rename
Rename the selected object. You can also rename by single-‐clicking the selected object. Lock/Unlock
Lock or unlock the selected object. Hide/Hide All/Show/Show All
Control whether the objects are drawn on 3D views. Reorder
You can use drag+drop with the mouse to reorder objects in the model. This is useful if you are working on the static position of one particular line Ȃ you can drag it up to the top of the list of lines, so that it will be tackled first when OrcaFlex does the static analysis.
38
w
User Interface, Model Browser
Library
The Library menu facilities allow you to open a second data file. You can then Import objects from that second file into the current model. You can also import using drag+drop with the mouse. For details see Libraries. Notes:
The second data file is referred to as the library model, but in fact it can be any OrcaFlex data file. The library facilities therefore provide an easy way to move objects between different OrcaFlex data files.
If the object being imported is the variable data then all the variable data tables are transferred, with tables being renamed if necessary to avoid clashing with existing variable data names.
Switch to Main Window
The browser's Window menu enables you to switch focus to the main form without closing the browser window. A corresponding command on the main form's Window menu switches focus back.
3.3.1
Model Browser Views
There are 2 ways of viewing objects in the model browser: by Types or by Groups. You can switch between views by clicking on the model browser View | View by Groups/Types menu items, or though the popup menu. Types View
This is the traditional model browser view. The browser has a number of folders containing objects of the same type. For example all the lines are contained in a folder called "Lines". Objects can be reordered within a folder but they cannot be moved to a different folder. To select this view you should click the View | View by Types menu item. Groups View
This view allows you to customise how the objects are arranged in the model browser. You can add any number of browser groups to the browser. These groups are simply folders in the browser tree. Groups can contain any number of objects or other groups. In this way a hierarchical structure for the model can be created. To select this view you should click the View | View by Groups menu item. To add groups you select the Edit | Add Group menu item or use the popup menu. Groups can be renamed in the same way as other objects. Objects can be added to a group by dragging the objects onto the group. Any number of objects can be added to a group in one operation by first selecting the objects and then d ragging them. This multiple selection is performed using the standard Windows key presses CTRL+CLICK to add to a selection and SHIFT+CLICK to extend a selection. Groups can be dragged into other groups and so a hierarchical structure for the model can be created. As well as allowing you the freedom to structure your model however you like, the Groups View allows you to perform the same action (e.g. delete, copy, hide, show, locate) on all objects in a group. The grouping structure is also used when cycling through data forms-‐ clicking the Next button takes you to the next object in the groups view.
3.3.2
Move Selected Objects Wizard
This wizard allows you to move and rotate a number of objects en masse. The wizard is most useful w hen you select multiple objects, a group or a number of groups or even the entire model. To use the wizard you must first open the Model Browser and select the objects which you wish to move. Then click Move Selected Objects on the browser's edit menu (also available from the popup menu). Selecting objects Before using the wizard you must select (in the model browser) the objects which you wish to move. There are a variety of ways in which you can do this. We list a few of the more useful methods below: x
Select a single object.
x
Select multiple objects. You can do this in the model browser using CTRL+CLICK to add to a selection and SHIFT+CLICK to extend a selection.
x
Select an object type folder. This works when the model browser is in Types View mode. For example select the Lines folder if you wish to move all the lines in a model.
39
w
User Interface, Libraries
x
Select a group. This works when the model browser is in Groups View mode. This allows you to move all objects in that group.
x
Select the entire model. This is easiest to do when the model browser is in Groups View mode. The first item in the model browser is titled "Model". Select this item if you wish to move all objects in the model.
There is no limitation to the type of selections you can make. If y ou wish to move 2 groups then select both of them (using CTRL+CLICK) and open the wizard. Note:
If your selection includes an item which contains other objects (e.g. a group or an object type folder) then all objects contained by that item will be moved by the wizard.
Points The wizard shows a list of the points associated with each selected object. For objects like buoys, vessels and shapes a single point is shown. For objects like lines, links and winches with multiple connection points the list shows each connection point for that object. The list also shows the global coordinates of each point. For each point you have the option of including or excluding it in the move operation. This might be useful if you wanted to move only the End A line connection points and leave the End B connection points unchanged, for example. Move specified by There are 4 methods of specifying how the objects are moved. Displacement
For this method you specify a position change (i.e. a displacement) which will be applied to all the points included in the move operation. Polar Displacement
This method is similar to the Displacement method. Here you specify a direction and distance which determine a position change. This is applied to all the points included in the move operation. New Position
Here you give a reference point and its new position. The same displacement is applied to all other points included in the move. Rotation
This method rotates the included points in the horizontal plane. You specify an angle of rotation and a central point about which the rotation is performed. Note that the environment data (e.g. wave and current directions, seabed direction etc.) is not included in the rotation. Moving the objects Once you have decided which objects to include in the move and how the move is specified you are ready to actually move the objects. This is done by clicking the Move button. If you change your mind and decide not to move the objects then simply click the Close button.
3.4
LIBRARIES
An OrcaFlex Library is a collection of OrcaFlex objects (line types, lines, buoys etc.) stored in an ordinary OrcaFlex data file. For example, a library may contain all the standard Line Types that you use regularly. Once such a library file has been built you can quickly build new models using the library Ȃ this gives faster model building and can make QA procedures safer. To open a library file, use the File | Libraries menu or the Library menu on the Model Browser. Note that any OrcaFlex data file can be opened as a library file, and this makes it easy to use the model browser to copy objects from one model to another.
3.4.1
Using Libraries
Libraries allow you to easily import objects from one OrcaFlex model to another. To do this run OrcaFlex and open the model browser by clicking the model browser button F2. The model browser should look like:
40
or the Model | Model Browser menu item, or pressing
w
User Interface, Libraries
Now you open your file as a library. To do this click the open button file. Now the model browser will look like:
on the model browser and select your data
We are now going to copy some objects from the right hand pane to the left hand pane. To do so select the required line types and click the import button . As an alternative to the import button the objects can be dragged from the right hand pane to the left hand pane or the Library | Import menu item can be used.
41
w
User Interface, Libraries
Note that you can select a number of objects and import them all in one go. You do this by using the standard Windows key presses CTRL+CLICK to add to a selection and SHIFT+CLICK to extend a selection. If you do this the library will look like:
Once you have imported the required objects you can close the library by selecting the Library | Close menu item on the model browser. Now the model browser looks like:
42
w
User Interface, Menus
Here are some other points about using library files: x
Because library files are simply ordinary OrcaFlex data files, you can temporarily treat any OrcaFlex data file as a library. This allows you to import objects from one OrcaFlex data file to another.
x
You can re-‐size the model browser by dragging its border. You can also control the relative sizes of its two panes, by dragging the right border of the left pane.
x
You can view, but not edit, the data for a library model object, by double clicking it in the Model Browser or by selecting it and using the pop-‐up menu.
x
When an object is imported from a library, the current model may already have an object of that name. In this case OrcaFlex automatically gives the object a new name based on the old name.
3.4.2
Building a Library
A library file is simply an OrcaFlex data file Ȃ you can use any OrcaFlex data file as a library. In practice it is most convenient to put your commonly used OrcaFlex objects into files designated as OrcaFlex library files. You build a library file in the same way as you build a standard OrcaFlex data file. Starting with a blank model you can add objects in the usual way and set their data. Typically, however, you would want to reuse objects that had previously been created and used for a project. To do this you would open the model browser and load your project data file as a library using the open button on the model browser. Then you import the required objects as described in Using Libraries. This procedure can be repeated with a number of different data files until you have all the objects you wish to keep in the library. Then you should close the model browser and save the data file by clicking the data file can now be used as a library.
button on the main OrcaFlex form. This
Notes:
Because they are OrcaFlex models, libraries contain General and Environment data, but these would not usually be used, except perhaps for the General data Comment field, which can act as a title for the library.
Because the library file is just an ordinary OrcaFlex data file, it can also be opened using File | Open. This allows you to edit the data of the objects in the library.
You can set up as many library files as you wish. For example you might have separate libraries for Line Types, Attachment Types, Vessel Types, Variable Data Sources etc., or you may choose to use just one library for everything. The model browser's Library menu contains a list of the most recently used libraries.
43
w
User Interface, Menus
3.5
MENUS
OrcaFlex has the following menus: x
The File menu has the file opening and saving commands, plus commands for printing or exporting data or results and managing libraries.
x
The Edit menu has data and object editing facilities.
x
The Model menu gives access to the model building facilities.
x
The Calculation menu provides commands for starting and stopping analyses, including batch processing.
x
The View menu provides view control.
x
The Replay menu provides replay control.
x
The Graph menu gives you access to facilities related to the currently active graph window.
x
The Results menu leads to the results facilities.
x
The Tools menu allows you adjust preferences and to lock or unlock objects.
x
The Workspace menu allows you to save and restore collections of view, graph and spreadsheet windows.
x
The Window menu gives access to the various windows that are available, and allows you to adjust the layout of your windows.
x
The Help menu leads to the various help documentation that is available.
3.5.1
File Menu
New
Deletes all objects from the model and resets data to default values. Open
Open an OrcaFlex file Ȃ either a data file (.dat or .yml) or a simulation file (.sim). You can also open an OrcaFlex file by dragging and dropping it onto the OrcaFlex window. For example if you have Windows Explorer running in one window and OrcaFlex running in another then you can ask OrcaFlex to open a file by simply dragging it from Explorer and dropping it over the OrcaFlex window. If you open a data file then OrcaFlex reads in the data, whereas if you select a simulation file then OrcaFlex reads in both the data and the simulation results. To read just the data from a simulation file, you can use the Open Data menu item. Save
Save an OrcaFlex file Ȃ either a data file (.dat or .yml) or a simulation file (.sim) Ȃ to the currently selected file name. If a file of that name already exists then it is overwritten. If calculation results (either statics or dynamics) are available then a simulation file will be saved. Otherwise a data file will be saved. Note:
You cannot save a dynamic simulation while it is running Ȃ you must pause the simulation first.
Save As
This is the same as Save but allows you to specify the file name to save to. If a file of that name already exists then you are asked whether to overwrite the file. When saving data you can choose either the binary file format (.dat) or the text file format (.yml) from the Save as type drop down list. Open Data
Read the data from an existing data file or simulation file, replacing the existing model. If a simulation file is specified then OrcaFlex reads just the data from it, ignoring the simulation results in the file.
44
w
User Interface, Menus
Save Data
Save the data to the currently selected file name, using extension .dat or .yml. If a file of that name already exists then it is overwritten. Save Data As
This is the same as Save Data but allows you to specify the file name to save to. If a file of that name already exists then you are asked whether to overwrite the file. You can choose either the binary file format (.dat) or the text file format (.yml) from the Save as type drop down list. Compare Data
Compares the data of two OrcaFlex models. See Comparing Data for details. Properties
Displays the system file properties dialog for the current file. This is mainly intended t o make it easier to find the full path for files with long names. Submit to Distributed OrcaFlex
Submit the current file for processing by Distributed OrcaFlex. For this option to be available, either the Distributed OrcaFlex Viewer or Client must also be installed on the machine. Libraries
You can create new libraries of OrcaFlex objects, or open existing libraries. You can then import objects from the library into your existing model, or export objects from your existing model to the library. Export
Display the Export form, allowing you to export Data, 3D Views, Graphs, Spreadsheets or Text Windows. See also Copy. Selected Printer
Allows you to change the selected printer. Printer Setup
Calls up the Printer Setup dialogue window. This standard Windows dialogue is used to select which printer to use, and allows you to control the way that it is used Ȃ the details vary from printer to printer, and depend on the printer manufacturer's device driver currently installed. Please refer to the manuals for your printer as well as the Microsoft documentation. Print
Display the Print form, allowing you to print Data, 3D Views, Graphs, Spreadsheets or Text Windows. See Printing. Most Recent Files
List of the most recently used files. Selecting an item on the list causes the file to be opened. Exit
Close OrcaFlex.
3.5.2
Edit Menu
Undo Drag
Undo the most recent drag. This is useful if you accidentally drag an object. Cut
Copies the current selection to the clipboard and then deletes it.
45
w
User Interface, Menus
Copy
If there is a currently selected object (see Selecting Objects), then that object is copied to the clipboard. You can then use Edit | Paste to create duplicate copies of the object. The data for the object is copied to the clipboard in text form, from where it can be pasted into a word processor document. Note:
After pasting into a word processor, you will probably need to put the text into a fixed space font since much of the data is in tables.
If there is no currently selected object then the currently selected 3D view, text window, graph or spreadsheet is copied to the clipboard. Paste
Insert object from clipboard. This can be used to duplicate an object several times within the model. After selecting Paste, the object is inserted at the next mouse CLICK position in a 3D view. If the current window is a Spreadsheet then the contents of the clipboard are pasted into the spreadsheet. Delete
If the active window is a 3D View then the currently selected object is deleted. Before the object is deleted, any connected objects are disconnected, and any graphs associated with the object are closed. If the active window is a Spreadsheet then the selected cells are cleared. Select All
Selects all the cells in a Spreadsheet. Copy All Data
Copy the whole model to the clipboard. The model data is copied to the clipboard in text form, from where it can be pasted into a word processor document.
3.5.3
Model Menu
Model Browser
Toggles the visibility of the Model Browser. New Vessel New Line New 6D Buoy New 3D Buoy New Winch New Link New Shape
Create new objects. The mouse cursor changes to the New Object symbol . The object is placed at the position of the next mouse CLICK within a 3D View. A three dimensional position is generated by finding the point where the mouse CLICK position falls on a plane normal to the view direction and passing through the View Centre. Vessels are always placed initially at the sea surface. Show Connections Report
Displays a spreadsheet containing information about all object connections in the model.
46
w
User Interface, Menus
Truncate Object Names
Old versions of OrcaFlex (before 7.4b) cannot read files that contain long object names, i.e. longer than 10 characters. This menu item truncates any long object names in the model. You should do this if you wish to send a file to another user whose version of OrcaFlex is older than 7.4b. Delete Unused Types
Deletes any types (e.g. Line Types, Clump Types etc.) that are not in use. This is sometimes useful to simplify a data file, or to find out which types are in use. Delete Unused Variable Data Sources
Deletes any variable data sources that are not in use. This is sometimes useful to simplify a data file, or to find out which variable data sources are in use. Use Calculated Positions
This menu item is available after a successful static iteration or when t he simulation is finished or paused. If the model is in the statics complete state then clicking the menu item sets the initial positions of buoys, vessels and free line ends to be the calculated static positions. This can be desirable when setting up a model, since the positions found are likely to be good estimates for the next statics calculation. If the model is in the simulation paused or stopped state, then clicking the menu item sets the initial positions of buoys and free line ends to be the latest positions in the simulation. This is useful when OrcaFlex statics fails to find an equilibrium configuration. In such cases you can use dynamics with no wave motion to find the static equilibrium position and then click Use Calculated Positions. If a replay is active then clicking the menu item sets the initial positions of buoys and free line ends to be the positions at the latest replay time. Use Specified Starting Shape for Lines
This menu item is an extension of Use Calculated Positions. As well as setting the initial positions of buoys, vessels and free line ends it modifies data for all Lines in the following way: 1.
The Step 1 Statics Method is set to User Specified.
2.
The User Specified Starting Shape data are set to the calculated node positions. As described above these positions are either the results of a static calculation or the results of a dynamic simulation.
Use Static Line End Orientations
This menu item is only available after a successful static analysis. Clicking the menu item sets the line end orientation data, for all line ends in the model that have zero connection stiffness, to the orientations found in the static analysis. This is done as follows. x
For any line end with zero bend connection stiffness, the end azimuth and end declination will be set to the azimuth and declination of the end node, as found by the static analysis.
x
If the line includes torsion and the line end connection twist stiffness is zero, then the end gamma will be set to the gamma of the end node, as found by the static analysis.
This action can be useful if you want to set the line end orientation to that which gives zero end moments when the line is in its static position. To do this first set the end connection stiffness values to zero, then run the static analysis and then click the Use Static Line End Orientations menu item. You can then set the end connection stiffness to their actual values.
3.5.4
Calculation Menu
Single Statics
Start the single statics calculation (see Static Analysis). Progress and any error messages that occur are reported in the Statics Progress Window, which is shown as a minimised window icon. The statics calculation can be interrupted by CLICKING the Reset button.
47
w
User Interface, Menus
Multiple Statics
Starts the multiple offset statics calculation (see Multiple Statics). Progress and any error messages that occur are reported in the Statics Progress Window, which is shown as a minimised window icon. The statics calculation can be interrupted by CLICKING the Reset button. Run Dynamic Simulation
Start a dynamic simulation (see Dynamic Analysis). If necessary, OrcaFlex will automatically do a statics calculation first. During the simulation, the Status Bar shows the current simulation time and an estimate of the time that the simulation will take, and all 3D View windows and Graphs are updated at regular intervals. Pause Dynamic Simulation
Pause the simulation. To save the results of a part-‐run simulation you need to pause it first. The simulation can be restarted by CLICKING the Run button. Extend Dynamic Simulation
This facility is only available when the current simulation is either paused or completed. It adds another stage to the current simulation, without having to reset. You are asked to specify the length of the new stage. You can then continue the simulation, without having to restart it from scratch. This is particularly useful if you have a simulation that has not been run for long enough. Note that data for the new stage, e.g. for winch control and vessel prescribed motion, are initially set to be the same as for the previous stage. However, the data for the new stage can be edited because the new stage has not yet started. Reset
Reset the model, discarding any existing results. The model can then be edited or a new model loaded. View Warnings
Displays a window allowing you to review all warnings displayed by OrcaFlex during a calculation (statics or dynamics). This feature is particularly useful for simulations run in batch mode or by Distributed OrcaFlex. In these circumstances warnings are not displayed since to do so would require user intervention. Line Setup Wizard
Opens the Line Setup Wizard. The wizard is only available when the current simulation is in Reset state. Wave Scatter Conversion
Opens the Wave Scatter Conversion form. This facility converts a scatter table of sea states to a scatter table of regular (i.e. individual) waves. Batch Processing
Run a batch of analyses automatically while the program is unattended. See Batch Processing for details.
3.5.5
View Menu
Change Graphics Mode
Toggles the graphics mode between wire frame and shaded. Edit View Parameters
Adjust the View Parameters for the active 3D View. Rotate Up / Down / Left / Right
Change the view direction, for the active 3D View, by the view rotation increment.
48
w
User Interface, Menus
Plan
Set the active 3D View to a plan view (Elevation = 90°). Elevation
Set the active 3D view to an elevation view (Elevation = 0°). Rotate 90 / Rotate -‐90
Increase (or decrease) the view azimuth by 90°, for the active 3D view. Zoom In / Zoom Out
Click the zoom button to zoom in (decrease view size) or SHIFT+CLICK it to zoom out (increase view size). Reset to Default View
Set the view parameters for the active 3D View to be the default view of the model. Set as Default View
Set the default view of the model to be the view parameters of the active 3D View. Show Entire Model
Set the view parameters for the active 3D View so that the entire model will be displayed. Axes
This submenu gives you control of the 3D View Axes Preferences. Superimpose Times
Allows model configurations for different times of the simulation to be superimposed in 3D Views. See Superimpose Times. Current Position
Draws the model at the latest time Ȃ this action is used to cancel the Superimpose Times view.
3.5.6
Replay Menu
Edit Replay Parameters
Adjust the Replay Parameters, such as the period of simulation to replay, the time interval between frames, the replay speed etc. For more information see Replays. Start / Stop Replay
Starts or stops the replay. Step Replay Forwards, Step Replay Backwards
Step the replay forwards or backwards one frame at a time. Click the button to step forwards; CLICK with SHIFT held down to step backwards. Replay Faster / Slower
Increase or decrease the replay frame rate (replay speed). Export Video
Exports the replay as a video clip in AVI file format. See Replays for more details.
3.5.7
Graph Menu
Use Default Ranges
Sets the graph axes to their original ranges
49
w
User Interface, Menus
Values
Displays a spreadsheet containing the numerical values on which the graph is based. Spectral Density (only available for time history graphs)
Opens a new spectral density graph. Empirical Cumulative Distribution (only available for time history graphs)
Opens a new empirical cumulative distribution graph. Rainflow half-‐cycle Empirical Cumulative Distribution (only available for time history graphs)
Opens a new rainflow half-‐cycle empirical cumulative distribution graph. Properties
Opens the graph properties form (which can also be opened by double clicking the graph).
3.5.8
Results Menu
Select Results
Display the results form which allows you to choose from the currently available selection of graphs and results tables. Graphs such as Time Histories, XY Graphs and Range Graphs may be created before a simulation has been run, thus allowing you to watch the variables during a simulation. Fatigue Analysis
Opens the Fatigue Analysis form. Modal Analysis
Opens the Modal Analysis form. Report Vessel Response
Opens the Vessel Response form.
3.5.9
Tools Menu
Lock / Unlock Selected Object
Locking an object prevents it from being accidentally dragged or connected using the mouse on 3D views, for example if you nudge the mouse slightly while trying to DOUBLE CLICK. Lock / Unlock Selected Object toggles the lock on the currently selected object. If the lock is on, it will be switched off. If the lock is off, then it will be switched on. Locked Objects may still have their positions edited in the data Edit Forms. The status of the object locks is shown by symbols in the Model Browser. Lock / Unlock All Objects
Locks or unlocks all objects in the model. Set Thread Count
Allows you to change the number of execution threads used by OrcaFlex for parallel processing. Preferences
Allows you to control various program settings so that you can customise the program to the way you prefer to work. See Preferences.
3.5.10
Workspace Menu
Open Workspace
Opens a previously saved workspace file and restores the window layout described in that workspace file. Save Workspace
Save the current window layout to a workspace file.
50
w
User Interface, Menus
Make default for this file, Make default for this folder
Makes the current window layout the default workspace for the current simulation file or for the current folder, respectively. The default workspace for a simulation file will be restored whenever you open that file. The default workspace for a folder will be restored whenever you open any simulation file in that folder. If a default workspace exists for a both a file and the folder containing the file, then the default for the file is used. Use file default, Use folder default
Applies the default workspace to the current model. This is useful if you have changed the window layout and wish to restore the default workspace layout without re-‐loading the model. Remove file default, Remove folder default
Deletes the default workspace. Most Recent Files
List of the most recently saved workspaces in the directory which contains the current model. Selecting an item on the list causes the workspace to be loaded.
3.5.11
Window Menu
Add 3D View
Add another 3D View Window. Having multiple views on screen allows you to watch different parts of the system simultaneously, or to see different views at the same time (for example a plan and an elevation). Tile Vertical, Tile Horizontal
Arranges all the windows (3D View, graph or spreadsheet) so that they fill the main window area and fit side by side without overlapping. The program automatically tiles windows every time a new window is created or deleted. Switch to Model Browser
This command, and the corresponding command on the model browser's Window menu, enable you to switch focus between the main form and the model browser window. Statics Progress
Displays the Statics Progress Window. Window List
This is a list of all currently open windows. If a window is hidden under others it can be selected easily from this list.
3.5.12
Help Menu
OrcaFlex Help
Opens the OrcaFlex on-‐line help system. What's New
Gives a list of recent improvements and alterations to OrcaFlex. Tutorial
Opens the help file at the start of the OrcaFlex tutorial. Examples
Opens the help file at the introduction to the OrcaFlex Examples topics. Keyboard Shortcuts
Lists the keyboard shortcuts used by OrcaFlex. Orcina Home Page
Opens the Orcina homepage (www.orcina.com).
51
w
User Interface, 3D Views
About
Displays a window giving the program version, details about Orcina Ltd and various other miscellaneous information.
3.6
3D VIEWS
3D Views are windows showing a spatial representation of the model. Two distinct types of 3D View are available: wire frame shows an isometric projection of the model; shaded draws the model as solid objects with lighting, shading, perspective and hidden line removal.
Figure:
A wire frame 3D View (left) alongside a shaded 3D View (right)
3D View windows may be rotated, zoomed and panned to allow any aspect of the system to be viewed. The view is controlled by a number of View parameters Ȃ see View Parameters Ȃ and the caption of a 3D View window shows the current View Azimuth and View Elevation values, while a scale bar in the view indicates the current View Size. Multiple view windows may be placed side-‐by-‐side so that you can view different parts of the system simultaneously or view from different angles (for example a plan and elevation view). This allows you to build non-‐ in-‐plane models on screen with the mouse. Further 3D View windows are added by using the Window | Add 3D View menu item or by CLICKING on the Add 3D View button on the tool bar. Windows may be arranged by dragging their borders or using the Window | Tile Vertical/Horizontal menu items. 3D Views may be closed by CLICKING the cross at the top right-‐hand corner. The objects in a 3D view are "live" in the sense that you can use the mouse pointer to select objects, drag them around in the view and make connections between objects. See Selecting Objects, Creating and Destroying Objects, Dragging Objects, Object Connections, for details. If you DOUBLE CLICK on an object then the data form for that object appears, so that you can examine or edit its data. Note:
When using the shaded view objects cannot be selected, dragged etc. For this reason, the wire frame view is most useful when building your model.
After running a simulation, or loading a simulation file, a dynamic replay (animation) can be shown in one or more 3D View windows. A replay shows a sequence of snapshots of the model taken at specified intervals throughout part or all of the simulation. Replays may be played in just one 3D View window, or in all of them simultaneously Ȃ see Preferences.
52
w
User Interface, 3D Views
Finally, 3D Views may be printed by selecting the view desired and using the print menu. Also, the picture may be exported to a file or the windows clipboard. Measuring Tape Tool (only available in wire frame mode)
You can measure distance on a 3D view using the measuring tape tool. Hold down the SHIFT and CTRL keys and then drag a line between any two points Ȃ the distance between them is displayed on the status bar. Note that this is the distance in the plane of the 3D view.
3.6.1
View Parameters
The view shown in a 3D view window is determined by the following parameters, which can be adjusted using the view control buttons or the Edit View Parameters item on the View menu. View Centre
Defines the 3D global coordinates of the point that is shown at the centre of the window. View Size
The diameter of the view area. It equals the distance represented by the smaller of the 2 sides of the view window. This parameter must be greater than zero. Example:
If the window on screen is wider than it is high, and View Size = 100.0 then an object 100 units high would just fill the height of the window.
View Azimuth and View Elevation
These determine the direction (from the view centre) from which the model is being viewed. The azimuth angle is measured from the global X direction towards the global Y direction. The elevation angle is then measured upwards (downwards for negative elevation angles) from there. The view shown is that seen when looking from this direction Ȃ i.e. by a viewer who is in that direction from the view centre. Example:
View Elevation +90° means looking in plan view from above, and View Elevation = 0°, View Azimuth = 270° (or -‐90°) means a standard elevation view, looking along the Y axis.
Window Size
You can adjust the size of a 3D view window either by dragging the window border, or by setting its window size on the view parameters form. The latter is sometimes useful when exporting a view or exporting a replay video, since it makes it easier to export multiple files and produce videos with identical dimensions. Graphics Mode
Can be either of the following options: x
Wire frame: the model is represented using a wire frame, isometric projection.
x
Shaded: the model is represented as solid objects with lighting, shading, perspective and hidden line removal.
Default View
Each model has its own default view parameters that are saved with the model data. Whenever a new 3D view is created, it starts with this default view. You can set an existing 3D view to the default view by using the Reset to Default View command (on the view menu or pop-‐up menu). To set the default view parameters, first set up a 3D View to the default view that you want and then use the Set as Default View command (on the view menu or pop-‐up menu). As an alternative you can use the calculated based on the model extent option which results in a default view that is sized so that the entire model will be displayed.
3.6.2
View Control
You can adjust the view in a 3D view window using the view control buttons: Button + SHIFT
Menu Item
Shortcut
Action
View | Rotate Up
CTRL+Ĺ
Increase view elevation
View | Rotate Down
CTRL+Ļ
Decrease view elevation
View | Rotate Right
CTRL+ĺ
Increase view azimuth
53
w
User Interface, 3D Views
Button + SHIFT
+ SHIFT
Menu Item
Shortcut
Action
View | Rotate Left
CTRL+ĸ
Decrease view azimuth
View | Zoom In
CTRL+I
Zoom in
View | Zoom Out
SHIFT+CTRL+I
Zoom out
View | Change Graphics Mode
CTRL+G
Changes graphics mode
CTRL+W View | Edit View Parameters Edit View Parameters You can also use the mouse wheel button to change view. Turn the wheel to scroll the 3D view up and down. Turn it with the CTRL key held down to zoom in or out on the location at which the mouse is currently pointing.
For more precise control you can set the view parameters explicitly using the View Parameters form. Finally, 3D views can also be controlled using the View menu and various shortcut keys Ȃ see Mouse and Keyboard Actions and Navigating in 3D Views.
3.6.3
Navigating in 3D Views
Moving
Moving in 3D Views can be achieved by a variety of means: x
Drag the 3D View with the SHIFT key held down. We call this direct manipulation of the view centre panning.
x
Use the scroll bars on the 3D View.
x
Use the cursor keys ĹĻĸĺ. Use these cursor keys with the CTRL key held down to effect larger shifts.
x
Move up and down with the PGUP and PGDN keys.
x
Edit the View Centre in the View Parameters form.
Rotating
Rotating in 3D Views can be achieved by a variety of means: x
Drag the 3D View with the CTRL key held down. For shaded views only you can rotate about the viewer position (as opposed to rotating about the view centre) by holding down the ALT key (as well as the CTRL key) whilst dragging.
x
Use the rotate buttons
x
Use the Rotate Up, Rotate Down, Rotate Left or Rotate Right menu items or their shortcut keys CTRL+ALT+ ĹĻĸ ĺ. For shaded views only you can rotate about the viewer position by holding the ALT key down whilst selecting these menu items or shortcuts.
x
Use the Plan, Elevation, Rotate 90 or Rotate -‐90 menu items or their shortcut keys CTRL+P, CTRL+E, CTRL+Q and SHIFT+CTRL+Q.
x
Edit the View Azimuth and View Elevation in the view parameters form.
. Pressing these with the SHIFT key held reverses the rotation.
Zooming
You can zoom into and out of 3D Views by using the zoom button , the zoom menu items and the shortcut keys CTRL+I and SHIFT+CTRL+I. In addition, you can zoom in or out using the mouse wheel button with the CTRL key held down. The following methods of zooming are only available in wire frame 3D Views. Also you can zoom in on a particular region of interest in a 3D view by defining a rectangle around it on screen using the mouse. To do this, hold the ALT key down, place the mouse in one corner of the desired rectangle and press down the left mouse button while dragging the mouse to the opposite corner. When you release, the region selected will be expanded to fill the window. To zoom out, repeat the operation holding down the SHIFT and ALT keys Ȃ the region shown in the window will shrink to fit into the rectangle drawn.
54
w
User Interface, 3D Views
You can also zoom in and out by a fixed amount, keeping the same view centre, by using ALT+CLICK and ALT+SHIFT+CLICK.
3.6.4
Shaded Graphics
The shaded graphics mode renders the model as solid objects with lighting, shading, perspective and hidden line removal.
Figure:
Shaded graphics
Using the Shaded Graphics mode To a large extent there is no extra work required to build a model for the shaded graphics mode. You are able to build a model or take an existing model designed using the wire frame mode and simply change to the shaded graphics mode to see a high quality shaded rendering of your model. There are a number of things you can do to improve your experience with the shaded graphics mode as described below. Translucency
The Sea Surface and Seabed are drawn as textured surfaces. If there are objects on the other side of these surfaces then they can be obscured. These surfaces are drawn with a user-‐specified amount of translucency which allows you to compensate for this. Importing 3D models
Objects like Lines are straightforward to draw. OrcaFlex uses the Line Type contact diameter to determine the thickness of each segment of the Line. Objects like Vessels present more difficulties. OrcaFlex by default will draw a solid, filled-‐in shape based on the wire frame data you have specified. While this can be sufficient you may prefer something less simplistic. Alternatively you may import a more detailed 3D model, e.g. the turret moored FPSO above. You can import 3D models for 6D Buoys, Wings and Shapes as well as for Vessels.
55
w
User Interface, 3D Views
We have provided a very basic selection of generic models which you are free to use. There are models of an FPSO, a turret moored FPSO, an installation vessel, a semisub and a subsea template. For information on generating and importing 3D models specific to your project please refer to www.orcina.com/Support/ShadedGraphics. Viewer Position
Because the shaded graphics mode uses perspective it requires the concept of the viewer position as well as the viewer centre. The isometric wire frame view has no such requirement. OrcaFlex defines the viewer position to be in a line in the view direction (defined by the view azimuth and view elevation) at a distance of view size * 1.5 from the view centre. It is possible to rotate the view around both the view centre and around the viewer position. Video export
Just as for wire frame views OrcaFlex can export video files of a replays in shaded views. When producing videos it is very important to use compression, otherwise the video file size becomes unreasonably large. The software that performs this compression is called a codec. For wire frame replays OrcaFlex uses a built-‐in codec called run-‐length encoding. This codec is not suitable for shaded replays and in fact there is no suitable built-‐in codec in Windows. We would recommend using an MPEG-‐4 codec of which many are available. In our experience the freely available XVID codec performs very well. The XVID codec can be downloaded from www.orcina.com/Support/ShadedGraphics. Should you wish to use a different codec you can select this from the Preferences form. Hardware Requirements The shaded graphics mode does require the presence of a DirectX 9 compatible graphics card. In our experience the most important factor to consider when choosing a card to work with shaded graphics is the amount of memory. We would recommend using a card with 256MB or more. It is also important to make sure that your computer's graphics settings specify a colour mode of 16 bits (65536 colours) or better. Notes:
If your machine's graphics capabilities are insufficient then the shaded graphics mode may fail to function properly or indeed fail to function at all. For example, low quality, blocky images usually indicate a graphics card with insufficient memory. This problem can also manifest itself by failure to draw the sky which appears plain white.
For best results you should centre your model close to the global origin. The Move Selected Objects facility can help you do this.
3.6.5
How Objects are Drawn
Each object in the model is drawn as a series of lines using the Pen Colour, Line Width and Style (solid, dashed etc.) defined in the drawing data for that object. You can change the pen colours etc. used at any time by editing the drawing data for that object. To change the pen colour, select and CLICK the colour button on the data form and then CLICK on the new colour wanted. You can also exclude (or include) individual objects from the 3D view, by opening the model browser, selecting the object and then using the Hide (or Show) command on the browser's Edit or pop-‐up menu. Notes:
In Windows, a line width of zero does not mean "don't draw" Ȃ it means draw with the minimum line width. To suppress drawing either set the line style to null (the blank style at the bottom of the drop down list) or else hide the object.
On some machines the display driver cannot draw the dashed or dotted pen styles and instead draws nothing. So on such machines only the solid and blank pen styles work.
Wire Frame Drawing
For wire frame views the various objects are drawn as follows: x
The various coordinate systems can be drawn as small triplets of lines showing their origin and the orientation of their axes. The wave, current and wind directions can be drawn as arrows in the top right hand corner of 3D views. You can control both what is drawn (see 3D View Drawing Preferences) and the drawing data used.
x
The Seabed is drawn as a grid using the seabed pen.
56
w
User Interface, 3D Views
x
The Sea Surface is drawn as a grid or as a single line. This is controlled by the user's choice of Surface Type as specified on the drawing page on the Environment data form. If the Surface Type is set to Single Line then one line is drawn, aligned in the wave direction. If the Surface Type is set to Grid then a grid of lines is drawn. This line or grid is drawn using the sea surface pen.
x
Shapes are drawn either as wire frames (Blocks, Cylinders and Curved Plates) or as a grid (Planes). As well as controlling the pen colour, width and style, for shapes you can also control the number of lines used to draw the shape.
x
Vessels are drawn as a wire frame of edges and vertices defined by the user on the Vessel and Vessel Types data forms.
x
3D Buoys are drawn as a single vertical line of length equal to the height of the buoy.
x
6D Buoys are drawn as a wire frame of edges and vertices. For Lumped Buoys, the vertices and edges are defined by the user on the buoy data form. For Spar Buoys and Towed Fish the vertices and edges are automatically generated by OrcaFlex to represent the stack of cylinders that make up the buoy. As an option Spar Buoys and Towed Fish can be drawn as a stack of circular cylinders Ȃ this is the default setting.
x
Wings are drawn as rectangles in either the 6D Buoy pen or the Wing Type pen as determined in the Wing Type data.
x
Lines are drawn as a series of straight lines, one for each segment, joining points drawn at each node. Separate pens are used for the segments and nodes, so you can, for example, increase the pen width used for the nodes to make them more visible. There is also, on the Line Data form, a choice of which pen to use to draw the segments.
x
Clumps are drawn as a thin vertical bar.
x
Drag Chains are drawn using the colour and line style specified on the attachment types form. The hanging part of the chain is drawn as a line, of length equal to the hanging length and at the angle calculated using the above theory. The supported part of the chain (if any is supported) is separately drawn as a blob at the seabed, directly beneath the node. The drag chain drawing therefore directly reflects the way in which the chain is modelled.
x
Flex Joints are drawn as a circular blob using the colour and line style specified on the attachment types form.
x
Links and Winches are drawn as a straight line segments joining the connection points.
Lines, Links and Winches and Shapes are special slave objects that can be connected to other master objects Ȃ see Connecting Objects. To allow these connections to be made, each slave object has a joint at each end that you can connect to a master object or else leave Free. When the program is in Reset or Statics Complete state these joints are drawn as follows: The joint at End A of a line or end 1 of a Link or Winch is drawn as a small triangle. The other joints are drawn as small squares. This distinguishes which end of a Line, Link or Winch is which. If the joint is connected to a master object, then it is drawn in the colour of the master object to which it is connected. If the joint is Free, then it is drawn in the colour of the Line, Link or Winch to which it belongs. Shaded Drawing
For shaded views the various objects are drawn as follows: x
View axes and global axes are drawn as small triplets of lines showing their origin and the orientation of their axes. The wave, current and wind directions can be drawn as arrows in the top right hand corner of 3D views. You can control both what is drawn (see 3D View Drawing Preferences) and the drawing data used.
x
The Sea Surface and Seabed are drawn as textured surfaces using their respective pen colours. Both surfaces can be drawn with user-‐specified levels of translucency.
x
Shapes are drawn as solid objects and Planes allow for user-‐specified levels of translucency. Alternatively Shapes can be represented by an imported 3D model.
x
Vessels are drawn as a solid, filled-‐in shape based on the wire frame data. Alternatively Vessels can be represented by an imported 3D model.
x
3D Buoys and Clumps are drawn as an ellipsoid with the specified volume and height.
x
Lumped 6D Buoys are drawn as a solid, filled-‐in shape based on the wire frame data. Spar Buoys and Towed Fish are drawn as solid objects using the specified cylinder geometry. Alternatively 6D Buoys can be represented by an imported 3D model.
57
w
User Interface, 3D Views
x
Wings are drawn as plates using their specified span and chord. Alternatively they can be represented by an imported 3D model.
x
Lines are drawn as a series of cylinders, one for each segment using the contact diameter as specified on the Line Type form. There is also, on the Line Data form, a choice of which pen to use to draw the segments.
x
Drag Chains are drawn as a chain with bar diameter derived from the drag chain's effective diameter.
x
Flex Joints are drawn as cylinders with radius 2R and length 4R where R is the radius of the node to which the flex joint is attached.
x
Links and Winches are drawn as a series of cylinders joining the connection points. The diameter of the cylinders can be specified on the object's data form.
3.6.6
Selecting Objects
A single CLICK on or near an object in a 3D View selects it ready for further operations. The currently selected object is indicated in the Status bar. All objects have a hot zone around them. If several objects have overlapping hot zones at the mouse position, they will be selected in turn at subsequent CLICKS. To deselect the object (without selecting another object) CLICK on the 3D view away from all objects. CLICK on an object to open its data form.
3.6.7
Creating and Destroying Objects
When the model is in Reset or Statics Complete state then you can create and destroy objects using the mouse. To create a new object, CLICK on the appropriate new object button on the tool bar or select the Model | New Object menu item. The mouse cursor changes to show this. A new object of that type is created at the position of the next CLICK on a 3D View. You can also create a new object by copying an existing one. To do this select the object and press CTRL+C to take a copy of it. You can now press CTRL+V (more than once if you want more than one copy) Ȃ again the mouse cursor changes and the copy object is pasted at the position of the next mouse CLICK in a 3D view. This method of creating a new object is particularly useful if you want an almost identical object Ȃ you can create a copy of it and then just change the data that you want to differ. To destroy an object, simply select it and then press the DELETE key. You will be asked to confirm the action.
3.6.8
Dragging Objects
An unlocked object may be dragged to relocate it by pressing the mouse button down and holding it down while moving the mouse. When the mouse button is released, then the object will be positioned at the new location. The current coordinates of the object are shown in the Status Bar during the drag operation. Note:
Objects must be dragged a certain minimum distance (as specified in the Preferences form) before the drag operation is started. This prevents accidental movement of objects when DOUBLE CLICKING etc.
Objects may be locked to prevent unintended drag operations moving them (see Locking an object). Their coordinates may still be edited on their data form. Note:
Slave objects that are connected are moved relative to their master's local origin. Other objects are moved in the global coordinate frame.
Dragging is only available in Reset or Statics Complete states, and when the object is not locked.
3.6.9
Connecting Objects
Unlocked slave objects (e.g. Lines, Links, etc.) can be connected to master objects using the mouse in a 3D View (see Object Connections). First select the end of the slave that you want to connect by CLICKING on or near its end joint. Then hold down the CTRL key while CLICKING on the master object Ȃ the two will then be connected together. This operation is only permitted for master-‐slave object pairs, for example connecting a line to a vessel. The connection is indicated in the Status Bar and the joint connected is drawn in the colour of the master object to show the connection. To Free a joint Ȃ i.e. to disconnect it Ȃ select it and then CTRL+CLICK on the sea surface. To connect a joint to a Fixed Point, select it and then CTRL+CLICK on the global axes.
58
w
User Interface, Replays
To connect an object to an Anchor (a fixed point with a coordinate relative to the seabed), select it and then CTRL+CLICK on the seabed grid. If the object is close to the seabed then the program snaps it onto the seabed. This allows an object to be placed exactly on the seabed. If you require an anchor coordinate close to, but not on the seabed, connect it to the seabed at a distance and then drag it nearer or edit the coordinate in the Data Form.
3.6.10
Printing, Copying and Exporting Views
3D Views may be printed, copied to the windows clipboard, or exported to a windows graphics metafile, so that the pictures may be used in other applications such as word processors and graphics packages. First select the view and adjust the viewpoint as desired. Then to copy to the clipboard press CTRL+C, or select Copy from the pop-‐up menu. The pop-‐up menu also has commands to print or export the 3D view. If needed, you can first adjust the printer setup using the Printer Setup command on the pop-‐up menu or on the File menu. If you are printing the view on a black and white printer (or are transferring the view into a document which you intend to print on a black and white printer) then it is often best to first set OrcaFlex to output in monochrome (use the Tools|Preferences|Output menu item). This avoids light colours appearing as faint shades of grey. After a 3D view has been transferred to another application you should be careful not to change its aspect ratio, since this will produce unequal scaling in the vertical and horizontal directions and invalidate the scale bar. In Word you can maintain aspect ratio by dragging the corners of the picture, whereas if you drag the centres of the sides then the aspect ratio is changed.
3.7
REPLAYS
A Replay is a sequence of 3D views shown one after another to give an animation. A replay is therefore like a short length of film, with each frame of the film being a snapshot of a model as it was at a given time. There are various controls and parameters that allow you to control a replay. You can also view a series of snapshots all superimposed onto a single view Ȃ see Superimpose Times. There are two types of replay: x
Active Simulation Replays show the model as it was at regularly spaced times during the currently active simulation. This type of replay is therefore only available when a simulation is active and can only cover the period that has already been simulated. If you have a time history graph window open when the replay is run, then the replay time is indicated on the graph.
x
Custom Replays are replays where you have complete control over frames which make up the replay. This means that, for example, you are not restricted to regularly spaced times; you can have frames from different simulation files in the same replay; you can include frames showing the static configuration of a model; you are able to vary the view size, view angles and view centre to achieve panning, rotating and zooming effects. Custom replays were originally introduced to help visualise series of static snapshots, for example during a lowering operation. However, the facility is very powerful and you are certainly not restricted to this application. See Custom Replays for details.
Export Video
Replays can be exported as a video clip in AVI file format, using the Export Video button on the replay parameters form. An AVI file is generated containing the replay using the most recently selected 3D view window and using the same period, frame interval and speed as the replay. When you export a video clip you will be asked to select a file name for the video using the standard Save File window. At the bottom of this window is a checkbox titled Include frame details in video. If this is selected then each frame in the video has details of that frame (e.g. simulation time) written in the top left hand corner of the frame. There is also a button which provides a link to the Video preferences. AVI is a standard video format, so the file can then be imported into other applications, for example to be shown in a presentation. The compression method (the codec) used for the generating the video file can be set on the Preferences form. Note:
AVI files can be very large if the window size is large or there are a lot of frames in the replay. Also, resizing video clips (after pasting into your presentation) will introduce aliasing (digitisation errors), so it is often best to set the 3D View window size to the required size before you export the video.
59
w
User Interface, Replays
3.7.1
Replay Parameters
The replay can be controlled by the following parameters that can be set in the Replay Parameters form, accessed using the Replay Parameters button. Replay Period
The part of the simulation that the replay covers. You can select to replay the whole simulation, just one simulation stage (an asterisk * denotes an incomplete stage), the latest wave period or else a user specified period. If you select User Specified then you can enter your own Start and End Times for the replay period. These can be set to '~' which is interpreted as simulation start time and simulation finish time respectively. Interval
The simulation time step size between frames of the replay. The value '~' is interpreted as the actual sample interval, i.e. the smallest possible interval. Using shorter intervals means that you see a smoother animation (though the extra drawing required may slow the animation). Example: For a simulation with stages of 8 seconds each, selecting stage 2 and a replay time step of 0.5 seconds causes the replay to show 16 frames, corresponding to t=8.0, 8.5, 9.0 ... 15.5. Target Speed
Determines how fast the replay is played. It is specified as a percentage of real time, so 100% means at real time, 200% means twice as fast etc. As a special case, the fastest allowable target speed (10000% at the moment) is taken to mean "as fast as possible". Note:
The specified target speed is not always achievable because the computer may not be able to draw each frame quickly enough. When this happens, the replay will be played as fast as possible. Replays may be slow if you specify thick lines (line width>1) for objects in the model, since t his can increase the drawing time.
Continuous
Continuous means replaying like an endless film loop, automatically cycling back to the first frame after the last frame has been shown; this is suitable for replays of whole cycles of regular cyclic motion. Non-‐continuous means that there will be a pause at the end of the replay, before it starts again at the beginning; this is more suitable for non-‐cyclic motion. All Views
If this is selected, then the replay is shown in all 3D Views simultaneously, allowing motion to be viewed from several different viewpoints. Otherwise the replay is played in the currently selected view window only. Show Trails
If this is selected, then when each frame of the replay is drawn the previous frame is first overdrawn in grey Ȃ this results in grey 'trails' showing the path of each object.
3.7.2
Replay Control
The replay can be controlled from the Replay menu, by using toolbar buttons or with shortcut keys. In addition, some replay settings can only be modified on the Replay Parameters form. The toolbar has a section dedicated to replay control: Figure:
Replay toolbar controls
The replay control buttons, menu items are listed in the table below: Button
Menu Item
Action
Replay | Start Replay
Shortcut CTRL+R
Replay | Stop Replay
CTRL+R
Stop replay
60
Start replay
w
User Interface, Replays
Button
Action
Replay | Step Replay Forwards
Shortcut CTRL+A
Replay | Step Replay Backwards
CTRL+B
Step to previous frame and pause
Replay | Replay Faster
CTRL+F
Speed up replay
Replay | Replay Slower
SHIFT+CTRL+F Slow down replay
Replay | Replay Parameters
CTRL+D
+ SHIFT
Menu Item
Step to next frame and pause
Edit replay parameters
Replay Slider Control
The final part of the replay toolbar is the replay slider. This allows direct control of the replay time. Drag the slider to the left to move to an earlier part of the replay and to the right to move to a later part. For fine grained adjustment of replay time you can use the Replay | Step Replay Forwards and Replay | Step Replay Backwards actions or alternatively their shortcuts, CTRL+A and CTRL+B. The replay time is displayed on and can be controlled from Time History graphs.
3.7.3
Custom Replays
Custom replays allow you to piece together arbitrary frames from different OrcaFlex files. Each frame of the replay can be either the static configuration, or a snapshot of a specified time in a dynamic simulation file. Using frames of static configurations you can string together a series of static snapshots giving, for example, an animation of an installation procedure. Using frames from dynamic simulation files allows you to create replays where the frames are from one or more simulations, and, if you wish, vary the time intervals between frames. Frames of both static and dynamic configurations can be included in the same custom replay. In addition you are able to vary the view size, view angles and view centre to achieve panning, rotating and zooming effects. To use the custom replay feature you must first set the Replay Type data item on the Replay Parameters form to Custom Replay. Next you must build the custom replay which is most easily done using the Custom Replay Wizard, which can be opened by clicking the Custom Replay Wizard button. Replay Specification
This is the file containing the custom replay specification Ȃ that is the file that is saved by the Custom Replay Wizard. Custom Replay Parameters
Custom replays also make use of some of the parameters needed for standard simulation replays. These parameters are Target Speed, Continuous, All Views and Show Trails.
3.7.4
Custom Replay Wizard
The Custom Replay Wizard allows you to define a series of replay sections. Each replay section can show either: 1.
A series of regularly spaced snapshots from a simulation file.
2.
The static configuration of a model specified by either a data file or a simulation file.
Different files can be used for different replay sections. Custom Replay Files When you have built your custom replay you must save it using the File menu or save button on the toolbar. Custom replay files can be opened in a similar way. We recommend that you save your custom replay file before you start setting up the replay sections. This is because once you have saved the custom replay file you will be able to use relative paths for the OrcaFlex file names. Custom Replay Data Custom replay specifies view parameters (size, position, angles and graphics mode)
If this data item is not checked then the replay will use the view parameters of whichever 3D View window it appears in. In this mode of operation you will be able manually to pan, rotate and zoom the 3D View using the normal buttons and shortcuts.
61
w
User Interface, Replays
If this data item is checked then you will be required to specify the view parameters (view size, view centre, view azimuth, view elevation and graphics mode) for each replay section. This allows you to include panning, rotating and zooming effects in your replay. While learning how custom replays work we recommend that you do not check this data item. Use smoothed panning, rotating and zooming effects
This item is only available if the "Custom replay specifies view parameters" option is enabled. If you are panning, rotating and zooming during replay sections then the transition from one section to another sometimes appears to be disjointed. If this option is checked then the transition between sections i s smoothed. Frame interval in real time
OrcaFlex needs to know how fast to play the replay. This data item specifies the interval, in real time, between each replay frame, assuming a target replay speed of 100%. If the target replay speed is, say 200%, then the interval between frames will be half this value, and so on. Replay Sections You can specify any number of replay sections. For each replay section you must also specify the following: Replay Section Name
This is a descriptive name for the replay section. When the replay is running OrcaFlex displays a description of the current frame in the message box on the status bar Ȃ this includes the replay section name. This description can also be included in exported videos. OrcaFlex File Name
The model to be used for this section Ȃ either a data file (.dat or .yml) or a simulation file (.sim). Dynamics
This setting determines whether the replay section defines snapshots from a dynamic simulation or a static configuration. If the file is a data file then the replay section will show the static configuration and so this data item cannot be edited. The custom replay displays static configurations for a data file by loading the file and then performing the static calculation. This can be time consuming Ȃ static state simulation files can be used instead to avoid the overhead of performing statics each time the replay is shown. Simulation Time From, Simulation Time To
This specifies the period of the dynamic simulation covered by the replay section. These are OrcaFlex simulation times for the specified simulation file of this replay section. If the replay section is a static snapshot then these data items are not editable. Number of Frames
This is the total number of frames in the replay section. If your custom replay is a series of static snapshots then you would usually set this value to 1. Included in Replay
This allows you to exclude certain sections from the replay. This may be useful while developing the custom replay because it allows you to concentrate on particular replay sections. PowerPoint slide number
Custom replays can be used to control PowerPoint slideshows. To make use of this you need to be showing a PowerPoint slideshow while the custom replay is running. At the start of each replay section OrcaFlex will change the PowerPoint slide to the slide number specified here. If you do not wish to use this feature you should leave this data item at its default value of '~'. View Parameter data The following data items are only available when the specifies view parameters option is checked.
62
w
User Interface, Data Forms
From View Parameters, To View Parameters
The view size, view centre, view azimuth and view elevation for the first and last frames of the replay section. These view parameters are varied between these values for the other frames in the replay section. Hint:
These values can be copied from OrcaFlex's View Parameters form using the clipboard.
Graphics Mode
Specifies either the Wire frame or Shaded graphics mode for the replay section.
3.7.5
Superimpose Times
Allows model configurations for different times of the simulation to be superimposed in 3D Views. Use View | Current Position to return to the normal view. The data items are: List of Times
The simulation times which will be superimposed. All Views
If this box is checked then the superimposed view is drawn in all 3D View windows. If not then it is drawn in the selected 3D View.
3.8
DATA FORMS
Each object in the model has data items that define its properties. The data are examined and edited in the object's Data Form, which can be accessed by various methods: x
use the Model Browser
x
DOUBLE CLICK the object in a 3D view
x
RIGHT CLICK the object in a 3D view and use the pop-‐up menu.
If a simulation is active then most data items cannot be changed since they affect the calculation, but you can change things like the object's colour. Control Buttons Ok
Accepts the data changes made and then closes the form. Cancel
Cancels the data changes made and then closes the form. Next
Accepts the data changes made and then displays the next form in sequence. Holding the SHIFT key down while CLICKING the Next button accepts the changes and then displays the previous data form in sequence. You can also use the keyboard shortcuts ]]F6 for next and SHIFT+F6 for previous. Pop-‐up Menu The pop-‐up menu on a data form provides various facilities, including: x
The data form can be printed, copied to the clipboard or exported to a file. The data for the whole model may be printed using the File | Print menu item.
x
Access to the next and previous data form and to the Variable Data form.
x
The batch script names for the currently-‐selected block of data items.
x
Data forms for 3D Buoys, 6D Buoys, Vessels and Lines provide a Connections Report. This is a spreadsheet listing information about other objects connected to it. Note that the same information, but for all objects in the model, can be displayed using the Model | Show Connections Report menu item.
63
w
User Interface, Data Forms
x
On data forms of some model objects, a report of the properties of that object. The report displays properties like weight in air, displacement, weight in water etc. These reports are currently available for General Data, 3D Buoys, 6D Buoys, Vessels, Lines, Line Types and Clump Types.
Calculator A simple calculator is available from any OrcaFlex data form. It can be opened from the popup menu or alternatively by pressing F12. Numbers can be transferred to and from it with standard Windows copy ( CTRL+C) and paste (CTRL+V). The calculator can also be closed by pressing F12 Ȃ if you do this then the value in the calculator is transferred to the active edit cell.
3.8.1
Data Fields
Data items on each Data Form are displayed in Fields, generally with related fields organised into Groups or Tables. You can select a field with the mouse, or use the keyboard to navigate around the form. TAB moves from group to group, and the arrow keys move across the fields in a group. The following types of fields are used: Text
A general string of text, used for example for titles and comments. Name
Each object is given a name, which you can edit. Object names must be unique Ȃ you cannot have two objects with the same name. Certain names are reserved for special purposes: Fixed, Anchored and Free (see Connecting Objects). Numeric
Numbers can be entered in a number of formats such as 3, 3.0, 0.3, .3 or 3.0e6 or 3.0E6. It is possible to enter more digits than those shown in the field, but beware that it will not be possible to see them again without editing again and using the arrow keys to examine the rest of field. For some numeric data items the value '~' is permitted. For example this is sometimes used to mean 'default value'. Details are given in the descriptions of the relevant data items. Spin Buttons
These are small buttons with up and down arrows, used for incrementing and decrementing the associated field (such as the number of entries in a table). Using the mouse, CLICK on the upper or lower parts of the button to increment or decrement the associated counter. Multi-‐choice Buttons
These are used when a number of options are available. Activate the button to step on to the next available option. Check Boxes
These show a tick, meaning selected, or are blank, meaning not selected. CLICK or press RETURN to change. Colour Selection
These show as a block of colour. DOUBLE CLICK or press RETURN to open the Colour Selection dialogue window. The desired colour may now be selected. List Boxes
These show the current selection, such as the name of another object that this object is connected to. DOUBLE CLICK or press RETURN to show a List Box, and then select another item and RETURN to accept the new choice.
3.8.2
Data Form Editing
The TAB, SHIFT+TAB, HOME, END and ARROW keys and the mouse can be used to navigate around the Edit Form. Editing mode is entered by DOUBLE CLICKING a cell with the mouse, or by starting to type alphanumeric characters, which are entered into the field as they are typed. The characters that have been typed can be edited by using the arrow keys to move around (now within the field) and the BACKSPACE and DELETE keys. Editing mode is ended, and the new value takes effect, when you press RETURN or select another field or button on the form. To end editing mode but reject the edit (and so keep the old value) press ESC.
64
w
User Interface, Results
Many numeric fields have limits on the range of values that can be entered, for example an object's mass must always be greater than zero. Warnings are given if invalid values are typed. Input can also be from the Windows clipboard. CTRL+C copies the selected field or block of fields to the clipboard whilst CTRL+V pastes from the clipboard into the selected field. In this way data can be easily transferred to and from Spreadsheets, Word Processors, etc. Mouse Actions CLICK
Select Field
CLICK+DRAG, SHIFT+CLICK
Select a block of fields
DOUBLE CLICK
Start Edit Mode in this field (please also see Data Fields)
SECONDARY BUTTON CLICK
Context sensitive pop-‐up menu for copying, exporting and printing the form and, for some model objects, viewing additional properties
Group Movement TAB Next Group SHIFT+TAB Previous Group ALT+...
Move to the group with this letter underlined in its heading
Field Movement ĸĹĻĺ
Go to adjacent row or column
HOME
Go to leftmost column
END
Go to rightmost column
PAGE UP
Go to top row
PAGE DOWN
Go to bottom row
Table Editing INSERT, DELETE
Insert or delete rows
Start Editing 0..9, A..Z
Edit (replace)
During Editing ĸĺ, HOME, END
Move within field
End Editing ESC
Cancel edit
ĹĻ
Accept edit and move to previous/next row
RETURN
Accept edit
Copy / Paste CTRL+C
Copy selected field/block to clipboard
CTRL+V
Paste from clipboard into selected field
CTRL+D
Fill selection from top (copy top cell down)
CTRL+R
Fill selection from left (copy leftmost cell to right)
CTRL+U SHIFT+CTRL+D
Fill selection from bottom (copy bottom cell up)
CTRL+L SHIFT+CTRL+R
Fill selection from right (copy rightmost cell to left)
3.9
RESULTS
3.9.1
Producing Results
You can access results by either CLICKING on the Results button menu item; the Select Results form then appears.
65
on the toolbar or by using the Select Results
w
User Interface, Results
There is a Keep Open switch on the form's context menu, which allows you to choose whether the form automatically closes when you select a result, or alternatively stays open (and on top) until you explicitly close it. Graphs and Tables can be sent straight to the printer by CLICKING the Print button. If the values of a graph are required in text form then CLICK the Values button Ȃ this give the values in a Spreadsheet window, which can handle multiple variables if desired. The Select Results form allows you to select the results you want by specifying: Result Type
This option allows you to select which of the various types of results output you require. Results are available as text tables (summary results, full results, offset tables, statistics, linked statistics, extreme statistics or line clashing reports) or as graphs (time histories, range graphs, XY graphs, offset graphs or spectral response graphs). The types of results available depend on the current model state. Object
The object for which you want results (selected in the same way as in the Model Browser) and for some objects which point in the object. x
For the Environment you must specify the global X,Y,Z coordinates of the point for which you want results.
x
For 6D Buoys that have wings attached, results for the buoy and for each wing are available separately.
x
For 6D Buoys and Vessels the position, velocity and acceleration results are reported at a user specified point on the object. This point is specified in object local coordinates.
x
For lines you must specify the arc length along the line Ȃ see Line Results.
Period
For time histories, XY graphs and range graphs you must specify the period of the simulation to be included. This can be one of the stages of the simulation, the Whole Simulation, Specified Period or Latest Wave (only available if the wave is regular). The Specified Period values can be set to '~' which is interpreted as simulation start time and simulation finish time respectively. For Range Graphs the period can also be Static State or Instantaneous Value. The Static State period is only available after a statics calculation and the graph shows a curve of the values in the static configuration. The Instantaneous Value period is available when a simulation has been run. It shows a curve of the values at the instantaneous simulation time. This is normally the latest simulated time. However, if a replay is active then the graph shows a curve of values at the active replay time. This allows you to see, for an entire line, how a results variable evolves over a simulation. Variable
The desired variable(s). Definitions of the results variables can be obtained by selecting them in the Variable list box and then pressing F1. Logging for results The summary and full results are taken directly from the current state of the model. All the other results are derived from the simulation log file which OrcaFlex creates automatically when a simulation is run. As the simulation progresses, OrcaFlex samples the variables for each object at regular intervals and stores the sampled values in the log file. All time histories, statistics and range graphs are derived from the simulation log file. You can control the time resolution of the results by setting the Target Sample Interval data item on the general data form. This must be done before the simulation is started. Decreasing the sample interval will improve the time resolution of the results (and increase the number of samples taken). However, because more samples are taken this will also increase the size of the simulation file that is created. Spike Logging A special algorithm is used for logging results that tend to vary rapidly to ensure that any spikes that may occur between samples are recorded. We refer to this algorithm as spike logging. Line Results
OrcaFlex spike logs Effective Tension, Torque, Clash Force, Clash Energy, Solid Contact Force, End Force results a nd Vortex Force results. In addition other results which are derived from these quantities are effectively spike logged
66
w
User Interface, Results
by association. Such variables include Wall Tension, Normalised Tension, Direct Tensile Strain, ZZ Strain, Worst ZZ Strain, Direct Tensile Stress, von Mises Stress, Max von Mises Stress and ZZ Stress. Link and Winch Results
OrcaFlex spike logs Tension and Velocity. Solid Results
OrcaFlex spike logs contact force magnitude. General Results
OrcaFlex spike logs Implicit solver iteration count and Implicit solver time step. Inadequate segmentation warning If any lines have, during the simulation, gone into greater compression than their segment Euler load then a warning note is added to the Results form. Such lines are marked with the symbol § in the Model Browser. Usually this means that finer segmentation is needed in some sections of these lines in order to model compression adequately. Offset warning If any of the multiple statics calculations have failed then a warning note is added to the Results form.
3.9.2
Selecting Variables
Each object has associated with it: x
A currently selected variable that will be used for graphs.
x
A set of statistics variables that will be included in statistics reports.
For the currently selected object, the currently selected variables are shown in a list on the results selection form. If Statistics results are selected, then the list shows the set of variables that will be included in the statistics report and you can add or remove variables by CLICKING on them in the list. If a Time History is selected, the list shows the (single) currently selected variable and you can select a different variable by CLICKING on it in the list. You can also multi-‐select variables, using: CLICK
select one variable
DRAG
select a range of variables
SHIFT+CLICK select a range of variables CTRL+CLICK
add / remove one variable
CTRL+DRAG
add / remove range of variables
If more than one variable is selected, then the Values button will give a single Spreadsheet Window with a time history column for each selected variable, and the Graph button will give a separate Graph Window for each variable. New columns can be appended to existing time history spreadsheet windows, as follows: x
Select the spreadsheet window to which you want to append, by clicking on it.
x
Then open the Select Results form and select the variables that you want to append.
x
Then hold the CTRL button down and click the Values button.
x
Provided that the selected spreadsheet window is a time history values table and that the time periods for both sets of histories match, then the new time histories will be appended to the active window. This allows you to have a single window containing results from different objects.
3.9.3
Summary and Full Results
These spreadsheet windows give the current state of an object or of the whole model. For example, in Statics Complete state the full results tables show the positions of objects in their static position. If a simulation is active, then they show the positions of objects at the latest time calculated. To obtain one of these results tables:
67
w
User Interface, Results
x
Select Summary Results or Full Results on the Results form.
x
Select the object required.
x
Click the Table button.
The summary results are simply an abbreviated form of the full results, in which the results for lines only include the end nodes, not all of the intermediate nodes. When the model is in Statics Complete state the summary and full results include estimates of the shortest natural periods of objects or of the whole model. These can be used to determine suitable simulation time steps. The simulation inner time step should normally be no more than 1/10th of the shortest natural period of the model Ȃ this is given at the top of the summary results or full results report for All Objects. In addition the full results table for a line contains detailed reports of the shortest natural periods.
3.9.4
Statistics
The Statistics report provides, for each statistics variable: x
The minimum and maximum values and the simulation times when they occurred.
x
The mean and standard deviation (i.e. the root mean square about the mean).
These statistics are reported for each of a number of periods of the simulation. If Statistics by Wave Period is selected then these periods are successive wave periods; otherwise they are the stages of the simulation. To obtain a Statistics report: x
Select Statistics.
x
Select the object and the variables of interest (see Selecting Variables).
x
CLICK the Table button.
The report is presented in a spreadsheet. Note:
3.9.5
Be careful when interpreting statistics of Line Clearance and Seabed Clearance, since these results are already minima Ȃ the shortest distance to any other line and to any point on the seabed. For example, the maximum of Line Contact Clearance will be the maximum value that the smallest clearance took during the period.
Linked Statistics
The Linked Statistics table relates a group of variables for a given object. For a specified group of variables and a specified period of simulation, OrcaFlex finds the minimum and maximum of each variable and reports these extreme values, the times they occurred and the values that all the other variables took at those times. The report also includes: Ɋ
mean,
ɐ
standard deviation,
Tz
mean up-‐crossing period, estimated as the average time between successive up-‐ Ɋǡ
Tc
mean crest period, estimated as the average time between successive local maxima,
m0
zeroth spectral momentǡɐ2,
m2
second spectral moment, estimated as m0/Tz2,
m4
fourth spectral moment estimated as m2/Tc2,
ɂ
spectral bandwidth parameter, estimated as (1-‐Tc2/Tz2)½,
To obtain a Linked Statistics report:
x
Select Linked Statistics.
x
Select the required object and period.
x
Select the variables of interest (see Selecting Variables).
x
CLICK the OK button.
The report is presented in a spreadsheet.
68
w
User Interface, Results
Note:
3.9.6
Be careful when interpreting statistics of Line Clearance and Seabed Clearance, since these results are already minima Ȃ the shortest distance to any other line and to any point on the seabed. For example, the maximum of Line Contact Clearance will be the maximum value that the smallest clearance took during the period.
Offset Tables
These Text Windows are available only after multiple statics calculations and only for vessels. For a given offset direction they report the total load on the vessel and show how it varies with offset distance. The worst tension in any segment of any line connected to the vessel is also reported for each offset. To obtain an Offset Table:
x
Select Offset Table on the Results form.
x
Select the offset vessel.
x
Select the offset direction required.
x
CLICK the Table button.
The report is presented in a spreadsheet.
3.9.7
Line Clashing Report
The Line Clashing Report produces a detailed tabular report about the line clashing events during a simulation. To obtain a Line Clashing Report:
x
Select Line Clashing Report on the Results form.
x
Select a line.
x
Select the period required.
x
CLICK the Table button.
The report is presented in a spreadsheet. Contents of the Line Clashing Report The report lists a summary table followed by a detailed table as described below. Summary table The summary table lists all clash events for segments on the selected line. A clash event is deemed to start when a segment from the selected line first comes into contact with another line segment. We shall refer to the selected line as L1 and to the particular segment on this line as S1. The clash event ends when S1 is no longer in contact with any other line segments. Note:
During the course of a clash event the segment S1 may be in contact with a number of different line segments from other lines, e.g. if the clash is a sliding contact. This is counted as a single clash event from the perspective of S1.
For each clash event the following results are reported: Event number
A number of clash events may occur during the simulation. Each event is given a number to identify it. This is useful when relating the summary results of a clash event to the detailed results. Segment number and segment arc length
This identifies the segment S1 on the selected line. Start Time, End Time and Duration
The simulation time of the start and end of the clash event together with its duration. Total Impulse
The total impulse of the clash event.
69
w
User Interface, Results
Peak Clash Force
A scalar value reporting the greatest value of clash force achieved during the clash event. The clash force vector is monitored during each clash event and the greatest magnitude of this vector is reported. Peak Clash Energy
A scalar value reporting the greatest value of clash energy achieved during the clash event. Max Penetration
At each time step we calculate the depth of penetration between the outer surfaces of segment S 1 and all other segments. Let S2 be a segment on another line. Let the radii of the two segments be r1 and r2 (as defined by the line type contact diameter). OrcaFlex calculates the shortest separation distance, d, between the centrelines of the two segments. The penetration of these two segments is defined to be (r1 + r2) Ȃ d. The value reported as Max Penetration is the maximum value of penetration between segment S1 and any other segment over the duration of the clash event. Detailed table The detailed table reports information about each individual contact between segment S 1 and another segment. If during the course of a clash event segment S1 is in contact with a number of segments on other lines then the start time, end time and duration of each of those individual contacts is reported. Contact velocity
The detailed table also includes the contact velocity for each individual contact. This is defined to be the normal relative velocity of the two contact points at the instant in time when the clash event started.
3.9.8
Time History and XY Graphs
Time History graphs are of a single variable against time. XY graphs are of one time dependent variable against another. The period of simulation covered by the graph is chosen from a list. To obtain a Time History or XY Graph:
1.
Select Time History or XY Graph on the Results form.
2.
Select the object required.
3.
Select the variable required (see Selecting Variables). More than one variable can be selected for time histories.
For XY graphs the steps 2 and 3 need to be done for both axes. Do this by CLICKING on one of the options labelled X-‐ axis or Y-‐axis, which are located at the bottom of the results form, and then repeating steps 2 and 3. x
Select the period required.
x
CLICK the Graph button.
Time history and XY graphs are displayed in Graph Windows and they are "live" Ȃ i.e. they are regularly updated during the simulation. You can therefore set up one or more graph windows at the start of a simulation and watch the graphs develop as the simulation progresses. If you reset the simulation then t he curves will be removed but the graphs will remain, so you can adjust the model and re-‐run the simulation and the graphs will then be redrawn. Graphs are automatically deleted if the object that they refer to is removed, for example by loading a new model. Range Jump Suppression
For time histories of angles OrcaFlex chooses the angle's range so that the time history is continuous. For example consider vessel heading, which is normally reported in the range -‐180° to +180°. If the vessel's heading passes through 180° then without range jump suppression the time history would be: .., 179°, 180°, -‐179°, .. i.e. with a 360° jump. To avoid this jump OrcaFlex adds or subtracts multiples of 360° to give the best continuation of the previous value. So in this example it adds 360° to the -‐179° value and hence reports: .., 179°, 180°, 181°, .. This addition is valid since 181° and -‐179° are of course identical headings.
70
w
User Interface, Results
Note that this means that angle time history results can go outside the range -‐360° to +360°. Spectral Density
From any time history graph you can use the pop-‐up menu to obtain the spectral density graph for that time history. The curve shown on the graph is the one-‐sided power spectral density (PSD) per unit time of the sampled time history, obtained using the Fourier Transform. Notes:
Using the Fourier Transform to estimate the PSD inevitably introduces 'noise' or 'leakage' to the spectrum. To reduce the leakage the time history is partitioned into a number of overlapping periods. The PSDs are calculated for each period and then averaged to give the reported PSD which has the effect of smoothing the resulting PSD.
This smoothing technique is only applied if there is more than 200s of data in the time history.
Empirical Cumulative Distribution
From any time history graph you can use the pop-‐up menu to obtain the empirical cumulative distribution graph for that time history. This graph shows what proportion of the samples in the time history are less than or equal to a given value. These graphs are sometimes referred to as Exceedence Plots since they can sometimes be used to estimate the probability that the variable will exceed a given value. Warning:
The samples in a time history are not independent. They have what is called 'serial correlation', which often affects the accuracy of statistical results based on them.
Rainflow half-‐cycle Empirical Cumulative Distribution
From any time history graph you can use the pop-‐up menu to obtain the rainflow half-‐cycle empirical cumulative distribution graph for that time history. The curve on this graph is produced in the following way: 1.
The time history is analysed using the rainflow cycle-‐counting algorithm. For details of this algorithm see the paper by Rychlik.
2.
The rainflow algorithm produces a list of half-‐cycles associated with the time history. The empirical cumulative distribution of these half-‐cycles is then plotted.
3.9.9
Range Graphs
Range graphs are only available for a selection of variables and they are only available for Lines. They show the values the variable took, during a specified part of the simulation, as a function of arc length along the Line. In particular: x
Range graphs show the minimum, mean and maximum values that the variable took during the specified part of the simulation with the exception that the Line Clearance range graphs only show the minimum value.
x
Effective tension range graphs have extra curves showing the segment Euler load and the Allowable Tension value (as specified on the Line Types data form).
x
Bend Moment range graphs have an extra curve showing the maximum permitted bend moment (EI / Minimum Bend Radius specified on the Line Types data form).
x
Curvature range graphs have an extra curve showing the maximum permitted curvature (the reciprocal of the Minimum Bend Radius specified on the Line Types data form).
x
Stress range graphs show the Allowable Stress (as specified on the Line Types data form).
x
A Standard Deviation curve can also be added to a range graph Ȃ to do this edit the graph's properties (by double clicking on the graph) and set the Standard Deviation curve's visible property (by default the curves are not visible). Two curves are then drawn, at Mean ± ɐǡ ɐ deviation. The standard deviation is calculated from all the samples that lie in the simulation period chosen for the graph. Warning:
Be careful not to assume that 95% of the data lie in the interval Mean ± ɐǤ is based on the assumption that the data are sampled from a N ormal (i.e. Gaussian) distribution.
To obtain a Range Graph:
x
Select Range Graph on the Results form.
71
w
User Interface, Results
x
Select the object required.
x
Select the arc lengths required. This can be the entire line, a selected arc length range, or a selected line section.
x
Select the variable required (see Selecting Variables).
x
Select the period required.
x
CLICK the Graph button.
Range graphs are displayed in Graph Windows and they are "live" Ȃ i.e. they are regularly updated during the simulation. You can therefore set up one or more graph windows at the start of a simulation and watch the graphs develop as the simulation progresses. If you reset the simulation then the curves will be removed but the graphs will remain, so you can adjust the model and re-‐run the simulation and the graphs will then be redrawn. Graphs are automatically deleted if the object that they refer to is removed, for example by loading a new model. Range Jump Suppression
Just as it does for Time History and XY Graphs, OrcaFlex applies range jump suppression for range graphs of angles.
3.9.10
Offset Graphs
These graphs are available only after a multiple statics calculation has been done and only for the offset vessel. The following variables are plotted against offset distance: Restoring Force
The magnitude of the horizontal component of the total force applied to the vessel by the attached Lines or other objects. Note that this force is not necessarily in the offset direction. Vertical Force
The vertically downwards component of the total force applied to the vessel by the attached Lines or other objects. Yaw Moment
The moment, about the vertical, applied to the vessel by the attached Lines or other objects. Worst Tension
The largest tension in any segment of any Line connected to the vessel. To obtain an Offset Graph:
x
Select Offset Graph on the Results form.
x
Select the offset vessel.
x
Select the offset direction required.
x
Select the variable required.
x
CLICK the Graph button.
3.9.11
Spectral Response Graphs
These graphs are available only if you have run a response calculation wave. The graph is only available once the simulation has been completed. The graph plots the calculated RAO for the selected variable on the Y axis and wave frequency on the X axis. To obtain a Spectral Response Graph:
x
Select Spectral Response Graph on the Results form.
x
Select the object required.
x
Select the variable required (see Selecting Variables). More than one variable can be selected.
x
CLICK the Graph button.
3.9.12
Extreme Statistics Results
There is often a requirement to predict the extreme responses of a system, for example to determine the likelihood of a load exceeding a critical value that may lead to failure. Such values are needed when using standards such as DNV-‐OS-‐F201 and API RP 2SK.
72
w
User Interface, Results
OrcaFlex can estimate extreme values for any given result variable by analysing the simulated time history of the variable using extreme value statistical methods. You may, for instance, perform a mooring analysis in an irregular sea-‐state and then estimate the maximum mooring line tension for a 3-‐hour storm. The statistical theory for this estimation is well-‐established and is described in the theory section. The procedure is essentially this: x
You select the statistical distribution to be used to model the distribution of extremes. See Data below.
x
OrcaFlex estimates the distribution model parameters that best fit the simulation time history of the variable.
x
OrcaFlex uses the fitted distribution to estimate and report the required extreme statistic (e.g. return level), for a specified period of exposure. See Results below.
x
OrcaFlex provides diagnostic graphs that you should use to judge the reliability of the results.
The Extreme Statistics Results form is designed to lead you through this process. When you open the Extreme Statistics Results form, for a selected results variable, you will come first to the Data page, where you will select the distribution. Moving then to either of the other pages (Results or Diagnostic Graphs) will cause OrcaFlex to carry out the estimation part of the procedure. The Diagnostic Graphs assist in testing the model. The Results page reports the estimated statistics, e.g. the return value for the specified period, the estimation uncertainty inherent in that value etc. Data For convenience, the time history result graph is reproduced on the Data page. The data required for the fitting of the model are entered on this page, and are as follows. Distributions
These fall into two groups, according to the statistical method with which they are applied. For details see the Extreme Statistics Theory section. x
Rayleigh distribution. This method assumes that the variable is a stationary Gaussian process. This is perhaps a reasonable assumption for waves, particularly in deep water, and for responses which are approximately linear with respect to wave height. However, for many other variables of interest, the Gaussian assumption is invalid and leads to poor estimates of extreme values.
x
Weibull and Generalised Pareto (GPD) distributions. These distributions are both fitted using the maximum likelihood method. Historically, the Weibull distribution has often been used for marine systems, but the Generalised Pareto is preferred by the extreme statistics community because of its sound mathematical foundations.
Extremes to analyse
Specifies whether maxima (upper tail) or minima (lower tail) are to be analysed. Threshold and Decluster Period
These data are only required when using the Weibull and GPD distributions, which are fitted to extremes of the time history and those extremes are selected using the peaks-‐over-‐threshold method with (optional) declustering. The threshold controls the peaks-‐over-‐threshold method. This allows you to control the extent to which the analysis is based on only the extreme values in the data (the tail of the distribution). The decluster period controls the declustering. This helps avoid or reduce any statistical dependence between the extreme data values used in the analysis. It can be set to one of the following: x
Zero, in which case no declustering will be done, and all values above the specified threshold will be included. This is generally not recommended since the values are unlikely to be independent.
x
A positive value. In this case OrcaFlex will break the sequence of time history values into clusters of successive values that stay above the threshold. It will then decluster by merging successive clusters that are separated by periods (during which the variable is less than the threshold) that last no longer than the specified decluster period. The most extreme value of each of the resulting merged clusters will then be included in the analysis.
x
'~'. This special value may be used to tell OrcaFlex to take the clusters to be the groups of values between successive up-‐crossings of the mean value (or down-‐crossings if analysing lower tail). The most extreme value of each such cluster will then be included in the analysis, but ignoring any that do not exceed the threshold.
73
w
User Interface, Results
The threshold is drawn on the time history graph, to help visualise its value relative to the extremes o f the data. The number of data points that will be included in the analysis (after the threshold and declustering have been done) is also displayed. This helps with setting the threshold and decluster period. The best value for the threshold is one that strikes a balance between a not-‐extreme-‐enough value (which will increase the number of data points fitted but may give biased fitting by allowing less extreme values to influence the fitting too much), and a too-‐extreme value (which will fit to only the more relevant extreme data points, but may give very wide confidence intervals if there are too few such extremes in the data). Results The following data items, found on the Results page, do not affect the fitting of the statistical model. Rather, they are applied to the fitted model to obtain the reported results. Rayleigh
Storm duration is the return period for which the return level is reported. The length of the simulation, relative to this duration, will determine the accuracy of the estimate for the return level. Risk factor is the probability of exceeding (or falling below, for lower tail) the estimated extreme value. For example, you may ask for the 3-‐hour extreme value that is exceeded with a probability of 0.01 (i.e. a risk factor of 1%). Weibull and GPD
Storm duration is defined as for the Rayleigh distribution. The maximum likelihood fitting procedure used for these distributions allows the estimation of a confidence interval for the return level, for a specified confidence level. OrcaFlex reports this estimated confidence interval in addition to the estimated return level. The reported return level is defined to be the level whose expected number of exceedences in the specified storm duration is one. The fitted values of the model parameters and corresponding standard errors are also reported. Note:
For some values of storm duration (usually small values) it might not be possible to calculate the return level. This is indicated by the value 'N/A' (meaning 'not available'). Similarly, for some combinations of storm duration and confidence level, the calculation may fail to determine the confidence limits, and again these are then denoted by 'N/A'.
Diagnostic Graphs The diagnostic graphs will help you to assess the goodness-‐of-‐fit of the model, and how appropriate or not the fitted distribution is. They should be interpreted together, not in isolation, as follows. x
The Quantile Plot displays quantiles of the empirical data plotted against model quantiles. If the model is a good fit, then the points should lie close to the superimposed 45° diagonal line, and any significant departure from this (especially a systematic one, for example an obvious trend away from the diagonal) indicates poor model fit. The vertical lines, drawn through each point, are pointwise 95% tolerance intervals and may be used as a guide to deciding whether any departure from the diagonal is significant. If all the vertical lines intersect the diagonal line, then the modelled values are probably sufficiently close to the empirical value not to be of concern. If, however, a number of the vertical lines fail to reach the diagonal, then that may raise concerns about the validity of the fitted model.
x
The Return Level Plot shows return level against return period (i.e. storm duration), with the latter on a logarithmic scale to highlight the effect of extrapolation. The central line on the graph is the return level for the fitted model, and the pair of outer lines the corresponding pointwise 95% confidence limits. The points are the empirical return levels, based upon the data, and should lie between the confidence limits if the model fits the data well. As with the quantile plot, a significant number of points contravening these limits indicates poor model fit. Again, OrcaFlex may sometimes be unable to determine the confidence limits for some return periods Ȃ this may result in gaps in the confidence limit lines, or even in their not appearing at all.
An example of diagnostics graphs indicating a good model fit is shown below:
74
w
User Interface, Results
Figure:
Diagnostics graphs for a good model fit
If either of these graphs indicates a poor model fit, then you should reconsider the entries on the data page: x
Distribution. The distribution may be inappropriate Ȃ the data may simply not conform to the selected distribution.
x
Threshold. The threshold may be too low, hence including too many points which are not in the tail of the distribution; or too high, resulting in too few data points for the analysis and consequent large variation in the results.
x
Decluster period. This may be too long (so too few data points), or too short (so successive data points might not be independent).
3.9.13
Presenting OrcaFlex Results
OrcaFlex users often wish to show their OrcaFlex results in a slide presentation prepared using a presentation program such as Microsoft PowerPoint. Here are some tips on how this can be done. Graphs
Graphs can be transferred from OrcaFlex to presentation programs by simple copy + paste. Note:
In PowerPoint, instead of using Paste, it is better to use Paste Special (from the Edit menu) and then select the Enhanced Metafile. This gives better resolution.
Replays
Replays can be transferred by exporting to an AVI file and then importing that video clip file into the presentation program. An XVID encoded AVI file (and possibly other codecs) added to Microsoft PowerPoint slides as a Movie Object may not play correctly (displaying a blank screen on replay, or the video only appearing in full screen mode). To avoid these problems, an XVID AVI file needs to be inserted as a Video Clip Object. This can be done in two ways: 1.
Drag and Drop the AVI file onto the PowerPoint slide, or
2.
From the PowerPoint menu, choose Insert | Object. Select 'Create from file' and Browse to your file (do not select the 'Link' option).
To set options such as auto repeat, right-‐click on the image in the slide, then select Video Clip Object | Open, this displays the video player window and menus.
75
w
User Interface, Graphs
The Video Clip Object links to the AVI file (it is not embedded within PowerPoint) so the file location needs to be accessible when running the presentation. The computer running the presentation must also have the XVID codec installed. Note:
Resizing video clips (after pasting into your presentation) will introduce aliasing (re-‐digitisation errors) so it is best to set the OrcaFlex 3D View window to the required size before you export the video.
Video Clips of OrcaFlex in Use
Your presentation can even show video clips of OrcaFlex in use, illustrating how the program i s used. However, it is rather harder to generate the required video files. We recommend using software called Camtasia (www.techsmith.com) to record video clips showing OrcaFlex in use.
3.10
GRAPHS
When you request results in graphical form, they are presented in Graph Windows. You can open several simultaneous graph windows, showing different results, and tile them on the screen together with 3D Views and text results windows. To adjust a graph's properties (range of axes, colours, etc.) see Modifying Graphs. Graphs have a pop-‐up menu that provides the following facilities. x
Use Default Ranges.
x
Copy copies the graph to the clipboard, from where you can paste it into other applications.
Export enables you to export the graph to a metafile or bitmap file.
x
Print facilities and the Monochrome Output preference.
x
Properties.
Graphs of simulation results are updated automatically as the simulation progresses. Also, they are kept even if you reset the simulation, so once you have set up a set of interesting graphs you can edit the model and re-‐run the simulation to see the effect of changing the model. You can also set up results graphs when in reset state, prior to running a simulation Ȃ the graph will be empty initially and will grow as the simulation progresses. Note that we do not recommend this for graphs of line clearance, however, since updating them can significantly slow down the simulation. The workspace feature provides a very powerful way of managing collections of related graphs. When a replay is in progress the replay time is indicated on both Time History and XY graphs.
76
w
User Interface, Graphs
Figure:
Replay time indicator on a Time History Graph (vertical line at Time=16s) and on an XY Graph (grey cross in bottom right of the graph).
The replay time indicator on a Time History graph can be directly manipulated using the mouse. With the CTRL key pressed you simply click on a Time History graph and the indicator moves to where you have clicked. Any open 3D Views are updated to show the new replay time. Similarly, with the CTRL key pressed you can click and then drag the indicator. This direct manipulation of the replay time indicator is designed to help understand and visualise how your model is behaving at key moments of the simulation. Printing Graphs
To print a graph, use the File | Print menu item. When printing to a monochrome printer you will get the best results by setting the Monochrome Output preference Ȃ this is set by default when the program is first installed. Copy and Paste with graphs
You can also copy a graph to the clipboard Ȃ simply select the graph window by CLICKING on it and then using the Edit | Copy menu item. From the clipboard you can then paste it into another application, for instance into a word processor document. Graphs can also be exported as Windows metafiles, use the File | Export menu item. Metafiles can be imported into many Windows programs, such as word processors, spreadsheets, graphics packages etc. Note:
3.10.1
When copying a graph to the clipboard, the size of the graph window you copy from has an effect on how the text label fonts appear when the graph is pasted into another application. For example, if you are copying a graph to a Word Processor and want the graph to be full page size, then the graph window should be made large on screen (e.g. maximised). If you want a number of graphs on one page of a document then the graph should be smaller on screen Ȃ try tiling or cascading the windows (see the Window menu). By experimenting with various differently sized graphs it should be possible to arrange for the fonts to appear as you wish.
Modifying Graphs
You can zoom into a graph by holding down the ALT key and dragging a box around the area that you want the graph to display. When you release the mouse button the region selected will be expanded to fill the graph. If you want to reverse this process then right click the mouse and choose Use Default Ranges from the pop-‐up menu. You can also change the appearance of a graph by double clicking on the graph or by selecting Properties from the graph's pop-‐up menu. A form is then shown which allows you to change various aspects of the graph, as follows:
77
w
User Interface, Spreadsheets
Axes
You can set the range, the tick spacing and the number of small ticks. The Use Default Tick Spacing button sets the tick spacing and the number of small ticks to sensible default values based on the range. This is useful if you want to set the range to a specific value and want the tick spacing to be set automatically. Labels
You can alter the text and fonts of the axis and tick labels. Curves
You can control the line properties and visibility for each curve on the graph. Legend
The legend is a key showing which curve is which. It only appears on graphs that have multiple curves, e.g. range graphs. You can control whether the legend is shown and if so where and using what font. Note that the legend includes all the curves, even if some of them may not be visible at the time. Intercepts
Intercepts are lines, like the axes, that go right across the graph. In fact the X and Y axes themselves are considered to be intercepts. You can add more intercepts, for example to mark things like stage start times, and you can control their position and style. Save As Default
Changes to a graph's properties normally only apply to that graph. But for general settings (fonts etc.) you can also click the Save As Default button. OrcaFlex then remembers the current settings for use with future graphs.
3.11
SPREADSHEETS
Some numerical results (e.g. obtained with the Values button on the Results form) appear in an Excel compatible spreadsheet. The spreadsheet is read-‐only. If you wish to modify or extend it you must first save it as described below. Printing, Copying and Exporting Spreadsheets
To print the spreadsheet right click and select Print, but remember that OrcaFlex time histories are normally quite long and will therefore produce many pages. If necessary, you can first adjust the printer setup using File | Printer Setup. You can also easily transfer the results to other applications by either: x
Copy and paste via the Windows clipboard. Select the block to be transferred and press CTRL+C.
x
Saving to file. Choose Export from the popup menu to save as Excel format (.xls), comma separated values (.csv) or as tab delimited text (.txt).
3.12
TEXT WINDOWS
Simple text windows are used for some reports Ȃ see below. To print a text window, use the File | Print menu. You can also copy text to the clipboard Ȃ simply select a region of text and then use the Edit | Copy menu item (or press CTRL+C). From the clipboard you can then paste it into another application, for instance into a word processor document. Alternatively, you can export the text to a file by using the File | Export menu item. The resulting text file can then be imported into your word processor. Statics Progress Window During a Statics Calculation, the progress of the calculation is shown in the message box on t he status bar. However the messages are also sent to a text window that is normally minimised. This window may be viewed by clicking on the message box during statics, or by selecting the Window | Statics Progress menu item if you wish to watch the process more closely. Like other text windows it may be printed, copied or exported, as described above.
3.13
WORKSPACES
It is common to have many windows (3D View, graph or spreadsheet) open within OrcaFlex. The workspace facility is designed to help manage these windows.
78
w
User Interface, Comparing Data
Workspace files
A collection of view, graph or spreadsheet windows can be saved using the Workspace | Save Workspace menu item. This creates a text file with the .wrk file extension containing a specification of the current window layout. The workspace can be restored at any time with the Workspace | Open Workspace menu item. This can give significant time savings if you wish to look at a number of different results windows for a large number of OrcaFlex models. Note that the contents of the windows are not saved to the workspace file, just a logical description of the window. For example, suppose you saved a workspace containing a graph of Effective Tension of a Line called Riser. If you then loaded a different simulation file and open that workspace then you would see the Effective Tension of the Line called Riser in the new simulation file and not the simulation filed open when the workspace was saved. This means that you can look at the same collection of results for any number of simulation files. Workspace files are not limited to simulation files Ȃ static results and multiple statics results can also be saved. Default workspaces
As an alternative to loading a workspace by using the Workspace menu items you can associate default workspaces with either individual simulation files or with entire directories. x
If you define a default workspace for a simulation file then the workspace is restored whenever you open that same simulation file.
x
If you define a default workspace for a directory then the workspace is restored whenever you open any simulation file in that directory.
Getting the most out of workspaces
We recommend that you save your workspace files in the same directory as the OrcaFlex files. If you do so then the workspace file will appear in the Most Recent Files list on the Workspace menu. Workspace files can be very useful if you are sending simulation files to another person. By including a workspace file with the results of interest you can be sure that they will view the correct information. This can be particularly valuable when sending files to someone who is not an experienced OrcaFlex user. This can even be useful when sending files to Orcina for software support because they contain a precise specification of the results you are interested in.
3.14
COMPARING DATA
The Compare Data menu item opens the Compare Data form, which allows you to find differences between the data in two OrcaFlex files. The comparison is done using a user-‐provided compare program, so when you first use this facility you need to configure OrcaFlex to tell it which compare program that you want to use; see Configuration below. You can then compare files as follows: x
On the Files page, specify the two files that you wish to compare. These can be data or simulation files.
x
Click the Compare button.
x
OrcaFlex then saves the data from the two files to temporary text files and then runs the user-‐specified compare program to compare those text files.
As an alternative to comparing two data files on disk you can optionally choose to compare the currently loaded model with a single file on disk. Configuration On the Configuration page you need to tell OrcaFlex the text file compare program that you want to use, and how to use it. The compare program must be a program that can compare text files passed to it through the command line. Various such programs are available on the web; examples are WinDiff, Compare It! and Araxis Merge. Compare Program
This is the compare program's executable file name. You can specify either the full path, or just the file name if the executable file resides in a directory which is on your system path. A basic compare program called WinDiff is freely available (you can find it by searching the Internet) and is quite sufficient for this purpose.
79
w
User Interface, Preferences
Command Line Parameters
This defines the command line parameters that are passed to the compare program. OrcaFlex replaces the special strings %1 and %2 with the file names of the temporary text files. For most compare programs the default setting of "%1 %2" will be sufficient. Otherwise you will need to consult the documentation of your compare program.
3.15
PREFERENCES
OrcaFlex has a number of settings that can be customised to suit the way that you work. The majority of settings can be adjusted in the Preferences form, which is accessed by using the Tools | Preferences menu item. 3D View Preferences Minimum Drag Distance
Object positions are not updated until the mouse has been dragged at least this distance (in pixels). This prevents accidental changes to object positions. To make a small movement, drag away and then back again, or edit the coordinate directly in the object's Edit Form. View Rotation Increment
Each CLICK on a Rotate View button increments or decrements View Azimuth or Elevation by this amount. Refresh Rate
During a simulation calculation all 3D View and Graph windows are updated at this rate. Selecting a faster rate allows you to see the behaviour of the simulation more clearly at the expense of performance. Set a slow Refresh Rate to give the numerical calculation more processor time. Background Colour
This sets the background colour of all 3D View windows. Locate Object Method
Can be either Flash object or Hide other objects. It determines what method the Locate action in the model browser uses. x
When the Flash object preference is set then the Locate action repeatedly draws and hides the object on the 3D View, like a blinking cursor.
x
When the Hide other objects preference is set then the Locate action temporarily hides all other objects.
Normally the default setting of Flash object is sufficient to locate objects. However, if the model you are searching for is obscured by other objects then this method may not help you to locate the object. In this case you should use the Hide other objects preference. 3D View Axes Preferences View Axes
The view axes show the same directions as the global axes, but are drawn in the top right hand corner of 3D views, rather than at the global origin. Can also be set from the View menu. Scale Bar
Determines whether a scale bar is drawn in 3D views. Can also be set from the View menu. Note:
The Scale Bar is not drawn for shaded graphics views because it would be meaningless due to perspective.
Global Axes
Determines whether the global axes are drawn, at the model's global origin (0,0,0). Can also be set from the View menu. Environment Axes
Determines whether the wave, current and wind directions are drawn in the 3D view. When multiple wave trains are present the first wave train is taken to be the dominant one and is drawn using sea surface pen, whereas the other wave trains' directions are drawn in the secondary wave direction pen. Can also be set from the View menu.
80
w
User Interface, Preferences
Local Axes
Determines whether the local axes for vessels, buoys and line ends are shown. Drawing the local axes on the 3D view helps you check the orientations of these objects. This preference can also be set from the View menu. Note:
Local Axes are not drawn for shaded graphics views.
Node Axes
Determines whether axes for line nodes are shown. This preference can also be set from the View menu. Out of Balance Forces
If selected, then in the static analysis (not during the simulation) there are extra lines drawn on the 3D view, representing the out of balance force acting on each vessel and buoy. This preference is sometimes useful for static analysis, since it enables you to see how far a buoy or vessel is from being in equilibrium. This preference can also be set from the View menu. The force is drawn as a line, starting at the force's effective point of application, and whose length represents the size of the force. The scaling is piecewise linear and based on the View Size of the 3D view. Lines up to ViewSize/2 long mean forces up to 10 force units and lines from ViewSize/2 to ViewSize mean forces from 10 to 1000 force units. Note:
Out of Balance Forces are not drawn for shaded graphics views.
Video Preferences The video preferences allow you to control the compression algorithm used for exported video. The software which performs this compression is called a codec. Because the different graphics modes produce very different images they require different types of codec. Shaded Graphics Codec
The run-‐length encoding which works well for wire frame graphics is not suitable for shaded replays and in fact there is no suitable built-‐in codec in Windows. We would recommend using an MPEG-‐4 codec of which many are available. In our experience the freely available (licensed under the GPL) XVID codec performs very well. The Shaded Graphics topic has more information about the XVID codec. Another reasonable choice is the Windows Media Video 9 codec, which is identified by the code WMV3. This codec produces lower quality videos than XVID for the same video file size, but does have the advantage that the videos should work on almost all Windows machines without the need for codec installation. Details on how to download this codec can be found at: www.orcina.com/Support/ShadedGraphics. You can choose to use other codecs that are installed on your machine. Should you do so then you must also specify the following information: x
Codec 4 character code: Codecs are identified by unique codes, 4 characters long. Good alternatives to XVID and WMV3 include DIVX, the 3ivx codec (character code 3IV2).
x
Padding: MPEG-‐4 codecs commonly require round number frame sizes (width and height in pixels). For example XVID requires frame sizes to be multiples of 8. When OrcaFlex exports the video it ensures that the frame sizes are a multiple of this number. If you are unsure of what number to use for your codec then we recommend trying 8 which usually works.
x
Colour depth: Some MPEG-‐4 codecs require a specific colour depth. Again, if you are unsure of what value to use then we recommend trying 32 bit or 16 bit colour depth.
Wire Frame Graphics Codec
Run-‐length encoding is the default setting and is usually the best choice. This codec offers good compression rates for OrcaFlex wire frame video. The AVI files produced using this codec can be played on most Windows PCs. If you choose Uncompressed then each frame of the video is stored as an uncompressed bitmap. This means that the AVI file produced can be extremely large. Output Preferences Printer Margins
These set the Left and Top margins used on printouts.
81
w
User Interface, Printing and Exporting
Monochrome Output
If this is checked then external output (copying to the clipboard, exporting metafiles and printing) is in black and white. This is useful with black and white printers, since otherwise pale colours may be drawn in very light grey and may be hard to see. Miscellaneous Preferences Show Splash Screen
Determines whether OrcaFlex displays its splash screen when the program starts. Batch Auto Save
If this is enabled then simulations run in batch mode are automatically stored to simulation files at the specified regular Auto Save Interval. This is useful if your computer is prone to failure (for example because of overnight power failures) since the part-‐run simulation file can be loaded and continued, rather than having to re-‐run the whole simulation from scratch. The Auto Save Interval should be neither too short, since then the program will then waste a lot of time repeatedly storing away the results, nor too long, since then a lot of simulation work will be lost if a failure occurs.
3.16
PRINTING AND EXPORTING
The Print / Export form is accessed using either the File | Print or the File | Export menu item and allows you to choose one or more of the following items to be printed or saved to file: x
The model data. Vessel Types often have very large amounts of data, much of which may not apply to the current model, so OrcaFlex offers you the option of printing all the vessel type data or only the data that is in use.
x
Any 3D Views, Graphs, Spreadsheets and Text Windows currently on display. Note:
Graphs are printed as large as possible whilst maintaining aspect ratio.
82
w
Automation, Introduction
4
AUTOMATION
4.1
INTRODUCTION
OrcaFlex provides several important facilities for automating and post-‐processing work: x
OrcaFlex is supplied with a special Excel spreadsheet which enables you to automate the extraction of simulation results into your own spreadsheet. You can then use the normal Excel calculation facilities to do your own customised post-‐processing and graphing.
x
The Batch Processing facility enables you to run a set of simulations in unattended mode, for example as an overnight job. The simulations can either be of pre-‐prepared data files, or else can be specified by a batch script file that specifies the simulation as variations on a base data file. The OrcaFlex Spreadsheet mentioned above also has facilities for automating the production of batch script files and text data files.
x
OrcaFlex includes a well-‐documented programming interface called OrcFxAPI (short for OrcaFlex Application Program Interface). See the OrxFxAPI help file for details. OrcFxAPI is a Windows dynamic link library (DLL) that is installed when you install OrcaFlex, and which provides facilities for setting data, calculating static positions and extracting results from those calculations or from pre-‐run simulation files. For example you can write programs to automate post-‐processing or that use OrcaFlex as a 'statics calculation engine'. One important example application of this is for real-‐time monitoring of pipes, moorings etc. For further information or to discuss possible applications of OrcFxAPI, please contact Orcina.
4.2
BATCH PROCESSING
4.2.1
Introduction
Simulations, script files, post processing spreadsheets and fatigue analyses can all be run in unattended mode, by using the Calculation | Batch Processing menu item. This command opens a form that allows you to set up a list of jobs that are to be run. The list can include any number and mixture of the following types of job: 1.
Static analysis of pre-‐prepared OrcaFlex data files (.dat or .yml). OrcaFlex opens the data file, performs the static analysis and then saves the results in a simulation file with the same name as the data file, but with a .sim extension.
2.
Dynamic analysis of pre-‐prepared OrcaFlex data files (.dat or .yml). OrcaFlex opens the data file, performs the static analysis, runs the dynamic simulation and then saves the results in a simulation file with the same name as the data file, but with a .sim extension.
3.
Partially-‐run OrcaFlex simulation files (.sim). OrcaFlex opens the simulation file, finishes the dynamic simulation and then saves the completed simulation, overwriting the original file.
4.
A batch script file (.txt). This is a text file which contains OrcaFlex script commands. OrcaFlex opens the script file and obeys the commands in turn. The most common use of script files is to perform a series of systematic variations on a base data file.
5.
A fatigue analysis file (.ftg). OrcaFlex performs the fatigue analysis and saves the results to an Excel compatible spreadsheet of the same name but extension .xls.
6.
An OrcaFlex Spreadsheet (.xls or .xlsx). OrcaFlex will process all Instructions sheets in the Excel workbook. Note that if the spreadsheet's "Contains Dependencies" options is checked (or the spreadsheet is pre OrcaFlex v9.4) then the workbook will be processes as a single job us Ǥ ǯ ǡ instructions sheet will be broken down into multiple load cases which are individually added to the batch and may be processed simultaneously. Note:
If you wish to use Excel for any reason while OrcaFlex is processing spreadsheets within a batch it is important that you open Excel first, then open the file you wish to work on. The reason for this is that when you double click an Excel file, Windows will try to use the copy of Excel OrcaFlex has claimed, resulting in unpredictable failures.
When adding data files (.dat or .yml) you need to specify whether static or dynamic analysis is to be performed. This choice is made from the Add Files file dialogue window, or from the popup menu. OrcaFlex can auto-‐save partial completed dynamic simulations to file at regular intervals during the batch job. This is useful if your computer is prone to failure (for example because of overnight power failures) since the part-‐run simulation file can be loaded and continued, rather than having to re-‐run the whole simulation from scratch.
83
w
Automation, Batch Processing
Multi-‐threading The batch processing functionality can make use of multiple processor cores. So, for example, if you have a quad-‐ core machine then 4 simulation files can be run concurrently. Since some batch tasks can depend on the output of other tasks OrcaFlex processes tasks in a very particular order, as follows: x
The batch script files are all processed first. Because it is common to write scripts that output data files it is important to complete all batch scripts before processing the data files.
x
Any data or simulation files are processed next.
x
Fatigue files are processed next. These use simulation files as input and so should not be started until all data or simulation files have been processed.
x
Finally any OrcaFlex spreadsheet files or load cases are processed. These also cannot be started until all data or simulation files have been processed.
The commands in batch script files are processed sequentially. Consequently any simulations that are processed with Run commands cannot be performed in parallel. Because of this it is advisable to use the SaveData command rather than the Run command when creating batch scripts. Such a script would create a number of OrcaFlex data files which you could then process in the batch form using all available processor cores. Batch Form User Interface Close
Dismisses the batch form. Add Files
Adds jobs to the list. The standard file dialogue window is displayed, where you select one or more files to be added to the list. Files can also be added by drag and drop. That is if you are browsing your file system then you can highlight files and drag them onto the jobs list. Remove Files
Removes any files highlighted in the jobs list. Check Files
OrcaFlex opens each file in the jobs list, checks that they contain valid OrcaFlex data or script commands and reports any errors. When checking OrcaFlex spreadsheet or fatigue files it simply confirms the file exists. Run Batch
Processes the list of jobs. If a job fails then it is abandoned but other jobs are still attempted. Any errors are reported once all jobs have been processed. Pause Batch
Pauses the currently running batch jobs. This can be useful if you temporarily want another process on your machine to have the processor resource that OrcaFlex is using. Stop Batch
Terminate processing of batch jobs. Warnings
Displays a window allowing you to review all warnings generated by OrcaFlex during a calculation. These warnings are suppressed when you are operating in batch mode and this button allows you to review them once the simulation has completed. Close program when Batch completes
If checked then OrcaFlex will close once the processing of jobs completes. This feature is intended principally for users with networked licences. It allows you to release your claim on an OrcaFlex licence as soon as the batch of jobs is complete.
84
w
Automation, Batch Processing
4.2.2
Script Files
OrcaFlex provides special facilities for running a series of variations on a base data file, using a script file. This contains a sequence of commands to read a data file, make modifications to it, and run the modified file, storing the results for later processing. The file can also include comments. The syntax for the instructions is described in the next topic. Script files can be written using any text editor. Alternatively, there are facilities in the OrcaFlex spreadsheet for automatically generating script files for regular sets of cases.
4.2.3
Script Syntax
An OrcaFlex batch script is made up of commands, which are obeyed sequentially, and comments, which are ignored. A comment is a line that is either blank or on which the first non-‐blank characters are "//". A command can be: 1.
A directive followed by one or more arguments, optionally separated by white space (one or more spaces or tabs). For example: load c:\temp\test.dat where load is the directive and c:\temp\test.dat is the argument.
2.
An assignment of the form VariableName=value, again with optional white space separators. For example: Length = 55.0.
Note that: x
Directives, variable names, and model object names are all case independent.
x
If your script includes a relative file name then it is taken to be relative to the directory from which the script was loaded.
x
File names, arguments, variables or values containing spaces or non-‐alphanumeric characters must be enclosed in single or double quotes and they must not contain the same quote character as is used to enclose them. For example '6" pipe' and "200' riser" are valid, but the following are not valid: 6 inch pipe Ȃ contains spaces, so needs to be enclosed in quotes; 6"pipe Ȃ contains a double quote, so needs to be enclosed in single quotes; '6' pipe' Ȃ contains a single quote, so needs to be enclosed in double quotes instead of single.
4.2.4
Script Commands
The following batch script commands are currently available. You need to put quotes round file names or other parameters that include spaces or non-‐alphanumeric characters. Load
Opens the OrcaFlex file named . The file can be either a data file or a simulation file. LoadData
Opens the data from the OrcaFlex data file named . RunStatics
Perform statics for the current model and save the resulting simulation to . After the file is saved the model is reset. RunDynamics
Run dynamics for the current model and save the resulting simulation to . After the file is saved the model is reset. Run
Identical to RunDynamics. Save
Save the current model to .
85
w
Automation, Batch Processing
If calculation results (either statics or dynamics) are available then a simulation file will be saved. Otherwise a data file will be saved. When saving data, if the file extension is .yml then a text data file will be saved; otherwise a binary data file will be saved. SaveData
Save the data from the current model to . If the file extension is .yml then a text data file will be saved; otherwise a binary data file will be saved. Note:
In the Load/LoadData, Save/SaveData and RunStatics/RunDynamics/Run commands, if is a relative path then it is taken to be relative to the directory from which the script file was loaded.
ExtendSimulation
Adds a new stage of length . This command is equivalent to the Calculation | Extend Dynamic Simulation menu item. You would normally follow this command with a Run command. Reset
Resets the current model. This command is equivalent to the Calculation | Reset menu item. NewModel
Deletes all objects from the current model and resets data to default values. This command is equivalent to the File | New menu item. Create []
Creates a new object of type . The new object is automatically selected which means that subsequent assignment commands apply to this new object. The parameter can be "Line Type", "Vessel Type", "Line", "Winch" etc. Select Edit | Add from the Model Browser menu to see a list of possible values for this parameter. Alternatively variable data sources can be created by setting the parameter to "Bending Stiffness", "Drag Coefficient" etc. This list of possible variable data source object types can be found in the Data Source Type tree on the variable data form. If the optional parameter is included then the new object will be given that name. Delete