Professional Documents
Culture Documents
Flaresim Modul
Flaresim Modul
The copyright in this manual and its accompanying software are the property of Softbits
Consultants Ltd with all rights reserved. Both this manual and the software have been
provided pursuant to a License Agreement containing restrictions on use.
Softbits Consultants Ltd reserves the right to make changes to this manual or its
accompanying software without obligation to notify any person or organisation.
No part of this manual may be reproduced, transmitted, transcribed, stored in a retrieval
system or translated into any other language in any form or by any means, or disclosed to
third parties without the prior written consent of Softbits Consultants Ltd.
WARRANTY
Softbits Consultants Ltd or its agents will replace any defective manual, program disks
within 90 days or purchase of the product providing that proof of purchase is evident. All
warranties on the disks and manual and any implied warranties are limited to 90 days from
the date of purchase. Neither Softbits Consultants Ltd nor its agents or dealers make any
warranty, implied or otherwise, with respect to the software.
The Flaresim software is intended for use by a qualified engineer. The interpretation of the
results from this software are the sole responsiblity of the user.
Softbits Consultants Ltd shall bear no liability for the loss of revenue or other incidental or
consequential damages arising from the use of this software.
The governing law of this warranty shall be that of England.
ACKNOWLEDGEMENTS
Softbits Consultants Ltd would like to express their gratitude to Mr. John F. Straitz III and
the National Airoil Company and GBA Ltd of Slough for assistance in the development of
some algorithms within the software.
Windows 95, 98, Me, NT, XP are registered trademarks of Microsoft Corporation.
Copyright Softbits Consultants Ltd, 1989, 1990, 2002
Table of Contents
1 Introduction.................................................. 1-1
1.1
1.2
1.3
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Program Overview. . . . . . . . . . . . . . . . . . . . . . 1-6
Documentation Overview . . . . . . . . . . . . . . . 1-11
2 Installation.................................................... 2-1
2.1
2.2
2.3
2.4
4 Interface........................................................ 4-1
4.1
4.2
4.3
4.4
4.5
4.6
4.7
Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Log Panels . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
File Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
About View . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Chart Control Dialog . . . . . . . . . . . . . . . . . . . 4-16
5.3
5.4
Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Component Management View . . . . . . . . . . . 5-13
7 Environment................................................. 7-1
7.1
13.3
13.4
13.5
Noise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-16
Nomenclature . . . . . . . . . . . . . . . . . . . . . . . 13-23
References . . . . . . . . . . . . . . . . . . . . . . . . . 13-25
Introduction
1-1
1 Introduction
Page
1.1
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2
Program Overview . . . . . . . . . . . . . . . . . . . . 6
1.2.1
1.2.2
1.2.3
1.3
Flaresim Objects . . . . . . . . . . . . . . . . . . . . . 6
Object Definition . . . . . . . . . . . . . . . . . . . . . 8
Running a Model . . . . . . . . . . . . . . . . . . . . . 9
Documentation Overview . . . . . . . . . . . . . 11
1-1
1-2
1-2
Introduction
1-3
1-3
1-4
Features
1.1 Features
The following features highlight the main capabilities of Flaresim.
Equally applicable to the design of flare systems for offshore
platforms, gas plants, refineries and chemical plants.
Data may be entered and reported in the users choice of units
and may be converted at any time.
Correlations are available for modelling a range of flare tips
including sonic tips, pipeflare tips and steam or air assisted tips.
For assisted flares the quantity of steam or air required for
smokeless operation can be calculated.
A number of correlations are provided to predict the fraction of
heat radiated from flames of a range of hydrocarbon fluids with
different types of flare tip.
Liquid flaring systems can be handled.
A wide range of algorithms for calculation of thermal radiation.
These include integrated multipoint methods in addition to the
Hajek/Ludwig and Brzustowski/Sommer methods which are
described in the API guidelines for flare system design.
Full three dimensional flame shape analysis with complete flexibility in specification of the location and orientation of multiple
stacks.
A range of options for defining and analysing the noise spectrum
generated by flare systems including user defined spectra.
Ability to define multiple environmental scenarios to allow rapid
evaluation of flare system performance under different wind
speeds and directions.
Multiple stacks/booms which can each have multiple flare tips.
1-4
Introduction
1-5
Calculation of radiation, noise spectrum and surface temperatures at multiple receptor points.
Ability to define multiple receptor grids in multiple planes for
calculation of radiation, noise or surface temperatures.
Plotting of grid results as isopleth contours for sterile area
definition.
Receptor point characteristics for calculating surface temperatures include mass, absorbtivity, emissivity, area, specific heat,
orientation and initial temperature.
Sizing of stack or boom length to meet radiation, noise or surface temperature limits at defined receptor points.
Import of files from previous DOS version of Flaresim.
Quality Assurance options are included in the reports.
Customisable HTML reports
Customisable graphic reports
The wide range of calculation options available within Flaresim may
lead to the possibility of selecting inappropriate correlations for a
particular combination of fluid type and flare system configuration.
While we have tried to prevent the use of the move obvious
problems we have tried to allow flexibility for one off situations.
As with all engineering computer software, Flaresim is a tool which
should not be expected to replace sound engineering judgement.
Softbits Consultants Ltd are always interested in continuing product
development to ensure that Flaresim meets the needs of our clients.
Should you wish to see any feature incorporated in Flaresim, please
feel free to contact us at support@softbits.co.uk. If the request is
reasonable we will endeavour to include it in future releases of the
program.
1-5
1-6
Program Overview
Required object
present
Required object
missing
Optional object
Permanent object
Object data complete
Object data missing
Object ignored
1-6
Introduction
1-7
Fluids
A model can contain multiple fluid objects. Each object describes
the physical properties of a fluid to be flared such as density, lower
heating value, lower explosive limit etc. Fluids may be defined
either by entering bulk properties or by defining the composition of
the fluid to allow calculation of its properties from pure component
data. A single fluid can be flared through multiple tips.
Environments
A model can contain multiple environment objects each of which
describes a combination of wind speed, direction, humidity etc.
Only one environment object can be active for a set of calculations.
Stacks
Multiple stack objects can be defined which may be active or
ignored in any set of calculations. Stack data includes length,
location and orientation. Each stack may support multiple flare tips.
Tips
Multiple tip objects can be defined and set active or ignored in a set
of calculations. Tip data includes tip type and associated calculation
methods, dimensions and stack location data and the flow and
selection of the fluid being flared. Tip objects provide access to
flame shape and other tip specific results.
Receptor Points
Multiple receptor point objects can be defined and then set active or
ignored in a set of calculations. Receptor point data includes
location, characteristics for surface temperature calculation and
constraints for sizing calculations. Receptor point objects provide
access to results calculated for the point.
Receptor Grids
Multiple receptor grid objects can be defined and then activated or
ignored in a set of calculations. Receptor grid data includes
orientation, location and coarseness data as well as characteristics
for surface temperature calculations. Receptor grid objects provide
access to their calculated results including contour plots of radiation,
noise and surface temperature.
1-7
1-8
Program Overview
Assist Fluids
Multiple assist fluid objects may be defined and used by one or more
flare tips. Data includes assist fluid type and calculation method to
be used.
Calculation Options
A single calculation options object defines the correlations to be
used in the calculations. It also provides for selection of a stack to be
sized if required in design calculations.
Component Management
A single component library manager object allows maintenance of
the pure component database.
1-8
Introduction
1-9
1-9
1-10
Program Overview
1-10
Introduction
1-11
1-11
1-12
1-12
Documentation Overview
Installation
2-1
2 Installation
Page
2.1
Installation Requirements . . . . . . . . . . . . . . 3
2.1.1
2.1.2
Package Requirements . . . . . . . . . . . . . . . . 3
System Requirements . . . . . . . . . . . . . . . . . 3
2.2
Installing Flaresim . . . . . . . . . . . . . . . . . . . . 4
2.3
2.4
2.4.1
2.4.2
Full License . . . . . . . . . . . . . . . . . . . . . . . . 17
Demo License. . . . . . . . . . . . . . . . . . . . . . . 18
2-1
2-2
2-2
Installation
2-3
Requirement
Windows 98, Windows Me,
Windows 2000 or Windows XP
15 MB
5 MB
2-3
2-4
Installing Flaresim
2.
3.
4.
5.
2-4
Installation
2-5
Note that if the setup program needs to update your computers version of the Windows Installer component, there may
be a delay before this screen appears.
Figure 2-1, Opening Screen
6.
2-5
2-6
Installing Flaresim
7.
2-6
Installation
2-7
8.
2-7
2-8
Installing Flaresim
9.
2-8
Installation
2-9
10.
2-9
2-10
Installing Flaresim
11.
2-10
Installation
2-11
13.
2-11
2-12
Installing Flaresim
14.
15.
2-12
Installation
2-13
16.
2-13
2-14
2-14
Installation
2.
2-15
3.
Click the
button and use the File Open dialog to search
for and open your license file. For licensed copies of
Flaresim the license file is normally found on your Flaresim
CD. It will have a .LIC file extension. Once you have
selected it, click the Next button that will now be activated.
4.
2-15
2-16
2-16
Installation
2-17
2.
3.
2-18
3.
2-18
Clear all the Locking Criteria check boxes except that for
Disk ID as shown above. Note the Locking Data displayed
at the bottom of the screen. If the Locking Criteria check
Installation
2-19
2-19
2-20
2-20
Getting Started
3-1
3 Getting Started
Page
3.1
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.1.6
3.1.7
3.1.8
3.1.9
3.1.10
3.1.11
3.2
3.2.1
3.2.2
3.2.3
3.2.4
3.2.5
3.2.6
19
19
19
21
22
23
3-1
3-2
3.3
3.3.1
3.3.2
3.3.3
3.3.4
3.3.5
3.3.6
3.3.7
3.4
3.4.1
3.4.2
3.4.3
3.4.4
3.4.5
3.4.6
3.4.7
3.4.8
3.4.9
3.4.10
3-2
Getting Started
3-3
3-3
3-4
18 in
Wind Velocity
20 mph
3.1.2 Preparation
3-4
1.
2.
Since all our data is in field units we will first select this set
of units to work in. Select the File - Preferences menu
option. The Preferences view shown below will appear.
Getting Started
3-5
3.
4.
Now open the Case Summary view using either the View Case Summary menu option or the icon from the toolbar.
The view will show an empty case as shown below.
The
icons indicate that the
there are no objects of that type
defined and that the model is
incomplete.
3-5
3-6
Select the Fluid branch in the Case Summary and click the
Add button to create a new fluid. The fluid view will open.
3-6
6.
7.
8.
9.
10.
11.
Getting Started
The
icon indicates that a
valid object of that type exists.
12.
13.
At this point the status text at the bottom of the view will
show that the data entry is complete. The critical
temperature and critical pressure data will be estimated if
not provided. Close the Fluid view. Note that the Case
Summary view is updated to show the new valid fluid.
3-7
15.
16.
3-7
3-8
17.
18.
19.
20.
At this point the status text should show that the data is
complete. Close the Environment view.
3-8
22.
23.
Getting Started
24.
25.
At this point confirm that the status text is showing that the
form is complete and close the Stack view.
3-9
In the Case Summary view select the Tip branch and click
the Add button to add a flare tip. The following view will
open. Set the tip name to Pipe Tip.
27.
In the Details section, set the Tip Type to Pipe, the Number
of Burners to 1 and the Seal Type to None. A pipe flare is
the simplest and cheapest type of flare so we will use this
for our initial design.
3-9
3-10
28.
29.
3-10
30.
31.
32.
Getting Started
33.
3-11
Next click the Fluids tab to continue setting up the Tip data.
34.
In the Fluid section use the dropdown list to select the Fluid
we defined earlier - Hot Gas Relief. Enter the Mass Flow as
100,000lb/hr.
35.
At this point the status text should indicate that our Tip
definition is complete. Close the Tip view.
3-11
3-12
37.
38.
3-12
Getting Started
3-13
40.
41.
42.
43.
3-14
45.
46.
3-14
Getting Started
3-15
48.
49.
3-15
3-16
Click the
icon to start the calculation running. As the
calculation runs messages will be output to the Error/
Warnings/Info log to show progress as shown below.
Note that the scroll bars can be used to review earlier messages. Also the log window can be resized by dragging the
separator bar above it.
3-16
51.
52.
Getting Started
3-17
53.
3-17
3-18
55.
56.
3-18
When you are happy with the options you have chosen click
the Print button to send the report to your default printer.
Getting Started
3-19
2.
3-19
3-20
4.
On the Details tab of the Tip view that opens enter the
following data:
Name - Sonic Tip
Tip Type - Sonic
Number of Tips - 1
Seal Type - None
Fraction Heat Radiated Method - High Efficiency
Combustion Noise Method - Standard Reference.
5.
6.
3-20
7.
At this point the Status Text at the bottom of the Tip view
should indicate that the tip data is complete. Close the view.
8.
Getting Started
3-21
11.
3-21
3-22
12.
13.
Generate a report for this new case using the File - Print
menu option.
Find the reports you printed for both examples. If you have
not done this you can use your Internet browser to view the
saved report files Example 1 - Result.html in the
Samples\Example 1 - Result sub-folder and Example 2 Result.html in the Samples\Example 2 - Result subfolderin the Flaresim installation folder (usually C:\Program
Files\Flaresim).
15.
3-22
Getting Started
3-23
Still in the Tip Data - Results section of the reports find the
flame length. For the Pipe flare design this is 173 ft. while
for the Sonic flare design the flame length is 88ft. Note that
the flame length calculated by the API method is the same
in both cases.
Sonic flare tips by their design and by their greater gas exit
velocities lead to a flame shape that is shorter and stiffer
compared to that of a pipe flare. As a result the flame is less
affected by wind and stays closer to the tip and thus further
from the platform. This can be seen most clearly by comparing the 3D plot of the Flame Shape in the reports.
Finally in the Tip Results section of the reports find the tip
backpressure i.e. tip inlet pressure. For Pipe flare this is 14.7
psi while for the Sonic flare it is 54.0 psi.
The fact that the sonic tip is operating at choked conditions
means that the pressure drop over this type of tip is much
higher than for the pipe tip. Thus a sonic tip can only be
used if the resulting backpressure on the flare system is not
so high as to prevent safe relief of the gas.
Open the Sonic tip design case (Samples\Example 2 Result.fsw if you do not have you own version saved.
3-23
3-24
3-24
18.
Open the view for the Sonic Tip. On the Location &
Dimensions tab change the burner opening to 25% and run
the case.
19.
Still in the Sonic Tip view, click on the Results tab and
check the Mach Number result. It will be around 0.79.
20.
21.
22.
Getting Started
3-25
2.
3-26
4.
3-26
Getting Started
3-27
7.
Open the Tip view for the Pipe tip. You will see that the
fraction of heat radiated from this tip has been calculated as
0.33 whereas before it was 0.21. The reason for this is the
greatly reduced velocity, 0.02 mach, through the tip which
reduces the tips efficiency. For efficient operation the
velocity should be 0.2 mach or higher.
9.
3-27
3-28
Open the Tip view for the Sonic Tip and go to the Locations
& Dimensions tab. Increase the burner opening from the
indicated 10% to 17%.
11.
Re-run the case. Check the Results tab of the Sonic Tip
view to confirm that the exit velocity is still sonic. If you
wish you can re-run the case at a burner opening of 18% to
confirm that this leads to a sub-sonic exit velocity.
13.
3-28
Getting Started
3-29
15.
Re-run the case. When the run is complete you will be able
to inspect an isopleth plot by opening the grid view, clicking
on the Radiation Tab and then selecting Plot as the Display
option - see Figure 3-18.Note that noise plots and surface
temperature plots are also available.
3-29
3-30
3-30
16.
17.
18.
Getting Started
3-31
12 in
2.
3-32
4.
3-32
Getting Started
6.
3-33
Enter data for the new stack as follows, leaving other entries
at their default values;
Name - Welltest Stack,
Northing - -200ft,
Easting - 0ft,
Elevation - 0ft,
Dimensions section
Length - 55ft,
Angle to Horizontal - 0 deg,
Angle to North - 180 deg.
These entries define our new stack as a horizontal boom on
the opposite side of the platform to our main flare stack.
The completed view is shown as Figure 3-20. Close the
view when complete.
In the Case Summary, select the Tips branch and click the
Add button to create and view a new Tip object.
3-33
3-34
8.
On the Details tab of the Tip view enter the following data;
Name - Welltest Burner,
Tip Type - Welltest,
Number of Burners - 3,
Fraction Heat Radiated Method - User Specified
Specified Fraction Heat Radiated - 0.3
All other values should be left at their defaults.
9.
10.
3-34
Getting Started
3-35
13.
14.
15.
16.
3-35
3-36
18.
3-36
19.
20.
Run the new case and inspect the results. The radiation
value at the base of the welltest burner stack has been
reduced to an acceptable value of 427 btu/hr/ft2.
Getting Started
3-37
Open the view for the Base Welltest Stack receptor point.
Update the Properties data for the point as follows;
On Plane - None,
Emissivity - 0.7,
Absorbtivity - 0.7,
Area Ratio - 2.0,
Mass - 10.4 lb/ft2,
Mass Cp - 0.1075 btu/lb/ft.1002,
Initial Temperature - 60F.
This data represents a steel plate, 0.25in thick. The Area
Ratio of 2.0 indicates that one side of the plate is exposed to
the flare radiation. Selecting None as the On Plane value is a
conservative assumption that means that no credit will be
taken for radiation striking the plate at an angle.
22.
23.
3-37
3-38
Select the Main Stack in the Case Summary view and click
the Activate button to restore it to the calculations. Run the
model again.
25.
3-38
Interface
4-1
4 Interface
Page
4.1
Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
4.2
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.3
Tool Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.4
Log Panels . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.5
File Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.5.1
4.5.2
4.5.3
4.5.4
4.6
About View . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.7
4-1
4-2
4-2
Interface
4-3
The Flaresim interface has been designed to give you a great deal of
flexibility in the way in which you enter, modify and view the data
and results which comprise your flare model. This chapter describes
the various components of the Flaresim interface. If you need help
with any particular task, the on-line help can give you step-by-step
instructions.
4.1 Terminology
The following view of the Flaresim screen shows most of the
interface components that you will encounter. The terminology used
to describe these components is given here.
Figure 4-1, Flaresim Screen
Toolbar
Menu bar
Edit box
Tabs
Active button
Radio button
View
Greyed button
Status text
Value with
Units
Popup menu
Dropdown
List Box
Checkbox
File Management
Log
Scrollbars
Error/Warnings/
Info Log
Menu Bar
The menu bar provides access to the various program functions. The
options are described in more detail in section 4.2.
4-3
4-4
Terminology
Tool Bar
The tool bar is a row of icons that provide quick access to the more
commonly used program functions. The options are described in
more detail in section 4.3.
File Management Log
This area of the screen displays a record of file saving and retrieval
activity. See section 4.4 for more information.
Errors / Warnings / Info Log
This area of the screen displays a record of error messages, warning
messages and other information generated by Flaresim calculations.
See section 4.4 for more information.
Throughout the manual,
Clicking a button or other item
means using the Left mouse
button unless stated otherwise.
Active Button
Buttons appear on most forms and may be clicked with the left
mouse button to perform the action indicated. Active buttons are
those where the label type is black.
Greyed Button
Buttons which have an action that cannot be performed at a
particular time are displayed with the label type in grey.
PopUp Menu
PopUp menus are used to display additional choices in response to
clicking buttons or clicking the right mouse button.
View
This is the term used to describe a window containing a group of
data entry fields for a specific element of the program. Views in
Flaresim are generally non-modal which means that multiple views
can be open and used at the same time.
Views may be resized, minimised, maximised and moved around
within the Flaresim application workspace in the same way as
standard windows.
Status Text
Many views have a status field at the bottom to provide a quick
indication whether all the necessary entries have been made. The
4-4
Interface
4-5
4-6
Menu Bar
4-6
Interface
Main Menu
File
View
Sub Menu
4-7
Description
New
Open
Save
Save As
Print Graphic
Reports
Print Setup
Preferences
Exit
Recent files
Case
Summary
Case Details
Fluid
Environment
Stack
Tip
Assist Fluid
Receptor Point
Receptor Grid
Calculation
Option
Component
Management
4-7
4-8
Menu Bar
Main Menu
Add
Window
Help
4-8
Sub Menu
Description
Fluid
Environment
Stack
Tip
Assist Fluid
Receptor Point
Receptor Grid
Cascade
Close All
Contents
Index
About
Interface
4-9
4-9
4-10
Log Panels
The log panels at the bottom of the Flaresim main window are used
to output messages from the program. There are two panels.
The left panel is known as the File Management Log and records
details of file creation, file retrieval and file saving actions.
The right panel is known as the Errors/Warnings/Info Log and
records messages generated by Flaresim as it calculates.
The size of the log panels can be set by moving the cursor to the top
boundary of the panels or the boundary between the panels. At the
point where the cursor changes to a pair of resizing arrows, the left
mouse button may be clicked and dragged to resize the panel.
Both panels provide a popup menu with local options that can be
opened by clicking the right mouse button.
In the File Management Log this popup menu provides a single
option:
Clear - clears all messages from the log.
In the Errors/Warnings/Info Log, the popup menu provides the
following options:
Clear - clears all messages from the log.
Verbose - sets verbose mode so that all messages will be output. A
tick will appear against the menu option to show that verbose mode
is selected.
Save Messages - displays a standard file dialog to allow the current
message list to be saved to an external log file.
4-10
Interface
4-11
File List
4-12
File Dialogs
Save As Type
Dropdown List of allowed file types
Allows you to select the required file type.
File Description
Model Files
Allowed Types
Flaresim for Windows files .FSW
XML data files .XML
Table Export
Graphics Export
Save In
Dropdown List of available storage locations
Allows you to select from the list of available storage locations
configured for your computer system.
File List
List Box
Shows the files and folders in the current folder. The list may be
used to navigate the folder tree or to select files.
Folders can be opened and made the new current folder by double
clicking on them. You can move up the folder tree by clicking the
Previous Folder icon. New folders can be created by clicking the
New Folder icon and entering the new folder name in the File List.
Files can be selected for overwriting by clicking on them.
Save
Button
Saves the file once you have entered the name or selected a file to
overwrite. If the file selected already exists you will be asked to
confirm that it should be overwritten.
4-12
Interface
4-13
Cancel
Button
Cancels the file save.
Previous Folder Icon
Moves up the folder tree. The File List will be updated to show the
contents of the folder one level up the tree.
New Folder Icon
Creates a new sub-folder in the current folder. The folder will be
created with the default name New Folder and you will then be
able to rename as required.
The elements of this dialog are essentially the same as the File Save
Dialog with the exception that the Save button is replaced by an
Open button.
4-13
4-14
File Dialogs
If you wish to open a .FSM file from the previous DOS version of
Flaresim use the Files of Type drop down to select the .FSM file
type.
4-14
Interface
4-15
4-15
4-16
4-16
General Setup
5-1
5 General Setup
Page
5.1
5.2
5.3
Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.3.1
5.3.2
5.4
Units Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Files Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
5-1
5-2
5-2
General Setup
5-3
The Case Summary view shows the Flaresim model as a tree with
the branches showing the different types of object that make up the
model.
The Case Summary is used by clicking a branch of the tree to select
it and then clicking one of the command buttons to perform that
action on the selected object. If a branch with sub-branches is
selected a popup menu will be displayed to ask which of the subbranches the command will apply to. For example in the case shown
as Figure 5-1 clicking on the Tip branch and selecting View will
display a popup menu asking which of the two existing tips is to be
viewed. A branch can also be double-clicked which will act the same
way as the View action.
5-3
5-4
General Setup
5-5
5-5
5-6
Title
Text
Text entered in this field will be printed as the model title on reports.
Author
Text
Identifies the author of this Flaresim file.
Revision
Text
Identifies the revision of the Flaresim file.
Checked By
Text
Identifies the person responsible for checking the model.
5-6
General Setup
5-7
Case Description
Text
Descriptive information relevant to the model. For example it is
good practice to note sources of environmental data and the
contingencies represented by the fluid data.
Last Modified
Calculated Text
Tracks the date that the model was last updated. It is automatically
updated each time the model is saved and cannot be manually
updated.
5-7
5-8
Preferences
5.3 Preferences
The File - Preferences menu item provides access to the
Preferences View to allow setup of the preferred units and file
locations.
Figure 5-3, Units Tab
5-8
General Setup
5-9
5-9
5-10
Preferences
5-10
General Setup
5-11
5-11
5-12
Preferences
5-12
General Setup
5-13
5-13
5-14
Mole Weight
Range: 2 to 1000
The molecular weight of the component.
LHV
Range: 0 to 200MJ/kg
The net, or lower heating value of the component. It is a common
error in the design of flare systems to use the gross heating value.
For most hydrocarbon components this value will be of the order of
46 MJ/kg
Cp / Cv
Range: 1.01 to 5.0
The ratio of the specific heat capacities of the component. If the
value is unknown we would recommend using a value of 1.2.
Saturation
Range: 0 to 100%
The percentage saturation of the component.
LEL
Range: 0.0 to 100.0%
The lower flammability limit of the component as a volume
percentage.
Critical Temperature
Range: 10 to 10,000 K
The critical temperature of the component.
5-14
General Setup
5-15
Critical Pressure
Range: 0.01 to 1,000 bara
The critical pressure of the component.
Once the component property data has been defined click the
Accept Component Data button to complete definition of the new
component. If for any reason you wish to abandon creation of a new
component at the property data entry stage then click the Cancel
Component Entry button.
Components that have been added by the user may be updated by
selecting it in the list and clicking the Edit Component Data button.
This option is not available for components from the Flaresim
database.
To remove a component from the library, select it in the list and click
the Remove Selected Component button.
5-15
5-16
5-16
Fluids
6-1
6 Fluids
Page
6.1
Fluid View . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
6.1.1
6.1.2
6.1.3
6.2
Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
Properties Tab . . . . . . . . . . . . . . . . . . . . . . . 4
Composition Tab . . . . . . . . . . . . . . . . . . . . . 7
6-1
6-2
6-2
Fluids
6-3
6-3
6-4
Fluid View
6-4
Fluids
6-5
Temperature
Range: 10 to 1000K
The temperature of the fluid at the tip exit. Note that this is the
temperature of the fluid at the defined reference pressure.
If either a Steam or Air assisted flare tip is being used this
temperature is the fluid temperature before mixing with the steam or
air flow.
Ref. Pressure
Range: 100 to 2000000 Pa
The reference pressure at which the fluid temperature is defined.
The fluid temperature will be corrected from this pressure to other
pressures assuming adiabatic compression/expansion if the
adiabatic temperature correction calculation option is set.
Mole Weight
Range: 2 to 1000
The molecular weight of the fluid being flared.
LHV
Range: 0 to 200MJ/kg
The net or lower heating value of the fluid. It is a common error in
the design of flare systems to use the gross heating value of the fluid.
We are interested in the net heat released by the flame.
For most hydrocarbon fluids without inerts this value will be of the
order of 46 MJ/kg.
Cp / Cv
Range: 1.0 to 5.0
This field defines the ratio of the specific heat capacities of the fluid.
It is only required and used when the fluid is a vapour.
If the value is unknown we would recommend using a value of 1.2.
Saturation
Range: 0 to 100%
The percentage of saturated hydrocarbon molecules in the fluid on a
mole basis. This is used by the Flaresim method for estimation of the
6-5
6-6
Fluid View
6-6
Fluids
6-7
6-7
6-8
Fluid View
6-8
Fluids
6-9
Name
Text
Enter a name to identify this assist fluid.
Status Text
Status message
The message displayed in this field and its colour indicates whether
the data for this Assist Fluid object is complete and ready for
calculation.
Type
Dropdown list: Air / Steam/Water
Selects the type of assist fluid to be used. Steam/Water indicates that
Steam will be used with vapour flares and Water with liquid flares.
Apply Correction To Fraction Heat Radiated
Checkbox
If selected, Flaresim will calculate a correction to the fraction of heat
radiated by the flame resulting from the assist fluid.
6-9
6-10
Smokeless Method
Dropdown list: Flaresim/API/UserRatio
Selects the method to be used by Flaresim to calculate the flow of
assist fluid required for smokeless operation. The Flaresim method
is a propriatory correlation supplied by National Air Oil. The API
method is the method described in API RP521. The UserRatio
allows the user to specify the flow ratio of assist fluid required for
smokeless operation.
The validity of these options varies with the type of assist fluid
selected.
Air
The allowed methods are Flaresim and UserRatio. If
the API method is selected an error message will
displayed when the model is calculated.
Steam/Water Any of the allowed methods may be used.
6-10
Fluids
6-11
6-11
6-12
6-12
Environment
7-1
7 Environment
Page
7.1
Environment View . . . . . . . . . . . . . . . . . . . . 4
7-1
7-2
7-2
Environment
7-3
7-3
7-4
Environment View
Name
Text
A descriptive name to identify this Environment object.
Ignored
Checkbox
Clear to select this Environment object for calculations or set it to
ignore this Environment object. Only one Environment can be active
for calculations so clearing the ignored check box on an
Environment object will automatically check it on all the other
Environments in the mode.
Wind - Speed
Range: 0 to 100 m/s
A constant wind speed is assumed. In theory the windspeed varies
with elevation. However in order to simplify the calculation of the
flame profile this variation is ignored. This is justifiable due to the
accuracy limitations inherent in the flame shape calculations.
7-4
Environment
7-5
mph
ft/s
m/s
Beaufort
Scale
0.0
0.0
0.0
2.3
3.3
1.0
4.6
6.6
2.0
9.2
13.5
4.1
12
13.8
20.3
6.2
18
20.7
30.5
9.3
24
27.6
40.7
12.4
28
32.2
47.2
14.4
34
39.1
57.4
17.5
40
46.0
67.6
20.6
Wind - Direction
Range: 0 to 360 from North
The direction from which the wind blows. Generally the worst or
most prevalent wind direction can be determined by examination of
the wind rose for the site in question.
Atmosphere - Temperature
Range: 10 to 500K
The ambient temperature of the atmosphere is used in the calculation
of the equilibrium surface temperatures of metallic surfaces exposed
to the flares thermal radiation.
Atmosphere - Humidity
Range: 4 to 100%
The relative humidity defines the water content of the atmosphere in
terms of the partial pressure of water vapour in the air relative to the
vapour pressure of water at the same temperature. Standard charts
are available relating the wet and dry bulb temperature
7-5
7-6
Environment View
Solar Radiation
(W/m2)
475-630
945
630-790
7-6
Environment
Intensity (dB)
7-7
Situation
Threshold of hearing
10
Virtual silence
20
Quiet room
30
Watch ticking at 1m
40
Quiet street
50
Quiet conversation
60
Quiet motor at 1m
70
Loud conversation
80
Door slamming
90
100
110
Pneumatic drill
120
130
Threshold of pain
Transmissivity - Method
Options: User/Calculated
The value for the atmospheric transmissivity may be either specified
by the user or estimated as a function of the relative humidity at the
site and the distance of the receptor from the flame. The correlation
used is valid for distances between 30-60 m and for relative
humidities greater than 10%. Outside of these ranges the correlation
may still give acceptable results.
Calculated atmospheric transmissivities should not be selected if
you are modelling hydrogen or hydrogen sulphide flares which burn
with little or no luminous radiation.
If User is selected the value for the atmospheric transmissivity must
be entered.
7-7
7-8
Environment View
If Calculated is selected the value for the relative humidity at the site
must be entered.
Transmissivity - Value
Range: 0.1 to 1.0
Atmospheric transmissivity defines the degree of attenuation of the
thermal radiation due to atmospheric conditions. It is expressed as
the fraction of the radiation which is received at the receptor point.
A value of 1.0 should normally be taken unless exceptional
circumstances are deemed applicable. If the location is protected by
a water curtain or sprays we would recommend a value of 0.3 to
model the reduced transmissivity.
7-8
Stacks
8-1
8 Stacks
Page
8.1
Stack View. . . . . . . . . . . . . . . . . . . . . . . . . . . 4
8-1
8-2
8-2
Stacks
8-3
8-3
8-4
Stack View
Name
Text
Enter text to identify this stack object.
Ignored
Checkbox
Clear to include this stack in the calculations or set to ignore this
stack when calculating. The effect of this will be to ignore all of the
tips that are located on this stack.
Status Text
Status message
The message displayed in this field and its colour indicates whether
the data for this stack object is complete and ready for calculation.
Location - Relative To
Drop down list of existing locations
Allows the location of the stack base to be defined relative to another
object in the model, for example another stack. If left blank the
location is relative to the base point of the model at 0,0,0.
8-4
Stacks
8-5
The following fields then define the location of the stack base
relative to this location in either cartesian or polar coordinates.
Location - Northing
Range: -100,000 to 100,000m
The distance of the base of the stack North of the selected reference
location. Updates made to this value will automatically update the
polar coordinate values.
Location - Easting
Range: -100,000 to 100,000m
The distance of the base of the stack East of the selected reference
location. Updates made to this value will automatically update the
polar coordinate values.
Location - Elevation
Range: -100,000 to 100,000m
The distance of the base of the stack above or below the selected
reference location. Updates made to this value will automatically
update the polar coordinate values.
Location - Radius
Range: 0 to 100,000m
The distance to the base of the stack from the selected reference
location. Updates made to this value will automatically update the
cartesian coordinate values.
Location - Angle to Horizontal
Range: 0 to 90
The angle to the horizontal of a line from the base of the stack to the
selected reference location. Updates made to this value will
automatically update the polar coordinate values.
Location - Angle from North
Range: -180 to 180
The angle from North of a line from the base of the stack to the
selected reference location. Updates made to this value will
automatically update the polar coordinate values.
8-5
8-6
Stack View
Dimensions - Length
Range: 0 to 500m
The centre line length of the stack from the base to the tip support
platform. If the stack is selected for sizing this value will be ignored.
Dimensions - Angle to Horizontal
Range: 0 to 90
The orientation of the stack relative to the horizontal.
Horizontal stacks (0 ) are usually used for liquid flares on offshore
platforms. Angled booms (30 , 45 , 60 ) stacks are commonly
used for gas flares on offshore platforms. Vertical stacks (90 ) will
be used for most onshore installations.
Dimensions - Angle from North
Range: 0 to 360
The orientation of the stack relative to North. Flaresim works on a
360 compass base thus 90 corresponds to a stack or boom
pointing due East, 180 to due South etc.
It is important to set the direction of the stack correctly relative to the
wind direction since this will have a significant impact on the
results. For most design purposes, specifying both the stack angle
from North as 0 and wind direction as 0 will give a flame blowing
back along the stack axis which will generally give the worst case
radiation values for design of the installation.
8-6
Tips
9-1
9 Tips
Page
9.1
Tip View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
9.1.1
9.1.2
9.1.3
9.1.4
9.1.5
9.1.6
9.1.7
Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
Details Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Location & Dimensions Tab . . . . . . . . . . . .11
Fluids Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Results Tab . . . . . . . . . . . . . . . . . . . . . . . . . 15
Noise Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Flame Shape Tab . . . . . . . . . . . . . . . . . . . . 20
9-1
9-2
9-2
Tips
9-3
The Tip object allows definition of data to describe each flare tip. A
flare tip acts as the disposal point for a single fluid. Multiple flare
tips on one or more stacks may be present in a flare system to dispose
separately of fluids due to incompatible properties e.g. warm and
cold fluids, high and low pressure fluids, dry and wet fluids.
Tip objects may be created using the Add-Tip menu option or by
selecting the Tip branch in the Case Summary view and clicking
the Add button.
An existing Tip object may be viewed by selecting it from the View
- Tip menu option, by double clicking it in the Case Summary view
or by selecting it in the Case Summary view and clicking the View
button.
All defined Tip objects will be included in the calculations unless
they have been set to Ignored. A Tip may be set to ignored by
selecting it in the Case Summary view and clicking the Ignore
button. An Ignored Tip object can be restored to the calculations by
selecting it in the Case Summary view and clicking the Activate
button. Alternatively a Tip object can be ignored and restored by
setting or clearing the check box on its view.
A Tip object can be deleted either by clicking the Delete button on
its view or by selecting it in the Case Summary view and clicking
the Delete button on this view.
9-3
9-4
Tip View
9-4
Tips
9-5
Ignored
Checkbox
Clear to include this tip in the calculations or set to ignore this tip
when calculating.
9-5
9-6
Tip View
Opening
Diameter
9-6
Tips
9-7
Figure 9-3 shows the general design concept for the molecular seal.
The type selection is a function of the diameter as defined below:Molec.1:
Traditional design. Maximum diameter is 1.7 times
the tip diameter. The pressure drop correlation is
based on a design which gives a body length of 5.5m
(18ft) regardless of the tip diameter.
Molec.2:
Low pressure drop design. Maximum diameter is 2
times the tip diameter. The pressure drop correlation
is based on a design which gives a body length which
is a function of the tip diameter.
Figure 9-3, Molecular Seal
Diameter
9-8
Tip View
E = 0.048 MW
Kent:
9-8
Tips
9-9
9-10
Tip View
Peak Frequency
Dropdown list: 62.5, 125, 250, 500, 1000, 2000 Hz
This defines the sound frequency band at which the peak noise is
generated. The total sound power calculated at this frequency will be
distributed across the other sound frequency bands.
Efficiency
Range 1.0e-6 to 1.0e-2 %
The efficiency at which combustion energy is converted to sound
power.
The Low Noise Reference and Standard Reference methods use
proprietary data supplied by a flare system vendor. Selecting a User
Reference method displays the Reference Duty and Sound Power
Table fields described below.
Figure 9-5, User Reference Spectrum
9-10
Tips
9-11
9-11
9-12
Tip View
Dimensions - Length
Range: 0 to 200m
The physical length of the burner tip. The value is used in calculating
the true gas exit point for the case of a vertical flare tip on an inclined
boom.
Dimensions - Angle to Horizontal
Range: 0 to 90
The orientation of the tip relative to the horizontal.
Vertical installation of flare tips prevents burnback on the tip and
consequent reduction in tip life. The use of inclined tips on inclined
booms does have the advantage of directing both the flame and any
liquid carryover away from the main platform structure.
Dimensions - Angle from North
Range: 0 to 360
The orientation of the tip relative to the North.
It is not unusual in offshore flares for the tip to be oriented along a
different axis to the boom.
Dimensions - Diameter
Range: 0.001 to 10m
The internal diameter of the burner assembly.
For sonic flares the equivalent diameter is calculated for resolution
of the fluid jet vectors when calculating the flame shape.
Dimensions - Effective Area
Range: 0.0001 to 100%
The actual percentage of the area calculated from the tip diameter
which is available for flow of the gas or liquid.
A value of 100% is generally used for pipe flares. For sonic flares
the value should be adjusted to ensure that the exit velocity is just
sonic at the design flare rate. For liquid burners the value should be
adjusted to calculate the correct exit velocity.
9-12
Tips
9-13
9-13
9-14
Tip View
Fluid - Name
Drop Down List: Defined Fluids
Allows one of the defined fluids in your model to be assigned to the
flare tip
Fluid - Mass Flow
Range: 0 to 10,000 kg/s
The flowrate of the fluid fed to this tip.
Secondary Fluid - Name
Drop Down List: Defined Fluids
Allows one of the defined fluids in your model to be assigned to LP
flare tip of a Combined HP/LP tip.
Secondary Fluid - Mass Flow
Range: 0 to 10,000 kg/s
The flowrate of the fluid fed to the LP tip of a Combined HP/LP tip.
9-14
Tips
9-15
9-15
9-16
Tip View
9-16
Tips
9-17
9-18
Tip View
9-18
Tips
9-19
Display
Dropdown list: Table / Plot
Selects whether the noise spectrum results are displayed as a table or
as a graph.
Noise Spectrum
Calculated Values
This table or graph shows the noise generated as a function of the
sound frequency. The results show the contribution from
combustion noise and jet noise as well as the total noise at each
defined frequency.
The graph option can be customised using the pop-up menu
displayed by clicking the Right mouse button. The plot option
customisation options are described in a dedicated help file.
Export
Button
Allows the noise spectrum data to be saved. If the noise spectrum is
currently displayed as a table, a standard file dialog box will be
displayed to allow the data to be saved as a CSV file. If the data is
displayed as a plot it may be saved as a graphics file. A standard file
dialog box will appear to allow the name and file type to be entered.
The allowed file types are JPG, PNG, BMP, WMF or EMF.
9-19
9-20
Tip View
Display
Dropdown list: Table / 3D Plot / 2D Plot - North vs. East / 2D Plot
- North vs. Elevation / 2D Plot - East vs. Elevation
Allows selection of the display method for the flame shape results.
The flame shape is calculated using the calculation method and
number of elements specified by the user in the Calculation
Options view.
The various plot options can be customised using the pop-up menu
displayed by clicking the Right mouse button. The plot option
customisation options are described in a dedicated help file.
Export
Button
Allows the flame shape data to be saved to an external file. If the
data is displayed as a table it may be saved to a CSV file. If it is
9-20
Tips
9-21
9-21
9-22
9-22
Tip View
Receptors
10-1
10 Receptors
Page
10.1 Receptor Point View . . . . . . . . . . . . . . . . . . 4
10.1.1
10.1.2
10.1.3
10.1.4
Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
Point Definition Tab . . . . . . . . . . . . . . . . . . . 5
Thermal Results Tab. . . . . . . . . . . . . . . . . . . 9
Noise Results . . . . . . . . . . . . . . . . . . . . . . . 10
Common Fields . . . . . . . . . . . . . . . . . . . . .
Grid Details Tab . . . . . . . . . . . . . . . . . . . . .
Radiation Tab . . . . . . . . . . . . . . . . . . . . . . .
Noise Tab . . . . . . . . . . . . . . . . . . . . . . . . . .
Temperature Tab . . . . . . . . . . . . . . . . . . . .
Isopleth Tab . . . . . . . . . . . . . . . . . . . . . . . .
Plot Overlay Tab . . . . . . . . . . . . . . . . . . . . .
Graphic Report Tab . . . . . . . . . . . . . . . . . .
13
14
16
17
18
19
21
21
26
27
30
32
34
10-1
10-2
10-2
Receptors
10-3
Receptors are the points at which Flaresim will calculate the thermal
radiation, noise and surface temperatures resulting from the
operation of one or more flare tips. Flaresim provides the ability to
define Receptor Point objects which define a single point for the
calculations and Receptor Grid objects which define a plane of
points.
Receptor Point objects may be created using the Add-Receptor
Point menu option or by selecting the Receptor Points branch in the
Case Summary view and clicking the Add button.
An existing Receptor Point object may be viewed by selecting it
from the View - Receptor Point menu option, by double clicking it
in the Case Summary view or by selecting it in the Case Summary
view and clicking the View button.
Receptor Point objects will be calculated unless they have been set
to Ignored. A Receptor Point may be set to ignored by selecting it
in the Case Summary view and clicking the Ignore button.or
restored to the calculations clicking the Activate button.
Alternatively a Receptor Point object can be ignored and restored
by setting or clearing the check box on its view.
A Receptor Point object can be deleted either by clicking the Delete
button on its view or by selecting it in the Case Summary view and
clicking the Delete button on this view.
Receptor Grid objects may be created using the Add-Receptor
Grid menu option and viewed the through the View-Receptor Grid
menu option. A Receptor Grid can be deleted using the Delete
button on its view. Alternatively a Receptor Grid can be created,
viewed or deleted using the Case Summary view in the usual way.
Like receptor points, Receptor Grid objects will be calculated
unless they have been set to Ignored. Receptor Grid objects can be
ignored and restored though the check box on the Receptor Grid
view or through the Case Summary view.
10-3
10-4
10-4
Receptors
10-5
Ignored
Checkbox
Clear to calculate the results for this Receptor Point or set to ignore
this point when calculating.
10-5
10-6
Location - Radius
Range: 0 to 100,000m
The distance to the receptor point from the selected reference
location. Updates made to this value will automatically update the
cartesian coordinate values.
Location - Angle to Horizontal
Range: 0 to 90
The angle to the horizontal of a line from the receptor point to the
selected reference location. Updates made to this value will
automatically update the polar coordinate values.
Location - Angle from North
Range: 0 to 360
The angle from North of a line from the receptor point to the selected
reference location. Updates made to this value will automatically
update the polar coordinate values.
Properties - On Plane
Dropdown list: None / Northing-Easting / Northing-Elevation /
Easting-Elevation
Selects the orientation of the receptor point and is used to calculate
the angle of incidence of the thermal radiation on the receptor.
Setting the On Plane entry to None means that no correction for
angle of incidence will be applied.
Properties - Emissivity
Range: 0.0001 to 1.0
The emissivity of the point which will be used in the heat balance
calculations to determine surface temperature. The emissivity is
used to calculate the radiative heat loss from the receptor point.
A typical value for steel is 0.7.
Properties - Absorbtivity
Range: 0.0001 to 1.0
The absorbtivity of the point which will be used in the heat balance
calculations to determine surface temperature. It is the fraction of the
radiation incident on the point that will be absorbed. A typical value
for steel is 0.7.
10-6
Receptors
Incident radiation
10-7
Heat Loss
E.g. A plate would have an
arearatio of 2.0.
Properties - Mass
Range: 0 to 1,000,000 kg
The mass at the point to be used in the calculation of the rate of
surface temperature rise.
Properties - Mass Cp
Range: 0.1 to 10,000 J/kg/K
The mass specific heat capacity of the material at the point to be used
in the calculation of the rate of surface temperature rise.
Properties - Initial Temperature
Range: 10 to 1000 K
The initial temperature of the receptor point.
Sizing Constraints - Radiation
Range: 0 to 100,000 W/m2
The maximum thermal radiation to be allowed at this point when
performing sizing calculations.
The following table provides typical values for design levels of
radiation at different locations.
10-7
10-8
Design
Radiation
W/m2
Conditions
15,780
9,470
6,310
4,730
1,890
At design flare release on the helideck of an offshore platform. This value is suggested by the Civil Aviation Authority. Above this value the possibility of distortion of the
aluminium helicoptor airframe and rotors exists.
1,390
10-8
Receptors
10-9
10-9
10-10
10-10
Receptors
10-11
SPL
Calculated Value
The total sound power level at the receptor point. It is calculated by
summing the sound power contributions at each frequency.
SPLA
Calculated Value
The A-weighted sound power level calculated at the receptor point.
It is calculated by summing the A-weighted sound power levels at
each frequency.
Average SPL
Calculated Value
The sound power level averaged across all the frequencies.
Display
Dropdown: Table / Plot
Selects whether the sound power levels vs. frequency results are
displayed as a table or as a graph.
When displayed as a graph, the appearance of the graph may be
customised using the options from a pop-up menu that is accessed
by clicking the Right Mouse button on the plot.
Export
Button
Allows the calculated sound power vs. frequency results to be
exported to a file. If the data is displayed as a table it may be
exported to a CSV file. If displayed as a graph it may be exported to
a JPG, PNG, BMP, WMF or EMF graphics file. In either case a
standard file dialog box will appear to allow the name and file type
to be entered.
10-11
10-12
10-12
Receptors
10-13
10-13
10-14
Ignored
Checkbox
Clear to calculate the results for this Receptor Grid or set to ignore
this grid when calculating.
10-14
Receptors
10-15
Max
Range: -100,000 to 100,000 m
The maximum extent of the grid in the labeled direction.
Number of Points
Range: 1 to 501
The number of increments that the distance between the minimum
and maximum extents will be divided into.
Receptor Properties - On Plane
Dropdown list: None / Northing-Easting / Northing-Elevation /
Easting-Elevation
The orientation of the receptor and is used to determine the
correction to be applied due to the angle of incidence of the receptor
to the flare. If it is set to None, no correction for angle of incidence
will be applied.
Receptor Properties - Emissivity
Range: 0.0001 to 1
The emissivity of each point in the grid which will be used in the
heat balance calculations to determine surface temperature.
Typical value for steel is 0.7
Receptor Properties - Absorbtivity
Range: 0.0001 to 1.0
The absorbtivity of each point in the grid which will be used in the
heat balance calculations to determine surface temperature. This is
defined as the fraction of thermal radiation striking a surface that
will be absorbed.
Typical value for steel is 0.7.
Receptor Properties - Area Ratio
Range: 0.0001 to 10,000
The ratio of the area of the receptor available for losing heat to the
area of the receptor exposed to the flare. For a flat plate with one face
exposed to the flare the Area Ratio would be 2.0.
10-15
10-16
Display
Dropdown: Table / Plot
Selects whether the thermal radiation results are displayed as a table
or as a graph.
When displayed as a graph, the appearance of the graph is controlled
by settings in the file Preferences.XML.
Export
Button
Allows the calculated thermal radiation results to be exported to a
file. If the data is displayed as a table it may be exported to a CSV
file. If displayed as a graph it may be exported to a JPG, PNG, BMP,
10-16
Receptors
10-17
WMF or EMF graphics file. In either case a standard file dialog box
will appear to allow the name and file type to be entered.
Display
Dropdown: Table / Plot
Selects whether the sound power results are displayed as a table or
as a graph.
When displayed as a graph, the appearance of the graph is controlled
by settings in the file Preferences.XML.
10-17
10-18
Export
Button
Allows the calculated sound power results to be exported to a file. If
the data is displayed as a table it may be exported to a CSV file. If
displayed as a graph it may be exported to a JPG, PNG, BMP, WMF
or EMF graphics file. In either case a standard file dialog box will
appear to allow the name and file type to be entered.
Display
Dropdown: Table / Plot
Selects whether the temperature results are displayed as a table or as
a graph.
10-18
Receptors
10-19
Isopleth - Radiation
Range: 1 to 10000 W/m2
10-19
10-20
Receptors
10-21
Save As Defaults
Button
This saves the current set of isopleth definitions to be the defaults
that will be used whenever a new Receptor Grid is created or when
the Reset Defaults button is clicked.
After the defaults have been changed the following dialog box will
appear to ask if the current set of isopleth definitions should be saved
to the preferences file. Clicking Yes in this dialog will save the
current isopleth definitions to be used as the defaults in future
Flaresim models. Clicking No will change the defaults for this
session only. Note that any other changes made to the preferences
file will also be saved.
Figure 10-11, Save Isopleth Definitions
10-22
Variable
Dropdown List
Selects the variable to be plotted on the graphic report - Radiation,
Noise or Temperature.
Contour Method
Dropdown List: Linear / Cubic / BSpline
Selects the method used to generate the isopleth curves from the
receptor grid data points.
The Linear option uses the least interpolation and as a result the
points generated will be in closest agreement to the data values in the
grid. However this may result in more jagged looking isopleth
curves if a coarse receptor grid is used i.e. fewer points are
calculated. The BSpline method offers the smoothest curves if a
coarse grid is used but individual points on the curves may not show
such good agreement with the original grid results. The Cubic
method offers an alternative smoothing method.
10-22
Receptors
10-23
10-23
10-24
10-24
Receptors
10-25
10-25
10-26
Overlay Editor
10-26
Receptors
10-27
Lock To Grid
Check Box
If this check box is set the dimensions of the plot overlay are
automatically set to be the same as those of the receptor grid. The X
Axis Min and Max fields and the YAxis Min and Max fields will be
automatically set to the correct values and will become read only
values. If there is an existing drawing that exceeds the dimensions of
the receptor grid it will be effectively clipped to the receptor grid
dimensions even though some objects may appear outside the
boundaries of the grid.
Show Overlay
Check Box
If this check box is set the overlay graphic currently in the overlay
editor will be displayed as the background for the isopleth plots on
the Radiation, Noise and Temperature tabs and on any graphic
reports displayed or printed.
Show Stacks
Check Box
If this check box is set the overlay graphic will draw the stacks and
tips in the overlay graphic to act as guides for other drawing actions.
Clearing the check box clears the stack and tip elements. This setting
is not saved.
10-28
Overlay Editor
10-28
Receptors
10-29
10-29
10-30
Overlay Editor
10-30
Receptors
10-31
Line Style
This displays the following dialog to allow the line width and line
style to be selected. Enter the line width required and select the line
style from the dropdown list then click Ok. The selected style
applies to individual line objects, polyline objects and the outside
lines for rectangle, rounded rectangle, ellipse and polygon objects.
Figure 10-20, Line Style Selection
Fill Colour
This displays the standard windows Colour Selection Dialog as
shown above. The selected colour applies to the interior of rectangle,
rounded rectangle, ellipse and polygon objects.
Fill Style
This displays the following dialog. Select the Fill style from the drop
down list and click Ok. The selected fill style applies to the interior
of rectangle, rounded rectangle, ellipse and polygon objects.
Figure 10-21, Fill Style Selection
Background Colour
This displays the standard windows Colour Selection Dialog as
shown above. The selected colour applies background colour of the
plot.
Text Colour
This displays the standard windows Colour Selection Dialog as
shown above. The selected colour applies to the text objects.
10-31
10-32
Overlay Editor
Text Font
This displays a standard windows Font Properties Dialog as shown
below. Select the font name, size and style and click Ok. Note that
the font size selected has to be scaled for use on the overlay and so
a given point size may not display with the exact height requested.
Figure 10-22, Font Properties Dialog
10-32
Receptors
10-33
Add Line
Click and hold the left mouse button at the starting point of the line
then drag to the end point of the line and release the mouse button.
Add Rectangle
Click and hold the left mouse button at the first corner of the
rectangle then drag to the opposite corner of the rectangle and
release the mouse button.
Add Rounded Rectangle
Click and hold the left mouse button at the first corner of the
rectangle then drag to the opposite corner of the rectangle and
release the mouse button.
Add Ellipse
Click and hold the left mouse button at the first corner of the
bounding rectangle for the ellipse then drag to the opposite corner of
the bounding rectangle and release the mouse button.
Add Polyline
Click the left mouse button to define the first point. Create additional
points by clicking the left mouse button again. Create the end point
by double clicking the left mouse button.
Add Polygon
Click the left mouse button to define the first corner. Create
additional corners by clicking the left mouse button again. Close the
polygon by double clicking the left mouse button at the final corner.
Add Text
Click the left mouse button at the point where the text is to start - a
vertical blinking line will be displayed. Type the text and finish by
hitting the enter key. The currently selected text size can be
overriden by holding the left mouse button down after the initial
click and dragging downwards.
Add Image
When Image is selected as the object type from the drop down, a
File Open dialog will be displayed to allow selection of the image to
10-33
10-34
Overlay Editor
10-34
Receptors
10-35
Resizing Objects
A selected object can be resized by moving the cursor over one of
the white boxes in the bounding rectangle. When the cursor changes
to a two headed arrow, click and hold the left mouse button then drag
to resize the object.
Moving Objects
An object can be moved by clicking and holding the left mouse
button on the object and dragging the object to the new position. The
cursor will show a four arrowed icon. To move multiple objects first
select them then click and drag one of the them.
Changing Object Properties
The properties of an object can be changed by selecting it then using
the
drop down to select the property to be changed.
Rotating and Flipping Objects
Objects can be rotated or flipped by selecting it then using the
drop down to select the angle of rotation or horizontal or vertical
flip.
Changing Object Stacking Order
The stacking order of objects, i.e. whether one object is displayed in
front or behind another object, is set by selecting it then using the
drop down to bring the object forward or in front of other
objects or send it backwards or behind other objects.
Grouping or Ungrouping Objects
Multiple objects may be grouped together by selecting them and
then using the group option from the
drop down. The group of
objects can then be treated as a single object for other
transformations. A grouped object can be broken into individual
objects again by selecting it and using the ungroup from the same
drop down menu.
10-35
10-36
Using Overlays
2.
3.
Click the
10-36
Finally check the units drop down at the top right of the
view and ensure that this is set to ft. The dimensions of the
overlay which should still be locked to that of the
underlying grid should be shown as X min -500, max 500
and Y min -500, max 500 as shown in the following figure.
Receptors
10-37
5.
6.
7.
Click the
drop down and select the ellipse object.
Now draw a circle within the helideck rectangle by moving
to the point -50, -100, clicking and holding the left mouse
button and dragging to the point 30, -180.
10-37
10-38
Using Overlays
8.
9.
10-38
Receptors
10.
11.
10-39
3.
4.
10-39
10-40
Using Overlays
6.
10-40
Receptors
10-41
Click the
button to put the Overlay Editor into draw
mode. Set the checkbox Show Stacks to draw the position
of the stacks onto the drawing as a guide. Set the drawing
dimensions to ft using the units dropdown.
3.
4.
5.
You are now ready to draw the box onto the drawing in
which the file will appear. Draw a box encompassing the
two stacks by clicking and holding the left mouse button at
the top left corner and dragging to the bottom right corner.
The platform elevation image will be drawn into this box.
6.
It is likely the the size of the image will need adjusting. Set
the Overlay Editor to edit mode by clicking the button.
Now click the image and it will be surrounded by eight
white rectangles or handles. Resize the image as required by
10-41
10-42
Using Overlays
7.
Receptors
10-43
3.
4.
Click the
button to load the background DXF file. In the
File Open dialog that appears, browse for the file plan.dxf
from the folder Samples\example 4 - welltest safety case
and click Open.
5.
6.
10-43
10-44
Using Overlays
Since the extent of a background graphic file must include the full
extent of the receptor grid, the dimensions of the DXF file must
exceed those of the grid. This will be checked during the import
process and if the drawing is not large enough, the import process
will fail.
There are also practical limits on the size of DXF file that can be
imported or the memory usage of the overlay editor will be
excessive and performance will become very sluggish. If it is desired
to view isopleth plots on a full detailed plan or elevation drawing it
is better to generate an isopleth graphic and export it as a DXF file
for overlay onto the drawing in a third party package.
10-44
Calculations
11-1
11 Calculations
Page
11.1 Calculation Options View . . . . . . . . . . . . . . 3
11.1.1
11.1.2
11.1.3
General Tab. . . . . . . . . . . . . . . . . . . . . . . . . . 4
Sizing Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Heat Transfer Tab . . . . . . . . . . . . . . . . . . . . . 9
11-1
11-2
11-2
Calculations
Calculate Button
11-3
Status Text
Status message
The message displayed in this field and its colour indicates whether
the calculation options are complete and the model is ready for
calculation.
11-3
11-4
Calculations
11-5
11-6
11-6
Calculations
11-7
11-7
11-8
11-8
Calculations
11-9
11-9
11-10
HTC = A Windspeed + C
(1)
Printing
12-1
12 Printing
Page
12.1 Print Preview . . . . . . . . . . . . . . . . . . . . . . . . 4
12.1.1
Report File . . . . . . . . . . . . . . . . . . . . . . . . . . 6
12-1
12-2
12-2
Printing
12-3
Output of Flaresim results is through the File - Print and File - Print
Graphic Reports menu options. The File - Print option first opens
the Print Preview view where the report can be customised and then
printed. The File - Print Graphic Reports menu option opens the
Graphic Report view which allows selection of the reports to be
output and the output method. These views are described below.
The File - Print Setup menu item provides access to the standard
Printer Setup Dialog to allow the printer type and paper size and
orientation to be selected.
Flaresim produces its standard reports through an HTML file which
is created by using a stylesheet file, by default Flaresim.xsl, to
format the contents of the Flaresim model file. The Preferences
view allows the user to specify the name of the stylesheet file to be
used.
Both the Flaresim XML data files and the XSL stylesheet file
comply with the appropriate W3C.org standards. This provides the
capability to reformat the output of Flaresim through definition of an
alternate stylesheet file. Third party documentation on the use of
XSL files should be consulted since this is beyond the scope of this
documentation.
Flaresims graphic reports are produced through a layout file which
is an XML formatted file that describes the text, data and graphical
elements to be included in the report and their layout. The default
layout file to be used may be selected in the Preferences view or for
each receptor grid individually.
12-3
12-4
Print Preview
Report Topic
Structure
Include topic
checkbox
Report Preview
Report Topic
Tree View
This section of the view lists the topics that can be included in a
report as a tree structure in a similar way to the Case Summary view.
As in the case summary, the and icons can be used to expand and
collapse branches of the tree as required.
Include Topic
Checkbox
Each topic available for the report has a checkbox against it. The
checkbox should be set to include the topic or cleared to exclude it.
12-4
Printing
12-5
Refresh
Button
Updates the report preview to reflect any changes that have been
made to the included or excluded topics.
Print
Button
Prints the report using the current selection of included and excluded
topics. Clicking this button starts the printing process by displaying
the view below to allow the user to select the printer to be used and
to control the setup of the print options.
Figure 12-2, Print Control View
Once the printer options have been set the Print button on this view
should be clicked to send the output to the printer.
Reset Print Options
Button
Resets the print topics selection to the set defined in the startup file
Default.fsw.
12-5
12-6
Print Preview
Report Preview
Display region
Displays the current view of the report. If the report does not fit
within the available areas the scroll bars may be used to move
around the report.
Note that the view being displayed is of the HTML report file
generated by Flaresim. Some elements of this report file will float
and be reformatted to try and fit into the area availble for display. It
may be necessary to expand the view to see the report as it will be
printed.
12-6
Printing
12-7
Select Grids
List Box
This list box allows selection of the Receptor Grids for which the
graphic report is to be output. The list allows selection of individual
grids by clicking on the name in the list. Multiple items may be
selected using Shift-Click and Ctrl-Click in the usual way.
For convenience an All option is provided at the top of the list which
can be selected to output graphic reports for all the receptor grids in
the model.
12-7
12-8
Graphic Report
Select Plots
Checkboxes
Each receptor grid can generate three separate graphic reports, one
for each of the radiation, noise and temperature isopleths. These
checkboxes allow selection of which reports will be output. Set a
checkbox to output the associated report and clear a checkbox to
suppress the report.
Save File Type
Dropdown List
This allows selection of the graphic file type that will be generated
if the reports are output to file using the Save Graphic Reports
button. The options are JPG or BMP bitmap files, WMF or EMF
metafiles and PNG or DXF files.
Save Graphic Reports
Button
This creates the selected graphic reports and saves them as files of
the type selected by the Save File Type item. Each file will be
automatically named with the type of the isopleth and the name of
the receptor grid e.g. Radiation-Helideck. The files will be stored in
a sub-folder of the folder in which the Flaresim data file is located,
with other report files. Confirmation of each file saved is output to
the information log.
Save Isopleth Points
Button
This saves a list of the isopleth data points for each selected report
to a text file in Comma Separated Value or CSV format. This allows
the isopleths to be plotted using third party applications such as
Excel. The files will be stored in a sub-folder of the folder in which
the Flaresim data file is located, with other report files. Confirmation
of each file saved is output to the information log.
Print Graphic Reports
Button
This button prints the selected graphic reports to the currently
selected printer.
12-8
Printing
12-9
Page Setup
Button
This button displays the Graphic Report Page Setup view
described in the next section to allow setting of the paper size, page
orientation, margins and printer to be used for the graphic reports.
Close
Button
This button closes the Print Graphic Report view and returns to the
main Flaresim views.
Paper - Size
Dropdown list
This selects the paper size to be used for the graphic reports. The list
will show the pre-defined paper sizes available for the currently
selected printer.
12-9
12-10
Graphic Report
Paper - Source
Dropdown List
This selects the source of the paper to be used for the graphic reports.
The choices available will depend on the currently selected printer.
Orientation
Portrait / Landscape
These radio buttons allow the paper orientation to be selected. The
selected orientation should correspond to the expected orientation in
the graphic report layout file. Note all the standard Flaresim
graphical layouts assume a Landscape orientation.
Margins - Left
Spacing in mm
This defines the left margin of each graphic report page.
Margins - Right
Spacing in mm
This defines the right margin of each graphic report page.
Margins - Top
Spacing in mm
This defines the top margin of each graphic report page.
Margins - Bottom
Spacing in mm
This defines the bottom margin of each graphic report page.
Ok
Button
This closes the view, accepting any changes made.
Cancel
Button
This closes the view, losing any changes made.
Printer
Button
This displays a standard windows printer selection dialog to allow
the graphic report printer to be selected.
12-10
Printing
12-11
Printer - Name
Dropdown list of configured printers
Allows selection of the printer to be used to output the Flaresim
report. The list shows the printers that have been configured for the
computer that is running Flaresim.
Printer - Properties
Button
Opens the Properties view for the current selected printer to allow
selection of printer specific options. The options available through
this view will vary will the type of printer installed and are beyond
the scope of this documentation.
Paper - Size
Dropdown list of available paper sizes
Allows selection of the paper size. The list of paper sizes available
for selection will depend on the type of printer selected.
12-11
12-12
Print Setup
Paper - Source
Dropdown list of available paper sources
Allows selection of the paper source on the printer to be used. The
choices available will depend on the printer selected.
Orientation
Radio button: Portrait / Landscape
This pair of radio buttons selects the paper orientation to be used.
The standard Flaresim reports are formatted for portrait orientation.
Network
Button
Opens a window that allows browsing of the network to search for
additional printers.
Ok
Button
Confirms the current selections and closes the Print Setup view.
Cancel
Button
Closes the Print Setup view without saving changes.
12-12
Calculation Methods
13-1
13 Calculation Methods
Page
13.1 Thermal Radiation . . . . . . . . . . . . . . . . . . . . 4
13.1.1
13.1.2
13.1.3
13.1.4
13.1.5
13.1.6
13.1.7
13.1.8
API Method . . . . . . . . . . . . . . . . . . . . . . . . . .
Integrated Point Source Method. . . . . . . . .
Integrated Diffuse Source Method . . . . . . .
Integrated Mixed Source Method . . . . . . . .
Brzustowski and Sommer Method . . . . . . .
Atmospheric Attenuation . . . . . . . . . . . . . .
Windchill . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Flame Shape . . . . . . . . . . . . . . . . . . . . . . . . .
4
5
6
6
7
7
8
9
Combustion Noise . . . . . . . . . . . . . . . . . . . 17
Jet Noise . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Atmospheric Attenuation . . . . . . . . . . . . . 21
13.4 Nomenclature . . . . . . . . . . . . . . . . . . . . . . . 23
13.4.1
13.4.2
Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Subscripts. . . . . . . . . . . . . . . . . . . . . . . . . . 24
13.5 References . . . . . . . . . . . . . . . . . . . . . . . . . 25
13-1
Calculation Methods
13-2
13-2
Calculation Methods
13-3
13-3
13-4
Thermal Radiation
13-4
Calculation Methods
13-5
FQ
K = -------------2
4D
(1)
13-5
13-6
Thermal Radiation
FQ L 1
K ips = ---------- ------- dl
4L 0 D 2
(2)
The distance between the point source and the receptor is calculated
from a flame shape derived from the resolution of the velocity
vectors for the flared fluid, wind and flame buoyancy.
FQ L sin
K ids = --------- ----------- dl
2
2
L 0 D
(3)
The distance between the point source and the receptor is calculated
from a flame shape derived from the resolution of the velocity
vectors for the flared fluid, wind and flame buoyancy.
13-6
Calculation Methods
13-7
(4)
K = K
(5)
13-7
13-8
Thermal Radiation
(6)
13.1.7 Windchill
The design of offshore flare systems often takes into account the
effect of heat loss from the target surface due to windchill. Equation
7 gives the simple correction to the calculated value for thermal
radiation.
K w = K Kf
(7)
Calculation Methods
13-9
13-9
13-10
Thermal Radiation
4WZRT
u j = ------------------2
PMd
(8)
The gas mach number is calculated from the sonic velocity which is
calculated from Equation 9.
us =
gkRT
------------M
(9)
Q = W LHV
(10)
Q I2
L = I 1 ---N
13-10
(11)
Calculation Methods
Tip Type
13-11
l1
l2
Pipeflare
0.00604
0.4776
0.00442
0.4600
0.00231
0.5000
Steam and air assisted flares will generally have shorter flames than
those calculated by these equations. The program contains
proprietary algorithms for prediction of the shortening of the flame
as a function of the rate of injection of the assist fluid. Due to the
proprietary nature of these algorithms, they are not presented here.
In windy conditions the flame will be distorted from the straight
vertical. This distortion may be calculated by the resolution of the
velocity vectors for the exit jet, wind and flame buoyancy.
The jet velocity as a function of the curvelinear distance along the
flame is modelled according to the formula proposed by
McMurray[4].
1 1
u l = 5.0u j d --- --l A
(12)
dx
------ = u l sin cos + u cos
dt
(13)
dy
------ = u l sin cos + u sin
dt
(14)
dz
----- = u l cos + u b
dt
(15)
13-11
13-12
Thermal Radiation
uj
Mj
c l = c l ------ -------u
M
13-12
(16)
Calculation Methods
13-13
xl
x l = -------------------------dj uj
--------- ------ju
(17)
zl
z l = -------------------------djuj
--------- ------ju
(18)
Figure 13-3 gives the values for the horizontal and vertical distance
factors for a range of values for the dimensionless concentration
parameter..
Figure 13-3, Dimensionless Distance Parameters
13-13
13-14
Thermal Radiation
13-14
Calculation Methods
13-15
K = ( h c + h r ) ( T m T )
(19)
( Tm T )
h r = E -----------------------------( Tm T )
(20)
h c = 0.80 + 0.22u
(21)
u > 15
h c = 0.56u
0.75
(22)
13-15
13-16
Noise
13.3 Noise
The noise generated by a flare may be broken down into 3 basic
components:
Combustion noise
Jet noise
Although the noise may be expressed in terms of an average value,
it is frequency dependant. The shape of this noise spectrum is
dependant upon whether the major contribution is due to
combustion noise as in the case of pipeflares, or jet noise as in the
case of sonic flares. The noise spectrum is generally given in 7
octave bands from 63 Hz to 8000 Hz.
Attenuation of the noise occurs due to atmospheric absorption. This
absorption is a function of the frequency of the noise with higher
frequencies being more readily absorbed.
Noise is expressed either in terms of the Sound Power Level (PWL)
or the Sound Pressure Level (SPL) where these terms are defined by
Equations 23 and 24.
W
PWL = 10 log -------
W
0
(23)
P2
SPL = 10 log ---------
P 2
(24)
13-16
Calculation Methods
13-17
(25)
Noise data predicted by the program refer to the Sound Power Level
in all cases.
Q
SPL = SPL 20 + 10 log --------------------- +
6
81 10
20
20log ------ SPL A
D
(26)
13-17
13-18
Noise
juj
----------PWL = V
2
(27)
13-18
Calculation Methods
13-19
j Tj 2
B = ------- -------
T
(28)
13-19
13-20
Noise
0.2mu s
f max = ----------------dj
(29)
13-20
Calculation Methods
13-21
(30)
13-21
13-22
Noise
13-22
Calculation Methods
13-23
13.4 Nomenclature
13.4.1 Symbols
A
a
B
c
D
d
E
F
f
H
h
L
LHV
l
l1
l2
M
m
N
K
k
P
13-24
Nomenclature
Z
z'
z
13.4.2 Subscripts
A
b
c
f
i
ids
ims
ips
j
l
m
r
s
w
0
20
13-24
Atmospheric attenuation
Buoyancy
Convective
Correction
Frequency band
Integrated diffuse source
Integrated mixed source
Intergrated point source
Jet exit
Curvelinear length
Metal
Radiative
Sonic
Corrected for windchill
Wind/atmospheric
Corrected for transmissivity
Reference condition
At 20 ft from source
Calculation Methods
13-25
13.5 References
1.
2.
3.
4.
5.
6.
13-25
13-26
13-26
References
A-1
Introduction to XML . . . . . . . . . . . . . . . . . . . 4
A.1.1
A.1.2
A.1.3
A.2
Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
A.2.1
A.2.2
A.2.3
A.2.4
A.2.5
A.2.6
A.2.7
A.2.8
A.2.9
A.2.10
A.2.11
Allowed Elements . . . . . . . . . . . . . . . . . . . . 6
PageSize Element . . . . . . . . . . . . . . . . . . . . 7
Text Element . . . . . . . . . . . . . . . . . . . . . . . . . 7
Unit Element . . . . . . . . . . . . . . . . . . . . . . . . . 8
Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Logo Element . . . . . . . . . . . . . . . . . . . . . . . .11
CaseData Element . . . . . . . . . . . . . . . . . . . .11
Line Element. . . . . . . . . . . . . . . . . . . . . . . . 12
PlotArea Element . . . . . . . . . . . . . . . . . . . . 13
LegendArea Element . . . . . . . . . . . . . . . . . 17
ContourSet Element. . . . . . . . . . . . . . . . . . 19
A-1
A-2
A-2
A-3
A-3
A-4
Introduction to XML
A.1.1 Tags
An elements tag can be thought of as its name. A tag enclosed in a
pair of < > brackets starts the description of an element and the
same tag preceded by a / character and enclosed in a pair of < >
brackets ends the description of the element. For example, an
element containing text data might be given the tag Description and
would appear as follows
<Description>The descriptive text</Description>.
A XML file can contain more than one element with the same tag
describing repeating data items. Tags are case sensitive, i.e.
<description> is different to <Description>.
Taking the XML fragment shown in Figure A-1 as an example, there
are six elements in total with four unique tags namely <Text>,
<Logo>, <CaseData> and <Var>. There are three <Text> elements.
A-4
A-5
A.1.2 Attributes
The attributes of an element can be thought of as data parameters
or additional descriptions of the element. Attributes are defined
within the < > brackets of the elements opening tag. A single
attribute is introduced by a name followed by an = sign followed
by the value of the attribute enclosed in quotes. For example our
Description tag might be extended to have an attribute called Font to
define the typeface to be used to print it thus.
<Description Font=Arial>The descriptive text</Description>
An element may have no attributes or multiple attributes. Attribute
names are case sensitive i.e. Font is different to font.
Taking the XML fragment shown in Figure A-1 as a further
example, the <Text> elements there each have four attributes name
X, Y, Font and Size.
A.1.3 Data
The data part of an element is contained between the opening tag
and the closing tag. The data can be either text or another element.
In our <Description> element example the data is the text The
descriptive text.
The data part of an element does not have to contain data, it can be
empty if for example all of the data contained in an element is
described through attributes. When the data part of an element is
empty the closing / character can be included in the opening tag
and the closing tag omitted thus.
<Description Font=Arial/>
Looking at our example XML fragment shown in Figure A-1 again,
we can see that the data sections of the <Text> elements contain
descriptive text, the data section of the <Logo> element contains a
file name and the data section of the <CaseData> element contains
another element introduced by the <Var> tag.
A-5
A-6
A-6
Description
Number
PageSize
Single
Text
Multiple
Unit
Multiple
Data
Multiple
Logo
Multiple
CaseData
Multiple
Line
Multiple
PlotArea
Single
LegendArea
Single
ContourSet
Single
A-7
Data Value
None.
Size
Style
Data Value
The background text to be added to the plot.
A-7
A-8
Size
Style
Data Value
The name of the unit of measurement type to be output e.g. length,
temperature. The full list of recognised type names is the same as the
list of quantity names defined in the units.xml file as followstime, length, mass, temperature, sound, frequency,
surface_area, volume, force, small_length, energy, pressure,
velocity, plane_angle, fraction, percentage, power,
mass_flow, mass_heat_capacity, mass_energy,
heat_flux_density, heat_transfer_coefficient,
mass_per_area, mass_density, volume_flow.
A.2.5 Data
Description
Defines individual data items that will appear on the plot.
A-8
Attributes
X
Y
Font
Size
Style
A-9
Data Value
A <Var> data element defining the data item to be output as follows.
A-9
A-10
Data Value
A text string identifying the data item to be output. The list of data
identifiers recognised is as follows.
Identifier
A-10
Stack Id
Tip Id
WindSpeed
Not specified
Not specified
WindDirection
Not specified
Not specified
SolarRadiation
Not specified
Not specified
Transmissivity
Not specified
Not specified
Name
Required
Not specified
Length
Required
Not specified
AngleToHorizontal
Required
Not specified
AngleToNorth
Required
Not specified
Name
Required
Required
Type
Required
Required
NbrOfBurners
Required
Required
Length
Required
Required
Diameter
Required
Required
AngleToHorizontal
Required
Required
AngleToNorth
Required
Required
MassFlow
Required
Required
LHV
Required
Required
MW
Required
Required
CpCv
Required
Required
Emissivity
Required
Required
Temperature
Required
Required
A-11
Data Value
A text string naming the graphic file to be included.
Size
A-12
Style
Data Value
A text string defining the data item to be output. Recognised values
are.
Title
DataFile
Description
LastModified
Author
Revision
CheckedBy
FSWVersion
A-12
A-13
Data Value
Elements defining the options used to draw the isopleth graph as
follows. Note one instance of each of these elements is required in
the <PlotArea> data. None of these elements has any data value, all
the required information is contained as attributes.
A-13
A-14
A-14
Size
Style
A-15
Size
Style
A-16
Space
Font
Size
Style
Size
Style
Attributes
Font
Size
A-17
A-17
A-18
Attributes
X1
Y1
X2
Y2
Data Value
Elements defining the options used to draw the legend data on the
isopleth graph as follows. Note one instance of each of these
elements is required in the <LegendArea> data. None of these
elements has any data value, all the required information is
contained as attributes.
Size
A-18
A-19
Size
Style
Data Value
Multiple elements defining the individual contour lines to be output.
Up to 10 instances of <RadiationContour>, <NoiseContour> and
<TemperatureContour> can be specified.
A-19
A-20
A-20
A-21
DashDot
DashDotDot
A-21
A-22
A-22