Professional Documents
Culture Documents
Flaresim Manual (2008)
Flaresim Manual (2008)
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.
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.
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.
2 Installation.................................................... 2-1
2.1 Installation Requirements . . . . . . . . . . . . . . . . 2-3
2.2 Installing Flaresim-Single User . . . . . . . . . . . . 2-4
2.3 Installing Flaresim - Network . . . . . . . . . . . . . 2-21
2.4 Flaresim File Locations . . . . . . . . . . . . . . . . . 2-44
4 Interface........................................................ 4-1
4.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.2 Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
4.3 Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
4.4 Log Panels . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
4.5 File Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
4.6 About View . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
4.7 Chart Control Dialog . . . . . . . . . . . . . . . . . . . 4-17
1
5.2 Case Description View . . . . . . . . . . . . . . . . . . 5-6
5.3 Setup Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
5.4 Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
5.5 Component Management View . . . . . . . . . . . 5-33
7 Environment................................................. 7-1
7.1 Environment View . . . . . . . . . . . . . . . . . . . . . . 7-4
11 Shields........................................................ 11-1
11.1 Shield View . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4
11.2 Shield Section Editor . . . . . . . . . . . . . . . . . . 11-10
11.3 Pit Builder . . . . . . . . . . . . . . . . . . . . . . . . . . 11-15
11.4 Transform View . . . . . . . . . . . . . . . . . . . . . . 11-17
11.5 Water Screen Characteristics . . . . . . . . . . . 11-19
2
12.1 Calculation Options View . . . . . . . . . . . . . . . 12-3
3
15.18 IFluid Object . . . . . . . . . . . . . . . . . . . . . . . . 15-68
15.19 IComponents Object . . . . . . . . . . . . . . . . . . 15-72
15.20 IComponent Object . . . . . . . . . . . . . . . . . . . 15-73
15.21 IAssists Object. . . . . . . . . . . . . . . . . . . . . . . 15-75
15.22 IAssist Object . . . . . . . . . . . . . . . . . . . . . . . 15-76
4
Introduction 1-1
1 Introduction
Page
1.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
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.
1-4
Introduction 1-5
1-5
1-6 Features
1-6
Introduction 1-7
Required object
present
Required object
missing
Optional object
Permanent object
Object ignored
Case Details
Each model contains a single Case Details object which defines
descriptive information.
1-7
1-8 Program Overview
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. The
variation of wind speed with direction can also be defined to support
wind rose calculations. 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. The effect of wind speed
and direction on the radiation can also be calculated and displayed
as a wind rose plot.
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
1-8
Introduction 1-9
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.
Shields
Multiple shield objects may be defined to model the reduction in
radiation and noise through the installation of water sprays and solid
shields. The transmissivity of water sprays can be specified by the
user or calculated using an internal correlation. Shields can also be
defined to model burn pits.
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.
Some objects have more data items than will fit on a single form so
their views have been divided into multiple tabs, for example the
Tip view as shown in Figure 1-2 has tabs for Details, Location &
1-9
1-10 Program Overview
1-10
Introduction 1-11
Calculations are started by clicking the icon in the tool bar. The
model will then be solved using the current correlations and options
selected in the Calculation Options object. Progress of calculations
and any problems encountered are reported in the Message window
at the bottom right of the Flaresim screen.
1-11
1-12 Documentation Overview
1-12
Installation 2-1
2 Installation
Page
2.1 Installation Requirements . . . . . . . . . . . . . .3
2.1.1 Package Requirements . . . . . . . . . . . . . . . . 3
2.1.2 System Requirements . . . . . . . . . . . . . . . . . 3
2-1
2-2
2-2
Installation 2-3
Item Requirement
2-3
2-4 Installing Flaresim-Single User
2-4
Installation 2-5
2-5
2-6 Installing Flaresim-Single User
Once the accept option has been selected the Next button
will be activated so click Next to continue. The following
screen, Figure 2-3, will appear.
If you do not wish to accept the license terms then click the
Cancel button to exit the setup program without installing
Flaresim. The license terms must be accepted before the
program will install.
2-6
Installation 2-7
The other options are included for possible future use but do
not provide any useful options at present.
2-7
2-8 Installing Flaresim-Single User
2-8
Installation 2-9
10. The setup program will show the progress of the installation
as files are copied from the CD Rom to your install folder as
shown below.
2-9
2-10 Installing Flaresim-Single User
2-10
Installation 2-11
13. When you have entered the license file name, click the
Install button. If the license file has been correctly installed
the following message will be displayed. Click the Ok
button to finish the license installation process and close the
license installer.
2-11
2-12 Installing Flaresim-Single User
2-12
Installation 2-13
2-13
2-14 Installing Flaresim-Single User
If you do not have a license file see the instructions in the following
section, 2.2.3, to obtain one.
4. When you have entered the license file name, click the
Install button. If the license file has been correctly installed
the following message will be displayed. Click the Ok
2-14
Installation 2-15
Full License
If you have a full license for Flaresim you will have been supplied
with a security key. The security key and its associated license file
2-15
2-16 Installing Flaresim-Single User
If you have a demo license for Flaresim you will not have a security
key. A license file will be supplied to activate Flaresim for the single
PC on which it is installed and for a limited period.
2-16
Installation 2-17
3. 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
boxes have been set correctly, the Locking Data selector
will be 0x4. Unless otherwise instructed ensure that the
radio button at the bottom of the view is set to “New Style”
to generate a long 16 character code.
2-17
2-18 Installing Flaresim-Single User
The first of these problems can be tested for by running the program
wechoid.exe which can be found in the support sub-folder of the
Flaresim program folder (normally C:\Program Files\Flaresim 2.1).
2-18
Installation 2-19
2-19
2-20 Installing Flaresim-Single User
2-20
Installation 2-21
IMPORTANT NOTE
2-21
2-22 Installing Flaresim - Network
Alternatively you can click the Start button select Run and
then type [Drive]:\Server\Setup\Setup.exe where [Drive] is
the drive letter of your CD. Hit Enter to start the setup
program.
2-22
Installation 2-23
2-23
2-24 Installing Flaresim - Network
2-24
Installation 2-25
2-25
2-26 Installing Flaresim - Network
Select the check box and click Next. The following screen
will be displayed.
2-26
Installation 2-27
10. This confirms that you are ready to begin installation of the
Sentinel RMS server software. Click the Install button.
2-27
2-28 Installing Flaresim - Network
11. At this point the server software is installed and the server
service will have been started. Click the Finish button to
close the window.
12. You may wish to confirm that the server service has
installed correctly by checking the list of running processes
through the Task Manager. The server service is called
lservnt.exe.
2-28
Installation 2-29
2-29
2-30 Installing Flaresim - Network
2-30
Installation 2-31
5. Left click on the To Server and its File option. Select the
license file (.lic extension) from your Flaresim CD in the
browser and click Open. Your license should be added to
the server and displayed in the tree below the server name.
2-31
2-32 Installing Flaresim - Network
2-32
Installation 2-33
If the license file will not install when the wechoid.exe output shows
that the security device is visible then there may be a problem with
the license file and you should contact support@flaresim.com.
2-33
2-34 Installing Flaresim - Network
2-34
Installation 2-35
Once the accept option has been selected the Next button
will be activated so click Next to continue. The following
screen, Figure 2-35, will appear.
If you do not wish to accept the license terms then click the
Cancel button to exit the setup program without installing
Flaresim. The license terms must be accepted before the
program will install.
2-35
2-36 Installing Flaresim - Network
2-36
Installation 2-37
The other options are included for possible future use but do
not provide any useful options at present.
2-37
2-38 Installing Flaresim - Network
2-38
Installation 2-39
10. The setup program will show the progress of the installation
as files are copied from the CD Rom to your install folder as
shown below.
2-39
2-40 Installing Flaresim - Network
2-40
Installation 2-41
2-41
2-42 Installing Flaresim - Network
If you see this message you should click the Ok button to close the
window.
The following check list offers possible reasons why Flaresim might
not be able to locate the license server to obtain a license.
• All available licenses are in use.
• Client system does not have network access to the server.
• Server may not be active.
If the Flaresim server can be seen, open the Flaresim license to check
whether there is a license available. If all are in use the client must
wait until a license becomes free. It can take up to 5 minutes for a
license to become free after another user has shut down Flaresim.
2-42
Installation 2-43
If the WlmAdmin program does not list a Flaresim server when run
on the client then the problem likely lies in the client system not
having network access to the server. You will need to check all
elements of the network routing (e.g. firewalls, routers) to ensure
that the server can be seen by the client system.
2-43
2-44 Flaresim File Locations
2-44
Installation 2-45
2-45
2-46 Flaresim File Locations
2-46
Getting Started 3-1
3 Getting Started
Page
3.1 Simple Flare Stack Design . . . . . . . . . . . . .4
3.1.1 Objective and Data. . . . . . . . . . . . . . . . . . . . 4
3.1.2 Initial Setup. . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1.3 Initial Calculations . . . . . . . . . . . . . . . . . . . 13
3.1.4 Add Additional Receptor Point . . . . . . . . . 14
3.1.5 Print Results . . . . . . . . . . . . . . . . . . . . . . . . 16
3-1
3-2
3-2
Getting Started 3-3
3-3
3-4 Simple Flare Stack Design
Tip Diameter 18 in
3-4
Getting Started 3-5
3. In the opening view of the Setup Wizard, set the unit set to
Default Field as shown. Then click the Next button to
move to the Fluid definition tab.
Temperature = 300 F
Mole Weight = 46.1
LHV = 21500 btu/lb
Cp/Cv = 1.1
3-5
3-6 Simple Flare Stack Design
LEL is used only by the specified values displayed in black are required input and
Brzustowski flare radiation
method. cannot be defaulted.
5. In the Tip tab select the radio button to set the tip type to a
Pipe Tip. In the table for selection of F Factor method select
the checkbox to select the Generic Pipe method.
3-6
Getting Started 3-7
6. Still in the Tip tab, enter the Fluid Mass Flow Rate as
100,000 lb/hr. After this entry has been completed, the Tip
Diameter field is updated to show the tip diameter required
for the default Mach number of 0.45. In our case we know
the tip diameter is 18 in so we update the calculated value to
18 in. The Mach number will be updated to 0.199 to
indicate the velocity for the new diameter.
3-7
3-8 Simple Flare Stack Design
The humidity value is only The remaining items can be left at their default values
used when calculating the namely Wind Direction as 0 (i.e. North), Temperature 59
transmissivity.
F, Humidity 10% and the User Transmissivity 1.0 with
the Transmissivity Method as Default. Note the default
transmissivity method is User defined which at the defined
value of 1.0 is the most conservative option.
3-8
Getting Started 3-9
8. In the Stack tab, select the radio button to set the Vertical
Orientation to 60 degrees from horizontal. Then set the
Stack Horizontal Orientation angle to 0 (i.e. North). The
Stack Length will be left at its default value of 0.0 to have
Flaresim calculate the stack length for us.
3-9
3-10 Simple Flare Stack Design
3-10
Getting Started 3-11
3-11
3-12 Simple Flare Stack Design
11. When the Finish button is clicked, the Setup Wizard takes
the data we have supplied and uses it to create the Flaresim
objects that we need for our initial model. The Case
Summary view will be displayed to list all of these objects
as shown in Figure 3-8. Note that the icon is shown
against all the objects to indicate that the model is ready to
calculate.
3-12
Getting Started 3-13
Note that the scroll bars can be used to review earlier mes-
sages. Also the log window can be resized by dragging the
separator bar above it.
14. We can now review the results. First click Stack_1 in the
Case Summary view and click the View button. The view
will show that the stack length has been calculated as 158ft.
3-13
3-14 Simple Flare Stack Design
Finally open the view for the Stack Base receptor point by
double clicking it in the Case Summary. The Thermal
Results tab shows that our design radiation limit of 1500
btu/h/ft2 has been met.
3-14
Getting Started 3-15
16. Enter the data for the receptor point as shown in Figure 3-11
Name = Helideck
Location, Relative To = Origin
Location, Northing = -150ft
Location, Easting = 0ft
Location, Elevation = 30ft.
Sizing Constraints, Radiation = 600 btu/hr/ft2
As location data is entered in
Cartesian coordinates, the
Polar coordinates are auto- 17. Now click the icon to re-run the model. Once the run is
matically updated. We could complete, double click the stack object to check the new
also enter data in Polar
coordinates stack height which is 246ft.
3-15
3-16 Simple Flare Stack Design
3-16
Getting Started 3-17
20. Select the report elements you wish to see printed. To see
what the report will look like with the current set of
elements you will need to click the Refresh button to
update it.
21. When you are happy with the options you have chosen click
the Print button to send the report to your default printer.
3-17
3-18 Sonic Tip Design
The fluid data, environmental data and radiation limits are the same
as for Example 1.
3-18
Getting Started 3-19
4. On the Details tab of the Tip view that opens enter the
following data:
On Stack = Stack_1
Length - 3.28ft
Angle to Horizontal = 90
Angle to North = 0
Exit Diameter = 18in
Effective Opening = 10%
Riser Diameter = 18in
Contraction Coefficient = 1.0 (default)
Exit Loss Coefficient = 1.0 (default)
Roughness = 9.843e-4in (default)
Calc Sonic Opening = Selected
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.
3-19
3-20 Sonic Tip Design
10. We are now ready to review the results. Open the Stack
view for the Main Stack. The new length calculated for the
stack is 67ft.
3-20
Getting Started 3-21
13. Generate a report for this new case using the File - Print
menu option.
14. 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” sub-
folderin the Flaresim installation folder (usually C:\Program
Files\Flaresim).
15. Find the Tip Data - Results section in the reports. The
fraction of heat radiated value for the Pipe flare design is
0.35 while that for the Sonic design is 0.1.
3-21
3-22 Sonic Tip Design
16. 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 compar-
ing 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 the Pipe flare this is
14.7 psi while for the Sonic flare it is 26.0 psi.
3-22
Getting Started 3-23
However we have also seen that the sonic flare tip results in higher
back pressures on the flare system. In many cases this additional
back pressure will be too high to allow safe relief from all the
possible relief sources in the process. Therefore it is common to see
designs with both high and low pressure flare systems relieving
through different tips.
3-23
3-24 Two Tip Design
3-24
Getting Started 3-25
8. Open the Tip view for the Pipe tip Tip_1. You will see on
the Details tab that the fraction of heat radiated from this tip
has been calculated as 0.38 whereas before it was 0.35. 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.
3-25
3-26 Working With Isopleths
Our model already has one receptor grid called Default_Grid. This
was automatically generated for us by the Setup Wizard. It shows a
plan view around our flare stack at the grade elevation i.e. 0ft. Since
the Helideck is the main area of interest we will update this grid for
the correct elevation.
3-26
Getting Started 3-27
6. Re-run the case. When the run is complete you will be able
to inspect the isopleth plot by opening the grid view,
clicking on the Radiation tab and then selecting Plot as the
Display option. Similar plots for noise and surface
temperatures can be found on the Noise and Temperature
tabs.
3-27
3-28 Working With Isopleths
3-28
Getting Started 3-29
3-29
3-30 Working With Isopleths
11. Open the view for the Receptor Grid “Helideck Plan” and
select the Plot Overlay tab.
12. Click the check box “Show Stacks” to draw the stacks on
the overlay to act as guides for us as we do the drawing.
13. Click the button to put the editor in draw mode. Note
the button will then change to the symbol. Then click
the drop down and select Rectangle as the object to
draw.
14. 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.
3-30
Getting Started 3-31
17. 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.
3-31
3-32 Working With Isopleths
19. If the text entered in step 8 is not quite central, click the
button to go to Edit Mode. Then click on the text - four
white squares will appear round the text to indicate it has
been selected. It can now be moved by clicking on the text
inside the squares and dragging it to the required position.
3-32
Getting Started 3-33
3-33
3-34 Working With Isopleths
26. You should now see the imported graphic as shown below.
Check the Show Overlay checkbox to enable display of the
background graphic on the isopleth plots.
3-34
Getting Started 3-35
Tip Diameter 12 in
3-35
3-36 Welltest Burner Design
3-36
Getting Started 3-37
6. Enter data for the new stack as follows, leaving other entries
at their default values;
3-37
3-38 Welltest Burner Design
8. On the Details tab of the Tip view enter the following data;
10. On the Fluids tab select the Fluid as Welltest Liquid and
enter the flow rate as 30,000 lb/hr. Set the Flame
Temperature to 4000F. Close the view.
3-38
Getting Started 3-39
13. Open the Calculation Options view. On the Sizing tab set
the stack to be sized to None. Close the view.
15. Open the Receptor Summary view. The results, see Figure
3-24, show that the radiation limits for our original two
critical locations that we have defined are met. The
radiation at the base of the well test burner stack is 1427
btu/hr/ft2.
3-39
3-40 Welltest Burner Design
18. Enter data in the Details tab of the new Shield view as
follows;
19. Select the Sections tab. Once there click the Add Section
button to open the Shield Section Editor view. In this view
click the Add Vertex button 3 times to create a rectangular
shield section with 4 corners or verticies.
3-40
Getting Started 3-41
21. Click OK to close the shield editor. The Shield view should
now show that the shield data setup is complete.
3-41
3-42 Welltest Burner Design
23. 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.
3-42
Getting Started 3-43
24. Select the Water Curtain shield object in the Case Summary
and click the Ignore button. Then run the calculations.
26. Select the Main Stack in the Case Summary view and click
the Activate button to restore it to the calculations. Run the
model again.
27. Open the Receptor Point summary. The results show that
the thermal radiation at the Helideck receptor is 1147 btu/
hr/ft2, significantly exceeding our limit of 600 btu/hr/ft2.
3-43
3-44 Welltest Burner Design
3-44
Interface 4-1
4 Interface
Page
4.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
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.
Menu bar
Toolbar
Edit box
Tabs
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.
Active Button
Throughout the manual,
Clicking a button or other item Buttons appear on most forms and may be clicked with the left
means using the Left mouse mouse button to perform the action indicated. Active buttons are
button unless stated otherwise.
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.
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
Tabs
Some views have more data entry items than will fit on a typical size
window. Tabs are a way of subdividing the entries into groups
within the view. Clicking a tab heading displays the group.
Edit Box
This type of data entry field allows entry of alpha numeric values.
Generally the values entered will be checked for validity on leaving
the field.
CheckBox
A checkbox is used to select options that can be either on or off.
Clicking a checkbox once will display a tick in the box indicating
that the option is on, also known as setting the checkbox. Clicking
the box again will clear the tick indicating that the option is off.
4-5
4-6 Terminology
Radio Buttons
Radio buttons are used to select one option from a group of mutually
exclusive options. Clicking one radio button in a group will select
that option and automatically deselect all the other options.
Scroll Bars
Where a list or a view is not large enough to display all the items
required scrollbars will appear. The up and down arrows may be
clicked to move through the view to display all the items.
4-6
Interface 4-7
Some sub-menu items may have a right pointing arrow next to them
indicating that a further sub-menu may be opened by moving the
mouse to the item and then moving the mouse to the right.
Alternatively sub-menu items can be opened the right arrow key.
4-7
4-8 Menu Bar
4-8
Interface 4-9
4-9
4-10 Tool Bar
The Tool Bar also provides a status indicator to show the current
calculation mode, Rating or Sizing.
4-10
Interface 4-11
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 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:
4-11
4-12 File Dialogs
File List
Filename
Combobox
Allows you to enter the name of the file to save the Flaresim model
to. As you type the name, the dropdown list element of the
combobox allows you to select an existing file that matches the
name to overwrite if you wish.
The file name entered will be given the extension type specified in
the Save As Type field unless you enter a different file extension.
4-12
Interface 4-13
Save As Type
Dropdown List of allowed file types
Allows you to select the required file type.
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.
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-13
4-14 File Dialogs
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-14
Interface 4-15
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-15
4-16 About View
Ok
Button
Closes the About view.
System Info
Button
Opens the System Information program in the operating system.
This provides details of the computer hardware and software
environment that Flaresim is running under. This information may
be of use in resolving technical support issues.
4-16
Interface 4-17
4-17
4-18 Chart Control Dialog
4-18
General Setup 5-1
5 General Setup
Page
5.1 Case Summary View . . . . . . . . . . . . . . . . . . 3
5.4 Preferences. . . . . . . . . . . . . . . . . . . . . . . . . 22
5.4.1 Units Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.4.2 Files Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
5.4.3 Plots Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
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.
5-3
5-4 Case Summary View
View
Opens the view for the selected object to allow its data to be viewed
or updated.
Add
Creates a new object of the selected type and opens its view ready
for data input. If an existing object is selected in the tree rather than
the parent branch, a new object of the same type is created.
Delete
Deletes the selected object. No confirmation is required.
Activate
Clears the ignored status for the selected object which restores it to
the calculations. Not all objects can be ignored and restored and this
button will be greyed out if the action cannot be applied to the
selected object.
Ignore
Sets the ignored status for the selected object which means that it
will not be included in the calculations. Not all objects can be
ignored and restored and this button will be greyed out if the action
cannot be applied to the selected object.
The icons displayed against each branch and object in the Case
Summary view have the following meanings.
This icon identifies a branch of the model tree that contains
a single object that is a permanent part of the model and
cannot be added or deleted. Examples of this type of object
are the Case Description and Calculation Options object.
When a branch of this type is selected the Add, Delete,
Activate and Ignore buttons are greyed out since they are not
applicable.
5-4
General Setup 5-5
5-5
5-6 Case Description View
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 Setup Wizard
The Setup Wizard provides pages or tabs that allow the user to
define in turn the fluid to be flared, details of the flare tip,
environment details, details of the flare stack, location of critical
receptor points and the calculation options to be used. Each page
must be completed before the user can move to the next page. Where
possible default data values and options are provided to allow the
setup of a new case to be made as simple as possible. When the final
page is completed and the Finish button is selected the wizard will
automatically create the Flaresim objects required to define the case.
Summary Panel
This provides a summary of the data input provided so far.
Help Panel
This region provides additional information about the selected data
entry field and will change as different fields are selected. The
5-8
General Setup 5-9
information provided may explain why the data item is required and
indicate the range of values allowed as well as typical values.
Command buttons
These allow the user to move from page to page of the Setup Wizard.
Summary panel The Finish button is only available when all of the required
information has been entered
Page Tabs
These display the status of each section of the Setup Wizard. The
icons used, have the same meanings as in the Case
Summary view, section 5.1. The Page Tabs also allow the user to
move between completed pages of the Setup Wizard.
5-9
5-10 Setup Wizard
The dropdown list only allows selection from existing unit sets. To
create and customise the contents of units sets the File - Preferences
menu option can be used, see section 5.4
5-10
General Setup 5-11
5-11
5-12 Setup Wizard
Property Calculation
Radio Buttons
These buttons control how the fluid properties are to be obtained. If
the Specified Properties option is selected then the bulk properties of
the fluid must be input using the Fluid Properties table as shown in
Figure 5-5. Otherwise if the Compositional option is selected the
view will change to allow the fluid composition to be specified
which will allow the fluid properties to be calculated.
5-12
General Setup 5-13
Fluid Properties - Pc
Range 0.01 to 1000 bar a
This defines the critical pressure of the fluid. It is used in the
calculation of fluid temperatures and densities. Entry of this value is
optional as an internal correlation will be used to estimate the fluids
Pc if this value is not provided.
Fluid Properties - Tc
Range 10 to 1000 K
This defines the critical temperature of the fluid. It is used in the
calculation of fluid temperatures and densities. Entry of this value is
optional as an internal correlation will be used to estimate the fluids
Tc if this value is not provided.
5-13
5-14 Setup Wizard
Composition Basis
Radio Buttons
These buttons select the composition input basis either Mole
fraction or Mass fraction
Normalise Composition
Command Button
Clicking this button will normalise the current composition.
Unspecified component fractions will be set to 0.0 and the remainder
normalised so to give a total fraction of 1.0.
5-14
General Setup 5-15
Tip Type
Radio Buttons
This allows selection of the tip type to be used either a Pipe Tip or
Sonic tip. If unknown the default Pipe tip will provide the most
conservative option.
F Factor Method
Checkbox
Selects the method that will be used to calculate the fraction of
combustion heat that will be radiated from the flame. The F Factor
is sometimes known as the emissivity of the flame. The default
Generic Pipe method is a conservative general purpose method. The
High Efficiency method should only be used for high efficiency tips
in good condition burning low molecular weight fluids.
5-15
5-16 Setup Wizard
5-16
General Setup 5-17
Environment - Temperature
Range 10 to 500 K
The environmental temperature. The value is used primarily in
surface temperature calculations.
Environment - Humidity
Range 04 to 100 %
The environmental humidity. The humidity value is used in
calculations of the attenuation in radiation due to the atmosphere i.e.
the transmissivity calculation. It is only used when the
Transmissivity is set to Calculated. The default value of 10% is
reasonably conservative.
Environment - Transmissivity
Range 0 to 1
The value for atmospheric transmissivity to be used the
Transmissivity method is set to User Defined. The default value of
1.0 is conservative and does not allow for any attenuation of
radiation when passing through the atmosphere.
5-17
5-18 Setup Wizard
Vertical Angle
Range 0 to 90 degrees
The angle of the stack to the horizontal. Use this field if your stack
is not at one of the standard angles.
5-18
General Setup 5-19
Stack Length
Range 0 to 1000m
The length of the stack. Leaving the stack set to the default value of
0.00m will cause the Setup Wizard to create a Sizing case where the
stack length will be calculated to meet a defined limiting value for
the radiation.
5-19
5-20 Setup Wizard
Receptor ID
Descriptive Name
Name of the receptor point. In general it is useful to change the
default name to something descriptive.
5-20
General Setup 5-21
Allowable Radiation
Range 500 to 25000 W/m2
The radiation that is allowed at the receptor point. The table of
typical design values shown on this page provides a general guide to
the selection of appropriate values.
Calculation Method
Checkbox
This allows selection of the calculation method to be used. The
default Flaresim API method should generally give a conservative
result using industry standard methods. The Mixed method with 25
Flame elements is recommended as a good general alternative.
5-21
5-22 Preferences
5.4 Preferences
The File - Preferences menu item provides access to the
Preferences View to allow setup of the preferred units, file locations
and graphical plot elements.
5-22
General Setup 5-23
5-23
5-24 Preferences
5-24
General Setup 5-25
5-25
5-26 Preferences
5-26
General Setup 5-27
The default layout file selected here can be respecified for individual
receptor grids on the Graphic Report tab of the Receptor Grid view.
The contents of the .lay files describe the location and formatting of
isopleth charts and accompanying data items and descriptive text
using XML syntax. The XML elements recognised in these files is
described in Appendix A of this manual.
5-27
5-28 Preferences
5-28
General Setup 5-29
5-29
5-30 Preferences
5-30
General Setup 5-31
Not all of the defined properties may be supported for all of the text
elements. Where a property cannot be set it will be grayed out while
that text element is selected.
5-31
5-32 Preferences
5-32
General Setup 5-33
5-33
5-34 Component Management View
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.
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-34
General Setup 5-35
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.
To remove a component from the library, select it in the list and click
the Remove Selected Component button.
5-35
5-36 Component Management View
5-36
Fluids 6-1
6 Fluids
Page
6.1 Fluid View . . . . . . . . . . . . . . . . . . . . . . . . . . .4
6.1.1 Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
6.1.2 Properties Tab . . . . . . . . . . . . . . . . . . . . . . . 4
6.1.3 Composition Tab . . . . . . . . . . . . . . . . . . . . . 7
6-1
6-2
6-2
Fluids 6-3
The Assist Fluid object both identifies the additional fluids that may
be fed to a flare tip to improve combustion and also defines the
information needed to calculate the flow of the assist fluid required.
Like Fluid objects, Assist Fluids are included in the calculations
only when assigned to a flare tip.
6-3
6-4 Fluid View
Status Text
Status message
The message displayed in this field and its colour indicates whether
the data for this fluid object is complete and ready for calculation.
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.
Ref. Pressure
Range: 100 to 2000000 Pa
The reference pressure at which the fluid temperature is defined.
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.
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
LEL
Range: 0.0 to 100.0%
The lower flammability limit of the fluid as a volume percentage.
Critical Temperature
Range: 10 to 1000K
The critical temperature of the fluid. It is used in the calculation of
the compressibility factor which in turn is used in the calculation of
the fluid density. If a value is not supplied, the fluid’s critical
temperature will be estimated using an internal correlation based on
mole weight.
Critical Pressure
Range: 0.01 to 1000 bara
The critical pressure of the fluid. It is used in the calculation of the
compressibility factor which in turn is used in the calculation of the
fluid density. If a value is not supplied, the fluid’s critical pressure
will be estimated using an internal correlation based on mole weight.
6-6
Fluids 6-7
6-7
6-8 Fluid View
Composition Basis
Radio Button: Mass/Mole
This radio button selects the basis for the composition data. Note
that changing it does not convert any existing component fraction
data to the new basis.
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.
6-9
6-10 Assist Fluid View
Smokeless Operation
Checkbox
If selected Flaresim will calculate the flow of assist fluid required for
smokeless operation of the flare tip. When cleared, Flaresim will use
the defined flow or flow ratio defined on the Tip object to calculate
the flow rate of the assist fluid. Checking this option displays
additional fields as shown in Figure 6-5.
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
When Air is the assist fluid, high ratios of 5.0 or more may be used.
When Steam/Water is the assist fluid the mass ratio should not
exceed 0.5 since this would lead to flame instability and a potential
flameout.
6-11
6-12 Assist Fluid View
6-12
Environment 7-1
7 Environment
Page
7.1 Environment View . . . . . . . . . . . . . . . . . . . .4
7.1.1 Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
7.1.2 Overall Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 5
7.1.3 Wind Rose Tab . . . . . . . . . . . . . . . . . . . . . . . 9
7-1
7-2
7-2
Environment 7-3
7-3
7-4 Environment View
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.
7-4
Environment 7-5
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.
Beaufort
knots mph ft/s m/s
Scale
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.
7-5
7-6 Environment View
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 flare’s 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
measurements to the relative humidity, an example of which can be
found in “The Chemical Engineers Handbook”. The humidity value
is used in calculation of Transmissivity as described below.
Atmosphere - Pressure
Range: 0.01 to 10.0 bara
The atmospheric pressure is used to calculate the exit density of the
flared gas and hence its exit velocity.
Background - Radiation
Range: 0 to 100,000 W/m2
The incident solar radiation for the site. Typical values for different
geographical locations are given in the following table.
Solar Radiation
Location
(W/m2)
UK Land 630-790
7-6
Environment 7-7
Background - Noise
Range: 0 to 150 dB
The background noise is used as a reference noise level to which the
noise from the flare system is added.
The following table gives typical noise levels for everyday
situations.
0 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
Transmissivity - Method
Options: User/Calculated/CalcNoLimits
The value for the atmospheric transmissivity may be either specified
by the user or calculated. The calculation method used is described
in section 14.1.5 and estimates transmissivity as a function of the
relative humidity at the site and the distance of the receptor from the
flame. The correlation is strictly valid for distances between 30-164
m (100-500 ft) and for relative humidities greater than 10%. Outside
of these ranges the correlation may still give acceptable results.
7-7
7-8 Environment View
If Calculated is selected the value for the relative humidity at the site
must be entered. The transmissivity will be calculated, enforcing the
distance limits of the correlation i.e. distances less that 30m will be
set to 30m (100ft) and distances greater than 164m (500 ft). The
minimum and maximum values of transmissivity used during the
calculations will be displayed.
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.
It must be specified if the Transmissivity Method is set to User.
7-8
Environment 7-9
7-9
7-10 Environment View
Figure 7-2, Wind Rose Tab, Range of speeds for all directions
When this option is selected, multiple lines, one for each wind speed
will appear on the Wind Rose plots for each Receptor point.
Selecting this checkbox automatically clears the checkbox labeled
“Run each wind direction with a specific speed”.
When this option is selected, a single line will appear on the Wind
Rose plots for each Receptor point. Selecting this checkbox
7-10
Environment 7-11
Figure 7-3, Wind Rose Tab, Specified speed for each direction
7-11
7-12 Environment View
7-12
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.
8-4
Stacks 8-5
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.
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.
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.
Size Me
Button
Clicking this button automatically selects this stack for a sizing
calculation. Note that only one stack can be selected for sizing at a
time. The stack that is currently being sized can be viewed on the
Sizing tab of the Calculation Options view
8-6
Tips 9-1
9 Tips
Page
9.1 Tip View. . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
9.1.1 Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
9.1.2 Details Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 5
9.1.3 Location & Dimensions Tab . . . . . . . . . . . 13
9.1.4 Fluids Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9.1.5 Results Tab . . . . . . . . . . . . . . . . . . . . . . . . . 18
9.1.6 Noise Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 20
9.1.7 Flame Shape Tab . . . . . . . . . . . . . . . . . . . . 22
9.1.8 Purge Gas Tab . . . . . . . . . . . . . . . . . . . . . . 23
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.
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.
For gases, either the pipe or sonic tip types may be selected. Pipe
flares are the simplest type of tip and may be specified for both high
and low pressure gases. If the pressure available is greater than 2 bar
(30 psi) at the tip then a sonic tip can be utilised. Sonic flare tips have
the advantage of low flame emissivities due to more efficient
combustion of the flare gas. For lower pressures a pipe flare is
generally used possibly with steam or air assistance (see 6.2).
9-5
9-6 Tip View
Figure 9-2 shows the general design concept for the fluidic seal. The
type selection is a function of the opening as defined below
Fluidic1: 50% of total area
Fluidic2: 40% of total area
Fluidic3: 35% of total area.
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.
Diameter
9-7
9-8 Tip View
E = 0.2 ⋅ 50 ⋅ MW + 100-
-----------------------------------
900
High Efficiency:Proprietary correlation between tip type, exit
velocity, fluid molecular weight and degree of
hydrocarbon saturation. Formally known as the
Flaresim method in versions prior to 1.2.
Cook: Correlation based on exit velocity.
Generic Pipe: Correlation based on refitting Kent, Tan, Natural gas
and Cook methods across a range of exit velocities
and molecular weights.
9-8
Tips 9-9
Typical values for different types of flare tip are given in the
following table.
9-9
9-10 Tip View
Tip Type I1 I2
User Multiplier
Range 0 to 2
User defined value of constant I1 for flame length equation.
User Power
Range 0 to 2
User defined value of constant I2 for flame length equation.
9-10
Tips 9-11
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.
9-11
9-12 Tip View
9-12
Tips 9-13
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.
9-13
9-14 Tip View
booms does have the advantage of directing both the flame and any
liquid carryover away from the main platform structure.
Dimensions - Diameter
Range: 0.001 to 10m
The internal diameter of the burner assembly.
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-14
Tips 9-15
Dimensions - Roughness
Range: 0 to 0.001m
The roughness of the riser to this tip to be used in calculating the
riser pressure drop.
The tip exit pressure is used to calculate the properties of the gas at
the exit and hence the velocity of the fluid.
Size Me
Button
The Size Me button opens a pop up window to allow the diameter of
the tip to be sized for a specific exit velocity, optionally using
standard pipe sizes. See section 9.2 for details.
9-15
9-16 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
9-16
Tips 9-17
9-17
9-18 Tip View
9-18
Tips 9-19
9-19
9-20 Tip View
9-20
Tips 9-21
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.
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-21
9-22 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 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-22
Tips 9-23
9-23
9-24 Tip View
Note that all calculations are based on the stack diameter not the tip
diameter using purge gas properties calculated at the temperature
and pressure defined for the currently selected environment.
9-24
Tips 9-25
Figure 9-12
Mass Flow
Range 0 to 10,000 kg/s
This field defines the mass flow that the tip is to be sized for. The
value specified here will default to the value entered on the Fluids
tab of the Tip view. If changed and the Ok button is used to exit the
Size Tip view the mass flow on the Fluids tab will be updated.
Mach Number
Range 0 to 1
This field defines the Mach Number that the tip is to be sized for.
Alternatively if the Tip Diameter is specified the Mach Number will
be calculated and displayed here.
Tip Diameter
Range 0.001 to 10m
The diameter of the tip. If Mach Number is specified then the
calculated tip diameter is displayed here. Otherwise the tip diameter
can be specified to calculate the Mach Number.
Note this field will be inactive when Standard Diameters are used.
9-25
9-26 Size Tip View
Nominal Diameter
List box: Nominal pipe diameters for STD schedule pipes
This list box can be used to select the nominal diameter for the Tip
assuming that it is a STD schedule pipe. The actual diameter will
then be set by look up from the nominal diameter.
Note selection of Nominal Diameter will only reset the Tip Diameter
when the Use Standard Diameters checkbox is activated.
9-26
Receptors 10-1
10 Receptors
Page
10.1 Receptor Point View . . . . . . . . . . . . . . . . . . 5
10.1.1 Common Fields . . . . . . . . . . . . . . . . . . . . . . 5
10.1.2 Point Definition Tab . . . . . . . . . . . . . . . . . . . 6
10.1.3 Thermal Results Tab. . . . . . . . . . . . . . . . . . 10
10.1.4 Noise Results . . . . . . . . . . . . . . . . . . . . . . . .11
10.1.5 Wind Rose Results. . . . . . . . . . . . . . . . . . . 12
10-1
Receptors 10-2
Page
10.5 Using Overlays . . . . . . . . . . . . . . . . . . . . . . 43
10.5.1 Simple Drawing . . . . . . . . . . . . . . . . . . . . . 43
10.5.2 Import Scaled Drawing . . . . . . . . . . . . . . . 46
10.5.3 Import Unscaled Bitmap . . . . . . . . . . . . . . 48
10.5.4 DXF Files. . . . . . . . . . . . . . . . . . . . . . . . . . . 49
10-2
10-3
10-3
10-4
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 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.
10-4
Receptors 10-5
10-5
10-6 Receptor Point View
Ignored
Checkbox
Clear to calculate the results for this Receptor Point or set to ignore
this point when calculating.
Location - Relative To
Drop down list of existing locations
Allows the location of the receptor point to be defined relative to
another object in the model, for example the base of a stack. If left
blank the location is relative to the base point of the model at 0,0,0.
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 receptor point 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 receptor point 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 receptor point above or below the selected
reference location. Updates made to this value will automatically
update the polar coordinate values.
10-6
Receptors 10-7
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.
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.
This option is only active when the Expert Options check box is set
in the Calculation Options view.
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.
10-7
10-8 Receptor Point View
Properties - Absorbtivity
Range: 0.0001 to 1.0
The absorbtivity of the point which will be used in the heat balance
Incident radiation
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.
Heat Loss Properties - Area Ratio
E.g. A plate would have an
Range: 0.0001 to 10,000
arearatio of 2.0.
The ratio of the area available to allow the receptor to lose heat to
the area of the receptor exposed to the thermal radiation.
A plate with one face exposed to a flare would have an Area Ratio
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.
10-8
Receptors 10-9
Design
Radiation Conditions
W/m2
10-9
10-10 Receptor Point View
10-10
Receptors 10-11
Display
Dropdown: Table / Plot
Selects whether the calculated change in temperature of the receptor
point with time is displayed as a table or as a graph.
Export
Button
Allows the calculated curve of time vs. point temperature 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 Receptor Point View
SPL
Calculated Value
The total sound pressure level at the receptor point. It is calculated
by summing the sound pressure contributions at each frequency.
SPLA
Calculated Value
The A-weighted sound pressure level calculated at the receptor
point. It is calculated by summing the A-weighted sound pressure
levels at each frequency.
Average SPL
Calculated Value
The sound pressure level averaged across all the frequencies.
Display
Dropdown: Table / Plot
Selects whether the sound pressure levels vs. frequency results are
displayed as a table or as a graph.
Export
Button
Allows the calculated sound pressure 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-12
Receptors 10-13
Layout files describe the background text, data items and graphics
formatting instructions required to define a graphics report in an
XML formatted file with the extension .LAY. A number of standard
layout files are shipped with Flaresim to provide graphic report
definitions for 1 and 2 stack systems with 1 or 2 tips on A4 and
Letter paper sizes. Appendix A describes the structure and the
elements that make up a layout file.
10-13
10-14 Receptor Point View
Browse
Command Button
This opens a standard file open dialog to allow selection of the
layout file for the graphical report of the wind rose plot.
Generate Report
Command Button
This creates a new graphical report window to display the wind rose
results in a graphical report alongside selected data items for the
model. The layout of this report is controlled by the layout file
selected. The graphic report is displayed in its own window and by
default is displayed as a maximised view. The graphic report
window can be minimised, resized and closed using standard
windows methods. A sample is shown below.
Wind rose graphic reports can be printed using the File - Print
Graphic Report menu item.
10-14
Receptors 10-15
Export
Command button
This allows just the wind rose plot to be exported as a standalone
graphics file. A standard windows file save dialog will appear to
allow the name and type of the file to be defined. The plot may be
exported to a JPG, PNG, BMP, WMF or EMF graphics file.
10-15
10-16 Receptor Point Summary View
Export Table
Button
Clicking this button opens a File Save dialog to allow the Receptor
Points summary table to be saved as a comma separated value (CSV)
file. Files of this data type can be opened easily using Excel or other
applications.
10-16
Receptors 10-17
Status Text
Status message
The message displayed in this field and its colour indicates whether
the data for this Receptor Grid object is complete and ready for
calculation.
10-17
10-18 Receptor Grid View
Ignored
Checkbox
Clear to calculate the results for this Receptor Grid or set to ignore
this grid when calculating.
Orientation
Radio buttons: Northing-Easting / Northing - Elevation /
Easting - Elevation
This set of radio buttons selects the orientation plane of the receptor
grid. Receptor grids are set up for one of the three orthogonal planes.
In Flaresim terminology, the X-Y plane is Northing-Easting, the X-
Z plane is Northing-Elevation and the Y-Z plane is Easting-
Elevation.
Once selected the other fields are used to define the receptor grids
location and extent and the fineness or coarseness of the grid. The
names of these fields will be updated appropriately. For example
when the orientation is set to Northing-Elevation, the offset field
will be titled Easting Offset, the next group of fields will be titled
Northing and the next block Elevation.
Offset
Range: -100,000 to 100,000 m
The offset of the receptor grid plane from the model origin.
Title
Text
The name to be used for this axis of the grid.
Min
Range: -100,000 to 100,000 m
The minimum extent of the grid in the labeled direction.
10-18
Receptors 10-19
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.
This option is only active when the Expert Options checkbox is set
in the Calculation Options view.
10-19
10-20 Receptor Grid View
10-20
Receptors 10-21
Display
Dropdown: Table / Plot
Selects whether the thermal radiation results are displayed as a table
or as a graph.
10-21
10-22 Receptor Grid View
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,
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.
Refresh
Button
Redraws the displayed radiation plot.
Zoom to - Table
Range -10000 to 10000m
These values zoom the plot size to the specified values. The current
contour values are not recalculated but are redrawn on the new
scales. The column labels of the table will change to reflect the
orientation of the grid, Northing - Easting, Northing - Elevation or
Easting - Elevation. The first row of the table will always denote the
minimum extent of the plot and the second row the maximum extent.
The plot can also be zoomed by clicking the left mouse button on the
plot and dragging to select the new area. When the zoom dimensions
are set in this way they will be rounded to the precision set in the
Round to field.
Zoom to - Apply
Button
This button redraws the plot with the dimensions reset to the current
values in the zoom table.
Zoom to - Reset
Button
This button redraws the plot with the plot dimensions reset to the
overall grid dimensions set on the Details tab.
10-22
Receptors 10-23
Zoom to - Round to
Range 1 to 500
This field defines how the zoom dimensions are to be rounded when
the zoom is defined by clicking and dragging with the mouse.
Display
Dropdown: Table / Plot
Selects whether the sound pressure results are displayed as a table or
as a graph.
10-23
10-24 Receptor Grid View
Export
Button
Allows the calculated sound pressure 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-24
Receptors 10-25
Display
Dropdown: Table / Plot
Selects whether the temperature results are displayed as a table or as
a graph.
Export
Button
Allows the calculated temperature 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-25
10-26 Receptor Grid View
Isopleth - Radiation
Range: 1 to 10000 W/m2
Allows the thermal radiation limits for isopleths on the Radiation
plot to be defined. Clear the radiation value to remove an isopleth
from the list.
Isopleth - Noise
Range: 1 to 200 dB
Allows the noise limits for isopleths on the Noise plot to be defined.
Clear the noise value to remove an isopleth from the list.
10-26
Receptors 10-27
Isopleth - Temperature
Range: 10 to 10,000 K
Allows the temperature limits for isopleths on the Temperature plot
to be defined. Clear the temperature value to remove an isopleth
from the list.
Reset Defaults
Button
This resets all of the current isopleth definitions to the current
defaults.
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
10-27
10-28 Receptor Grid View
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.
10-28
Receptors 10-29
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-29
10-30 Receptor Grid View
Layout File
Filename
This defines the name of the graphic report layout file that will be
used to generate the graphic report for this receptor grid.
Layout files describe the background text, data items and graphics
formatting instructions required to define a graphics report in an
XML formatted file with the extension .LAY. A number of standard
layout files are shipped with Flaresim to provide graphic report
definitions for 1 and 2 stack systems with 1 or 2 tips on A4 and
Letter paper sizes. Appendix A describes the structure and the
elements that make up a layout file.
The default layout file used for new receptor grid objects is defined
in the Preferences view.
Browse
Button
Clicking this button opens a standard windows file browser to allow
a layout file to be selected.
10-30
Receptors 10-31
10-31
10-32 Overlay Editor
10-32
Receptors 10-33
Units
Drop Down List of Length Units
This selects the dimension units used and displayed by the plot
editor. Normally this will be selected to be compatible with the units
used to define the receptor grid.
X Axis Min
Length -10000 to 10000 m
This is the minimum X coordinate of the overlay graphic.
X Axis Max
Length -10000 to 10000 m
This is the maximum X coordinate of the overlay graphic.
X
Length - Display only
This is the current X coordinate of the cursor in the editor.
Y Axis Min
Length -10000 to 10000 m
This is the minimum Y coordinate of the overlay graphic.
Y Axis Max
Length -10000 to 10000 m
This is the maximum Y coordinate of the overlay graphic.
Y
Length - Display only
This is the current Y coordinate of the cursor in the editor
10-33
10-34 Overlay Editor
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-34
Receptors 10-35
Selects Draw mode for the editor. This acts as a toggle with
the Edit mode icon. When this icon is displayed the editor is
in Edit mode and the cursor will be shown as a simple
pointer.
Selects the Edit mode for the editor. This acts as a toggle
with the Draw mode icon. When this icon is displayed the
editor is in Draw mode and the cursor will show the draw
object type currently selected as well as the pointer.
10-35
10-36 Overlay Editor
10-36
Receptors 10-37
The properties in the drop down list that can be set are.
Line Colour
This displays a standard windows Colour Selection Dialog as shown
below. Click the colour required and then the Ok button. The
selected colour applies to individual line objects, polyline objects
and the outside lines for rectangle, rounded rectangle, ellipse and
polygon objects.
10-37
10-38 Overlay Editor
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.
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.
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-38
Receptors 10-39
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.
10-39
10-40 Overlay Editor
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 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-40
Receptors 10-41
Once selected the image is added by clicking and holding the left
mouse button to define the first corner then dragging to the opposite
corner and releasing the mouse button. A new copy of the image file
will be inserted into the plot each time this action is repeated.
Selecting Objects
A single object can be selected by clicking on it with the left mouse
button. Once selected the object will display white boxes at the
corners and sides of its bounding rectangle as shown below.
10-41
10-42 Overlay Editor
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.
10-42
Receptors 10-43
4. 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.
10-43
10-44 Using Overlays
10-44
Receptors 10-45
10-45
10-46 Using Overlays
10. Finally click the button to save the drawing. A standard file
save dialog will appear to ask you to name the file to be
saved. By default the file will be saved as a Flaresim
Graphics file with a .FSG but you may also save it as a
Windows Metafile (.WMF), Enhanced Metafile (.EMF) or
Autocad DXF file (.DXF). It is suggested that you save
background graphics files in the report subfolder for the
case i.e. in this case the subfolder “example 4 - welltest
safety.
10-46
Receptors 10-47
10-47
10-48 Using Overlays
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-48
Receptors 10-49
10-49
10-50 Using Overlays
10-50
Receptors 10-51
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 a script file that will allow the isopleth points to
be imported into the plot plan drawing using Autocad or a
compatible application. See the Create DXF Script option on the
Print Graphic Reports view.
10-51
10-52 Using Overlays
10-52
Shields 11-1
11 Shields
Page
11.1 Shield View . . . . . . . . . . . . . . . . . . . . . . . . . .4
11.1.1 Common Fields . . . . . . . . . . . . . . . . . . . . . . 4
11.1.2 Details Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 5
11.1.3 Details Tab - User Water Screen Method . . 5
11.1.4 Details Tab - Long Water Screen Method. . 7
11.1.5 Sections Tab . . . . . . . . . . . . . . . . . . . . . . . . . 8
11-1
11-2
11-2
Shields 11-3
The Shield object models the use of water sprays or solid shields to
reduce the transmission of radiation and noise. Each shield object is
composed of one or more polygonal shapes or sections. Multiple
sections may be defined to describe complex shield structures such
as a burn pit.
11-3
11-4 Shield View
Status Text
Status message
The message displayed in this field and its colour indicates whether
the data for this shield object is complete and ready for calculation.
Ignored
Checkbox
Clear to include this shield in the calculations or set to ignore this
shield when calculating.
11-4
Shields 11-5
Radiation - Type
Dropdown List - User / Water Screen
This dropdown list selects the type of shield. The User option is used
for solid shields or water screens when it is desired to specify the
transmissivity of the screen directly. The Water Screen option is
used when it is desired the calculate the transmissivity for a known
thickness of a water screen.
When this field is set to to User the view changes to display the
Transmissivity field to allow the tranmissivity to be defined. When
the field is set to Water Screen the view changes to that shown in
Section 11.1.3 below.
Radiation - Transmissivity
Range 0 to 1
This defines the fraction of radiation transmitted by the shield. This
field is only displayed when the Type field is set to User.
Noise - Transmissivity
Range 0 to 1
This defines the fraction of noise transmitted by the shield. The
factor is applied to the noise power.
11-5
11-6 Shield View
Layer Thickness
Range 0.001 to 1000 mm
This field defines the thickness of the water screen. The thickness
will be used to calculate the transmissivity of the water screen as a
function of the thickness and the flame temperature of the flare.
11-6
Shields 11-7
Water Flow
Range 0 to 1000 m3/s
This field defines the water flow rate for the calculation of the water
screen layer thickness using the Long method.
Nozzle Diameter
Range 0 to 1000 mm
This field defines the nozzle diameter for the calculation of the water
screen layer thickness using the Lond method.
11-7
11-8 Shield View
Droplet Velocity
Range 1 to 20 m/s
This field defines the droplet velocity to be used in the calculation of
the water screen layer thickness using the Long method.
Nozzles
Range 1 to 100
The number of water spray nozzles used.
Layer Thickness
Calculated result
This field displays the thickness of the water screen layer calculated
using the Long method.
11-8
Shields 11-9
Add Section
Button
Opens the Shield Section Editor view ready to define a new shield
section. See 11.2.
Edit Section
Button
Opens the Shield Section Editor view loaded with data for the
selected shield section. See 11.2.
Remove Section
Button
Deletes the selected shield section.
Make Pit
Button
Opens the Pit Builder view ready to define a new shield. See 11.3.
Transform
Button
Opens the Transform view to rotate or move the shield. See 11.4.
11-9
11-10 Shield Section Editor
Add Vertex
Button
This button adds a new vertex to the bottom of the list.
Delete Vertex
Button
This button deletes the selected vertex from the list.
Northing
Range -1000 to 1000 m
The northing coordinate of the vertex.
Easting
Range -1000 to 1000 m
The easting coordinate of the vertex.
11-10
Shields 11-11
Elevation
Range -1000 to 1000 m
The elevation coordinate of the vertex.
Make Rectangle
Button
Clicking this button opens the Rectangle Builder view. See section
11.2.1 below. This allows the rapid definition of a rectangular shield
section.
Make Polygon
Button
Clicking this button opens the Polygon Builder view. See section
11.2.2 below. This allows the rapid definition of a polygonal shield
section.
If vertices are not entered in the correct order their correct extent
cannot be calculated and the radiation and noise reduction results
will be misleading and inaccurate. This can usually be seen as very
irregular isopleths in the Receptor Grid view.
11-11
11-12 Shield Section Editor
Height
Range 0 to 1000m
The height of the shield section.
Width
Range 0 to 1000m
The width of the shield section.
11-12
Shields 11-13
OK
Button
Closes the Rectangle Builder view, accepting the changes made in
the data. Note any existing shield section data will be replaced by the
new rectangular section.
Cancel
Button
Closes the Rectangle Builder view, discarding the changes made in
the data.
11-13
11-14 Shield Section Editor
Number of Vertices
Range 3 to 100
The number of vertices that will define the extents of the shield
section. The default number of 12 will approximate a circular spray
shield to a reasonable accuracy though a greater number can be used
if required.
Radius
Range 0.1 to 1000m
The radius of the polygonal shield section i.e. the distance from the
centre of the polygon to each vertex.
11-14
Shields 11-15
OK
Button
Closes the Polygon Builder view, accepting the changes made in
the data. Note any existing shield section data will be replaced by the
new polygon section.
Cancel
Button
Closes the Polygon Builder view, discarding the changes made in
the data.
11-15
11-16 Pit Builder
Length
Range 0.1 to 1000m
The length of the burn pit. The length is assumed to be the dimension
in the north-south direction.
Width
Range 0.1 to 1000m
The width of the burn pit.The width is assumed to be the dimension
in the east-west direction.
Depth
Range 0.1 to 1000m
The depth of the burn pit.
11-16
Shields 11-17
OK
Button
Closes the Pit Builder view, accepting the changes made in the data.
Note any existing shield section data will be replaced by the new pit
data.
Cancel
Button
Closes the Pit Builder view, discarding the changes made in the
data.
11-17
11-18 Transform View
Move - North
Range -10000 to 10000 m
This defines the distance the shield sections are to be moved in the
north-south direction.
Move - East
Range -10000 to 10000 m
This defines the distance the shield sections are to be moved in the
east-west direction.
Move - Elevation
Range -10000 to 10000 m
This defines the distance the shield sections are to be moved up or
down.
11-18
Shields 11-19
Apply
Button
This applies the specfied movement or rotation to the shield section.
For simultaneous movement and rotation it should be noted that the
order in which these are applied is firstly movement, secondly
rotation from North around the vertical axis and finally rotation from
horizontal around the horizontal axis.
11-19
11-20 Water Screen Characteristics
Display
Dropdown list - Transmissivity Table / Transmissivity Graph /
Absorption Coeff
This selects the data displayed by the view.
11-20
Calculations 12-1
12 Calculations
Page
12.1 Calculation Options View . . . . . . . . . . . . . .3
12.1.1 General Tab. . . . . . . . . . . . . . . . . . . . . . . . . . 4
12.1.2 Sizing Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
12.1.3 Heat Transfer Tab . . . . . . . . . . . . . . . . . . . . 10
12.1.4 Fitting Tab . . . . . . . . . . . . . . . . . . . . . . . . . . .11
12-1
12-2
12-2
Calculations 12-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.
12-3
12-4 Calculation Options View
Method
Dropdown list: Flaresim API / Strict API / Point / Diffuse / Mixed /
Brzustowski / M.Point Brz
Selects the method to be used to model the thermal radiation from
the flame.
The Flaresim API and Strict API methods model the single point
source method of Hajek and Ludwig given in API RP-521. The
difference between the methods is in the method of calculating the
flame shape before finding the centre point to act as the source. The
Flaresim API method uses the vector based flame shape method and
allows multiple flame elements to be used to model the shape more
accurately even though a single, centre point will be used as the
source. The Strict API method uses the graphical method presented
in API 521 through a curve fit to the data presented there. The API
method in DOS versions of Flaresim and Flaresim for Windows
versions prior to version 2.0 was the Flaresim API method. Either
API method may be generally applied to most flare systems.
12-4
Calculations 12-5
Element Position
Range: 0 to 100 %
The element position indicates the source point within a flame
element that is used for calculations. Typically this is 50% i.e. the
middle of the flame element is taken to be the point source. 0%
indicates the source is the start of the element, 100% is the end. For
compatibility with Flaresim for DOS, 50% should be used.
No of Elements
Range: 1 to 50
The number of elements that the flame is divided into for calculation
of flame shape and the sources for the Point, Diffuse and Mixed
methods. Larger values will generally give more realistic values for
the thermal radiation at the expense of calculation time.
12-5
12-6 Calculation Options View
of a high flaring rate and an inclined tip flaring into a high wind may
require 50 elements to adequately model the flame shape.
12-6
Calculations 12-7
The results of the two methods will be similar at low pressures (< 5
bar). At higher pressures the Redlich-Kwong method is more
accurate so it is set to be the default method for all new cases from
Version 1.1 onwards.
Buoyancy
For all methods except the Brzustowski method, the flame shape is
calculated by resolving the velocity vectors in three dimensions. The
main components are the tip exit velocity and the wind velocity.
There is however an additional velocity component which is due to
12-7
12-8 Calculation Options View
the density differences between the hot combustion gases and the
surrounding air. This is referred to as the flame buoyancy term.
Buoyancy - Pipe
Range: 0 to 100 m/s
The flame buoyancy which should be used for Pipe flares. A value
of 3.0 m/s is recommended unless specific vendor information
suggests otherwise.
Buoyancy - Sonic
Range: 0 to 100 m/s
The flame buoyancy to be used for Sonic flare tips. A value of 4.6
m/s is suggested unless specific vendor information suggests
otherwise.
Buoyancy - Welltest
Range: 0 to 100 m/s
The flame buoyancy to be used for Liquid flare tips. A value of 0.03
m/s is suggested unless specific vendor information suggests
otherwise.
12-8
Calculations 12-9
12-9
12-10 Calculation Options View
B
HTC = A ⋅ Windspeed + C (1)
12-10
Calculations 12-11
Windspeed Up To
Range: 0.01 to 100 m/s
The transition windspeed at which the heat transfer coefficient
calculation switches from the first set of defined constants to the
second.
Windspeed Units
Dropdown List: Speed Units
This dropdown selects the windspeed units that are appropriate for
the A and C constants entered.
Time Steps
Range: 1 to 1,000
The number of calculations to be made between the starting point
and the final exposure time. A higher number will track the rise in
surface temperature more accurately but it will not normally be
necessary to use more than 10 points.
The data fields that control the fitting process are shown below.
12-11
12-12 Calculation Options View
Select Tip
Dropdown List
This selects the Tip whose F Factor value is to be adjusted to try to
match the calculated and observed values of radiation. The list
shows all of the tips configured in the model. The tip that is selected
must have its F Factor method set to User Defined. It does not matter
what starting value of F Factor is defined on the tip.
Select Point
Dropdown List
This selects the Receptor Points which are to be included in the
fitting calculation. Either a single point can be selected or the “All
Active” option can be selected in which case all Receptor points that
are not set to Ignored will be included in the calculation.
Run
Command Button
Clicking this starts the fitting process. The fitting process first
reconfigures the model to solve for Receptor points only. It will then
12-12
Calculations 12-13
set the selected Tip to a low F Factor and run the model to calculate
the radiation at each selected Receptor point. The sum of the square
of the relative errors between the calculated and observed radiation
values will then be calculated. The F Factor is then raised by a step
and the process repeated until the calculated error begins to rise. At
this point a bisection search for the F Factor that gives the minimum
value for the error is obtained.
When the value of the F Factor that gives the minimum error has
been found the whole model will be reinstated and re-run at the
resulting F Factor.
Result
Calculated value
This displays the value for the F Factor that was calculated by the
fitting process.
Error
Calculated value
This displays the square root of the sum of the relative errors
between the calculated and observed radiation values for the
selected Receptor points.
Note if the fitting process is run for a single Receptor Point the final
error should always be 0 as long as there is a feasible value for the F
Factor which cannot be greater than 1.
12-13
12-14 Calculation Options View
12-14
Printing 13-1
13 Printing
Page
13.1 Print Preview . . . . . . . . . . . . . . . . . . . . . . . . 4
13.1.1 Report File . . . . . . . . . . . . . . . . . . . . . . . . . . 6
13-1
13-2
13-2
Printing 13-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.
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.
13-3
13-4 Print Preview
Report Topic
Structure
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.
13-4
Printing 13-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.
Once the printer options have been set the Print button on this view
should be clicked to send the output to the printer.
13-5
13-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.
This HTML file can be viewed at any time using an internet browser,
independently of Flaresim.
13-6
Printing 13-7
Select Grids
List Box
This list box allows selection of the Receptor Grids and Receptor
Points for which a 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. Note the list will only show Receptor Points when
there are points with Wind Rose results available.
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
and receptor points in the model.
13-7
13-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.
13-8
Printing 13-9
The script generated will create one new layer in the target drawing
file for each isopleth value defined. Each layer will be named
according to the isopleth value and the isopleth value will also be
displayed on a text label within the added layer. An additional layer
will be created to draw the flame location. Note that the generated
script requires that the “Snap to guides” features of Autocad are
turned off before playing the script.
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.
13-9
13-10 Graphic Report
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.
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.
13-10
Printing 13-11
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.
13-11
13-12 Print Setup
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.
13-12
Printing 13-13
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.
13-13
13-14 Print Setup
13-14
Calculation Methods 14-1
14 Calculation Methods
Page
14.1 Thermal Radiation . . . . . . . . . . . . . . . . . . . .5
14.1.1 API Method . . . . . . . . . . . . . . . . . . . . . . . . . . 5
14.1.2 Integrated Point Source Method. . . . . . . . . 6
14.1.3 Integrated Diffuse Source Method . . . . . . . 7
14.1.4 Integrated Mixed Source Method . . . . . . . . 7
14.1.5 Brzustowski and Sommer Method . . . . . . . 8
14.1.6 Atmospheric Attenuation . . . . . . . . . . . . . . 8
14.1.7 Windchill . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
14.1.8 Flame Shape . . . . . . . . . . . . . . . . . . . . . . . . 10
14.3 Noise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
14.3.1 Combustion Noise . . . . . . . . . . . . . . . . . . . 18
14.3.2 Jet Noise . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
14.3.3 Atmospheric Attenuation . . . . . . . . . . . . . 22
14.4 Nomenclature . . . . . . . . . . . . . . . . . . . . . . . 24
14.4.1 Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
14.4.2 Subscripts. . . . . . . . . . . . . . . . . . . . . . . . . . 25
14-1
Calculation Methods 14-2
Page
14.6 Water Sprays . . . . . . . . . . . . . . . . . . . . . . . 29
14.6.1 Thickness of Water Curtain . . . . . . . . . . . 30
14.7 References . . . . . . . . . . . . . . . . . . . . . . . . . 31
14-2
Calculation Methods 14-3
14-3
14-4
14-4
Calculation Methods 14-5
14-5
14-6 Thermal Radiation
FQ
K = -------------- (1)
2
4πD
14-6
Calculation Methods 14-7
FQ L 1
4πL 0 D 2 ∫
K ips = ---------- ------- dl (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 β
2
π L 0 D
∫
K ids = --------- ----------- dl
2
(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.
14-7
14-8 Thermal Radiation
The distance between the point source and the receptor is calculation
from a flame shape which is based upon the diffusion of a turbulent
jet to the to the lean flammability concentration limit [3].
Kτ = τ ⋅ K (5)
14-8
Calculation Methods 14-9
14.1.6 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.
Kw = K – Kf (7)
14-9
14-10 Thermal Radiation
14-10
Calculation Methods 14-11
4WZRT
u j = ------------------- (8)
2
PMπd
The gas mach number is calculated from the sonic velocity which is
calculated from Equation 9.
gkRT
us = ------------- (9)
M
Q = W ⋅ LHV (10)
Q I2
L = I 1 ---- (11)
N
14-11
14-12 Thermal Radiation
Tip Type l1 l2
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.
1 1
u l = 5.0u j d --- – --- (12)
l A
dx
------ = u l sin Φ cos ω + u ∞ cos ψ (13)
dt
dy
------ = u l sin Φ cos ω + u ∞ sin ψ (14)
dt
dz
----- = u l cos Φ + u b (15)
dt
14-12
Calculation Methods 14-13
uj Mj
c l = c l ------ ⋅ -------- (16)
u∞ M∞
14-13
14-14 Thermal Radiation
xl
x l = --------------------------
dj uj ρ (17)
--------- ⋅ ------j-
u∞ ρ∞
zl
z l = --------------------------
dj uj ρ (18)
--------- ⋅ ------j-
u∞ ρ∞
Figure 14-3 gives the values for the horizontal and vertical distance
factors for a range of values for the dimensionless concentration
parameter..
14-14
Calculation Methods 14-15
14-15
14-16 Surface Temperature
Kα = ( h c + h r ) ⋅ ( T m – T ∞ ) (19)
The overall heat loss from the point is the sum of the radiation from
the point and the forced/free convection from the point. The
radiative heat transfer coefficient is given by:
4 4
( Tm – T∞ )
h r = σE ⋅ ------------------------------ (20)
( Tm – T∞ )
u ∞ > 15
0.75
h c = 0.56u ∞ (22)
14-16
Calculation Methods 14-17
14.3 Noise
The noise generated by a flare may be broken down into 3 basic
components:
• Combustion noise
• Jet noise
⎛ P2 ⎞
SPL = 10 log ⎜ ---------⎟ (24)
⎝ P 2⎠
0
14-17
14-18 Noise
The noise level at each frequency is then corrected for the actual
combustion duty and distance from Equation 26.
14-18
Calculation Methods 14-19
2
ρj uj (27)
PWL = ηV -----------
-
2
14-19
14-20 Noise
ρj ⎛ Tj ⎞ 2
B = ------- ⋅ ⎜ -------⎟ (28)
ρ ∞ ⎝ T ∞⎠
14-20
Calculation Methods 14-21
0.2mu s
f max = ----------------- (29)
dj
14-21
14-22 Noise
14-22
Calculation Methods 14-23
14-23
14-24 Nomenclature
14.4 Nomenclature
The following nomenclature is used in sections 14.1 through to 14.3.
14.4.1 Symbols
14-24
Calculation Methods 14-25
14.4.2 Subscripts
A Atmospheric attenuation
b Buoyancy
c Convective
f Correction
i Frequency band
ids Integrated diffuse source
ims Integrated mixed source
ips Intergrated point source
j Jet exit
l Curvelinear length
m Metal
r Radiative
s Sonic
w Corrected for windchill
∞ Wind/atmospheric
τ Corrected for transmissivity
0 Reference condition
20 At 20 ft from source
14-25
14-26 Purge Gas
where
Qp Purge rate (ft3/h)
d Stack diameter (in)
O2 % oxygen
y Depth into stack (ft)
Fb Gas buoyancy factor
∑ Ci
0.65
Fb = exp [ 0.065 ( 29 – M i ) ] (32)
i
where
Ci Volume fraction of ith component
Mi Molecular weight of ith component
14-26
Calculation Methods 14-27
1.5
F b = 6.25 [ 1 – 0.75 ( M ⁄ 28.96 ) ] (33)
where
M Molecular weight of purge gas.
If the purge gas buoyancy factor calculated using either method is
less than the buoyancy factor of nitrogen then the buoyancy factor
for nitrogen is used.
∑ Ci
3.46 0.65
Q p = 0.003528d Ki (34)
i
14-27
14-28 Purge Gas
where
Qp Purge rate (ft3/h)
d Stack diameter (in)
Ci Volume fraction of ith component
Ki Constant for ith component from following table
Component K
Hydrogen 5.783
Helium 5.078
Methane 2.328
1.707 (wind)
Ethane -1.067
Propane -2.651
0.65
If the sum of the C i K i terms is less than the K value for nitrogen
then the value for nitrogen is used.
14-28
Calculation Methods 14-29
E
τ = ------ (35)
Eb
where
τ Transmissivity
E Total transmitted flux
Eb Total black body radiated flux
λ max
E = ∫( λ min )
E λb exp ( – α λ ⋅ s ) (36)
where
E λb Black body radiation at wavelength λ , W/m2
λ Radiation wavelength, m
αλ Absorption coefficient at wavelength λ m-1
s Thickness of water curtain layer m
2 –5
E λb = ( 2πHc λ ) ⁄ ( exp ( ( Hc ) ⁄ ( KλT ) – 1 ) ) (37)
14-29
14-30 Water Sprays
where
H Planck constant J/s
c Speed of light m/s2
λ Wavelength of radiation m
K Boltzman constant J/K
T Temperature K
6u noz
s = ( ( 0.5D noz ) ⁄ π ) -------------
- (38)
u drop
where
s Layer thickness m
D noz Nozzle diameter m
u noz Nozzle exit velocity m/s
u drop Droplet velocity m/s
14-30
Calculation Methods 14-31
14.7 References
1. API RP521, “Guide For Pressure-Relieving and
Depressuring Systems”, 4th ed, American Petroleum
Institute, Washington DC, 1997.
14-31
14-32 References
14-32
OLE Interface 15-1
15 OLE Interface
Page
15.1 Overall Structure . . . . . . . . . . . . . . . . . . . . . 5
15.1.1 Accessing the Flaresim.Application Object 6
15.10IStack Object. . . . . . . . . . . . . . . . . . . . . . . . 38
15.12IGrid Object. . . . . . . . . . . . . . . . . . . . . . . . . 44
15.13IShields Object . . . . . . . . . . . . . . . . . . . . . . 56
15-1
OLE Interface 15-2
Page
15.14IShield Object . . . . . . . . . . . . . . . . . . . . . . . 57
15.15IEnvironments Object . . . . . . . . . . . . . . . . 61
15.16IEnvironment Object . . . . . . . . . . . . . . . . . 62
15.17IFluids Object . . . . . . . . . . . . . . . . . . . . . . . 67
15.18IFluid Object . . . . . . . . . . . . . . . . . . . . . . . . 68
15.19IComponents Object . . . . . . . . . . . . . . . . . 72
15.20IComponent Object . . . . . . . . . . . . . . . . . . 73
15.21IAssists Object . . . . . . . . . . . . . . . . . . . . . . 75
15.22IAssist Object . . . . . . . . . . . . . . . . . . . . . . . 76
15-2
15-3
15-3
15-4
Small snippets of code in Visual Basic are provided to show how the
Flaresim OLE objects can be accessed. However this documentation
is intended to act as a reference guide rather than a complete guide
to the use of OLE technology.
15-4
OLE Interface 15-5
Flaresim.Application
ICase
IOptions
ITips
ITip
IPoints
IPoint
IStacks
IStack
IGrids
IGrid
IShields
IShield
IEnvironments
IEnvironment
IFluids
IFluid
IComponents
IComponent
IAssists
IAssist
15-5
15-6 Overall Structure
15-6
OLE Interface 15-7
CaseDetails() as ICase
Returns an ICase object which provides access to the case details.
Options() as IOptions
Returns an IOptions object which provides access to the calculation
options for the case.
Tips() as ITips
Returns an ITips object which provides access to the collection of
Tip objects in the case.
Stacks() as IStacks
Returns an IStacks object which provides access to the collection of
stack objects in the case.
Points() as IPoints
Returns an IPoints object which provides access to the collection of
Point objects in the case.
Grids() as IGrids
Returns an IGrids object which provides access to the collection of
Grid objects in the case.
Environments() as IEnvironments
Returns an IEnvironments object which provides access to the
collection of Environment objects in the case.
Shields() as IShields
Returns an IShields object which provides access to the collection of
Shield objects in the case.
Fluids() as IFluids
Returns an IFluids object which provides access to the collection of
Fluid objects in the case.
15-7
15-8 Flaresim Application Object
Assists() as IAssists
Returns an IAssists object which provides access to the collection of
Assist fluid objects in the case.
Components() as IComponents
Returns an IComponents object which provides access to the
collection of component objects in the case.
15-8
OLE Interface 15-9
15-9
15-10 Flaresim Application Object
15-10
OLE Interface 15-11
LASTMODIFIED A string with the time and date that the case was
last modified
15-11
15-12 IOptions Object
15-12
OLE Interface 15-13
15-13
15-14 IOptions Object
HTCWINDSPEED m/s Wind velocity limit for first heat transfer coefficient equa-
tion.
FITTINGERROR Unitless Square root of the sum of the squares of the relative errors
in the data fitting
SIZINGWINDSPEED m/s The windspeed selected for sizing when wind rose data is
used in sizing calculations
SIZINGWINDDIREC- radian The wind direction selected for sizing when wind rose data
TION is used in sizing calculations
15-14
OLE Interface 15-15
special empty value -32767.0 should be used with no unit string. The
method returns True if the value was set successfully or False if not.
HTCWINDSPEED m/s Wind velocity limit for first heat transfer coefficient equa-
tion.
SIZINGWINDSPEED m/s The windspeed selected for sizing when wind rose data is
used in sizing calculations
SIZINGWINDDIREC- radian The wind direction selected for sizing when wind rose data
TION is used in sizing calculations
15-15
15-16 IOptions Object
15-16
OLE Interface 15-17
15-17
15-18 ITips Object
Count() as Integer
Returns the number of tip objects in the ITips collection. Read only
property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
ITips collection.
Delete(What as Variant)
Deletes the tip specified by the What parameter. The What
parameter must be either an integer specifying the number of the tip
in the collection (first tip is number 1) or a string containing the
name of the tip.
15-18
OLE Interface 15-19
FLUID or FLUIDPRIMARY or The name of the primary fluid flowing through the
FLUID1 tip. “None” is returned if this is not set.
COMBNOISEMETHOD The method used for combustion noise for the tip.
15-19
15-20 ITip Object
FLUID or FLUIDPRIMARY or The name of the primary fluid flowing through the
FLUID1 tip.
TIPTYPE The type of the tip. The following values are rec-
ognised - Pipe, Sonic, Welltest, Hp/Lp
COMBNOISEMETHOD The method used for combustion noise for the tip.
The following values are recognised - Acoustic
Efficiency, Low Noise Reference, Standard Refer-
ence, User Reference
SEALTYPE The type of seal used for the tip. The following
values are recognised - None, Fluidic, Fluidic2,
Fluidic3, Mole1, Mole2
15-20
OLE Interface 15-21
15-21
15-22 ITip Object
PURGEHUSAHEIGHT m Depth into stack used for HUSA purge gas calcula-
tions.
PURGEFIXEDVOLFLOW- kg/s Calculated purge gas flow using fixed volume flow
CALCFLOW method.
15-22
OLE Interface 15-23
15-23
15-24 ITip Object
special empty value -32767.0 should be used with no unit string. The
method returns True if the value was set successfully or False if not.
The following values for varName are recognised.
PURGEHUSAHEIGHT m Depth into stack used for HUSA purge gas calcula-
tions.
15-24
OLE Interface 15-25
15-25
15-26 ITip Object
FLAMESHAPE Array(0 to 2) of string Array (0 to N-1, 0 to 2) of Double defining end points of the
defining coordinates. flame elements where
Default m/s N is total number of flame elements
Array(i, 0) is x (northing) coordinate of flame element i
Array(i, 1) is y (easting) coordinate of flame element i
Array(i, 2) is z (elevation) coordinate of flame element i
NOISEFREQUEN- Single string Array(0 to N-1) of Double defining frequencies for noise
CIES Default Hz frequency spectrum where
N is total number of frequencies
Array(i) is frequency of point i in the spectrum
NOISEJET Single string Array(0 to N-1) of Double defining jet noise results for the
Default Db frequency spectrum where
N is total number of frequencies
Array(i) is jet noise of point i in the spectrum
NOISEOVERALL Single string Array(0 to N-1) of Double defining overall noise results for
Default Db the frequency spectrum where
N is total number of frequencies
Array(i) is overall noise of point i in the spectrum
15-26
OLE Interface 15-27
NOISEREFERENCE- Single string Array(0 to N-1) of Double defining the noise reference data
DATA Default Db for the frequency spectrum where
N is total number of frequencies
Array(i) is noise reference value of point i in the spectrum
NOISEREFERENCE- Single string Array(0 to N-1) of Double defining the noise reference data
DATA Default Db for the frequency spectrum where
N is total number of frequencies
Array(i) is noise reference value of point i in the spectrum
15-27
15-28 IPoints Object
Count() as Integer
Returns the number of receptor point objects in the IPoints
collection. Read only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IPoints collection.
Delete(What as Variant)
Deletes the receptor point specified by the What parameter. The
What parameter must be either an integer specifying the number of
the receptor point in the collection (first receptor point is number 1)
or a string containing the name of the receptor point.
15-28
OLE Interface 15-29
15-29
15-30 IPoint Object
MASSPERUNITAREA kg/m2 The mass per unit area of the receptor point to be
used in calculation of rate of temperature rise.
15-30
OLE Interface 15-31
MASSPERUNITAREA kg/m2 The mass per unit area of the receptor point to be
used in calculation of rate of temperature rise.
15-31
15-32 IPoint Object
15-32
OLE Interface 15-33
NOISERESULTS Array(0 to 1) of string. Array (0 to N-1, 0 to 2) of Double defining the noise spec-
Array(0) - Frequency trum results where
unit, default Hz N is number of noise spectrum points
Array(1) - Noise unit, Array(i, 0) is frequency of spectrum point i
default Db Array(i, 1) is noise for spectrum point i
Array(i, 2) is A weighted noise for spectrum point i
15-33
15-34 IPoint Object
15-34
OLE Interface 15-35
LOCATIONPOLAR Array(0 to 2) of string. Array (0 to 2) of Double defining the receptor point location
Array(0) - radius coord coordinates relative to reference location in polar units
unit, default m Array(0) is radius coordinate
Array(1) - angle to hor- Array(1) is angle to horizontal coordinate
izontal unit, default Array(2) is angle from north coordinate
radian
Array(2) - angle to
north unit, default
radian
15-35
15-36 IPoint Object
15-36
OLE Interface 15-37
Count() as Integer
Returns the number of stack objects in the IStacks collection. Read
only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IStacks collection.
Delete(What as Variant)
Deletes the stack specified by the What parameter. The What
parameter must be either an integer specifying the number of the
stack in the collection (first stack is number 1) or a string containing
the name of the stack.
15-37
15-38 IStack Object
15-38
OLE Interface 15-39
15-39
15-40 IStack Object
STACKBASEXYZ Array(0 to 2) of string. Array (0 to 2) of Double defining the stack base location
Array(0) - x coord unit coordinates relative to reference location in cartesian coor-
Array(1) - y coord unit dinates
Array(2) - z coord unit Array(0) is x (northing) coordinate
All default m Array(1) is y (easting) coordinate
Array(2) is z (elevation) coordinate
STACKBASEPOLAR Array(0 to 2) of string. Array (0 to 2) of Double defining the stack base location
Array(0) - radius coord coordinates relative to reference location in polar units
unit, default m Array(0) is radius coordinate
Array(1) - angle to hor- Array(1) is angle to horizontal coordinate
izontal unit, default Array(2) is angle from north coordinate
radian
Array(2) - angle to
north unit, default
radian
15-40
OLE Interface 15-41
STACKBASEXYZ Array(0 to 2) of string. Array (0 to 2) of Double defining stack base location coor-
Array(0) - x coord unit dinates relative to reference location in cartesian coordi-
Array(1) - y coord unit nates
Array(2) - z coord unit Array(0) is x (northing) coordinate
All default m Array(1) is y (easting) coordinate
Array(2) is z (elevation) coordinate
15-41
15-42 IStack Object
STACKBASEPOLAR Array(0 to 2) of string. Array (0 to 2) Double defining stack base location coordi-
Array(0) - radius coord nates relative to reference location in polar units
unit, default m Array(0) is radius coordinate
Array(1) - angle to hor- Array(1) is angle to horizontal coordinate
izontal unit, default Array(2) is angle from north coordinate
radian
Array(2) - angle to
north unit, default
radian
15-42
OLE Interface 15-43
Count() as Integer
Returns the number of receptor grid objects in the IGrids collection.
Read only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IGrids collection.
Delete(What as Variant)
Deletes the receptor grid specified by the What parameter. The What
parameter must be either an integer specifying the number of the
receptor grid in the collection (first receptor grid is number 1) or a
string containing the name of the receptor grid.
15-43
15-44 IGrid Object
15-44
OLE Interface 15-45
15-45
15-46 IGrid Object
POINTAREARATIO Unitless The ratio of area available for heat loss to area
available for heat input for each point in the grid to
be used in calculation of rate of temperature rise
15-46
OLE Interface 15-47
POINTAREARATIO Unitless The ratio of area available for heat loss to area
available for heat input for each point in the grid to
be used in calculation of rate of temperature rise
15-47
15-48 IGrid Object
15-48
OLE Interface 15-49
RADIATIONISOVAL- Array(0 to 0) of String. Array (0 to N) of double defining radiation values for radia-
UES Array(0) - radiation tion isopleth lines where
unit, default W/m2 N is number of isopleth lines
Array(i) is radiation value of isopleth line i
RADIATIONISOCOL- Array(0 to 0) of String Array (0 to N) of Long defining colour values for radiation
OURS Array(0) - Dummy isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is colour value of isopleth line i as an RGB value
RADIATIONISPOT- Array(0 to 0) of String Array (0 to N) of Long defining line type values for radia-
YPES Array(0) - Dummy tion isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line type value of isopleth line i, 0 to 5.
15-49
15-50 IGrid Object
RADIATIONISOW- Array(0 to 0) of String Array (0 to N) of Long defining line width values for radia-
IDTHS Array(0) - Dummy tion isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line width in pixels of isopleth line i
NOISEISOVALUES Array(0 to 0) of String. Array (0 to N) of double defining radiation values for noise
Array(0) - noise unit, isopleth lines where
default Db N is number of isopleth lines
Array(i) is noise value of isopleth line i
NOISEISOCOLOURS Array(0 to 0) of String Array (0 to N) of Long defining colour values for noise iso-
Array(0) - Dummy pleth lines where
empty string ““ N is number of isopleth lines
Array(i) is colour value of isopleth line i as an RGB value
NOISEISPOTYPES Array(0 to 0) of String Array (0 to N) of Long defining line type values for noise
Array(0) - Dummy isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line type value of isopleth line i, 0 to 5.
NOISEISOWIDTHS Array(0 to 0) of String Array (0 to N) of Long defining line width values for noise
Array(0) - Dummy isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line width in pixels of isopleth line i
TEMPERATUREISO- Array(0 to 0) of String. Array (0 to N) of double defining radiation values for tem-
VALUES Array(0) - temperature perature isopleth lines where
unit, default K N is number of isopleth lines
Array(i) is temperature value of isopleth line i
TEMPERATUREISO- Array(0 to 0) of String Array (0 to N) of Long defining colour values for tempera-
COLOURS Array(0) - Dummy ture isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is colour value of isopleth line i as an RGB value
TEMPERATUREIS- Array(0 to 0) of String Array (0 to N) of Long defining line type values for tem-
POTYPES Array(0) - Dummy perature isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line type value of isopleth line i, 0 to 5.
TEMPERATURE- Array(0 to 0) of String Array (0 to N) of Long defining line width values for tem-
ISOWIDTHS Array(0) - Dummy perature isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line width in pixels of isopleth line i
15-50
OLE Interface 15-51
AXIS1VALUES Array(0 to 0) of string Array(0 to N-1) of Double defining points along first axis of
Array(0) - Dimension receptor grid where
unit, default m N = Number of points on first axis
Array(i) - distance of point i along first axis
AXIS2VALUES Array(0 to 0) of string Array(0 to N-1) of Double defining points along second
Array(0) - Dimension axis of receptor grid where
unit, default m N = Number of points on second axis
Array(i) - distance of point i along second axis
NOISEVALUES Array(0 to 0) of string Array(0 to N-1, 0 to M-1) of double defining noise results of
Array(0) - Noise unit, the receptor grid where
default Db N = number of points on first axis
M = number of points on second axis
Array(i,j) = noise value at point i, j in grid
RADIATIONISOVAL- Array(0 to 0) of String. Array (0 to N) of double defining radiation values for radia-
UES Array(0) - radiation tion isopleth lines where
unit, default W/m2 N is number of isopleth lines
Array(i) is radiation value of isopleth line i
15-51
15-52 IGrid Object
RADIATIONISOCOL- Array(0 to 0) of String Array (0 to N) of Long defining colour values for radiation
OURS Array(0) - Dummy isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is colour value of isopleth line i as an RGB value
RADIATIONISPOT- Array(0 to 0) of String Array (0 to N) of Long defining line type values for radia-
YPES Array(0) - Dummy tion isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line type value of isopleth line i, 0 to 5.
RADIATIONISOW- Array(0 to 0) of String Array (0 to N) of Long defining line width values for radia-
IDTHS Array(0) - Dummy tion isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line width in pixels of isopleth line i
NOISEISOVALUES Array(0 to 0) of String. Array (0 to N) of double defining radiation values for noise
Array(0) - noise unit, isopleth lines where
default Db N is number of isopleth lines
Array(i) is noise value of isopleth line i
NOISEISOCOLOURS Array(0 to 0) of String Array (0 to N) of Long defining colour values for noise iso-
Array(0) - Dummy pleth lines where
empty string ““ N is number of isopleth lines
Array(i) is colour value of isopleth line i as an RGB value
NOISEISPOTYPES Array(0 to 0) of String Array (0 to N) of Long defining line type values for noise
Array(0) - Dummy isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line type value of isopleth line i, 0 to 5.
NOISEISOWIDTHS Array(0 to 0) of String Array (0 to N) of Long defining line width values for noise
Array(0) - Dummy isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line width in pixels of isopleth line i
TEMPERATUREISO- Array(0 to 0) of String. Array (0 to N) of double defining radiation values for tem-
VALUES Array(0) - temperature perature isopleth lines where
unit, default K N is number of isopleth lines
Array(i) is temperature value of isopleth line i
TEMPERATUREISO- Array(0 to 0) of String Array (0 to N) of Long defining colour values for tempera-
COLOURS Array(0) - Dummy ture isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is colour value of isopleth line i as an RGB value
15-52
OLE Interface 15-53
TEMPERATUREIS- Array(0 to 0) of String Array (0 to N) of Long defining line type values for tem-
POTYPES Array(0) - Dummy perature isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line type value of isopleth line i, 0 to 5.
TEMPERATURE- Array(0 to 0) of String Array (0 to N) of Long defining line width values for tem-
ISOWIDTHS Array(0) - Dummy perature isopleth lines where
empty string ““ N is number of isopleth lines
Array(i) is line width in pixels of isopleth line i
15-53
15-54 IGrid Object
15-54
OLE Interface 15-55
15-55
15-56 IShields Object
Count() as Integer
Returns the number of shield objects in the IShields collection. Read
only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IShields collection.
Delete(What as Variant)
Deletes the shield specified by the What parameter. The What
parameter must be either an integer specifying the number of the
shield in the collection (first shield is number 1) or a string
containing the name of the shield.
15-56
OLE Interface 15-57
15-57
15-58 IShield Object
15-58
OLE Interface 15-59
SECTIONNAMES Array(0 to 0) of string. Array (0 to N-1) of string defining shield section names
Array(0) - Dummy where
empty string N is number shield sections
Array(i) is name of shield section
15-59
15-60 IShield Object
15-60
OLE Interface 15-61
Count() as Integer
Returns the number of environment objects in the IEnvironments
collection. Read only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IEnvironments collection.
Delete(What as Variant)
Deletes the environment specified by the What parameter. The What
parameter must be either an integer specifying the number of the
environment in the collection (first environment is number 1) or a
string containing the name of the environment.
15-61
15-62 IEnvironment Object
15-62
OLE Interface 15-63
15-63
15-64 IEnvironment Object
15-64
OLE Interface 15-65
WINDSPEEDARRAY Array(0 to 0) of string. Array (0 to N-1) of Double defining the wind speeds that
Array(0) - Speed unit the wind rose is to be calculated for where
default m/s N is number of windspeeds to be considered, max 10
Array(i) is windspeed for direction set i
WINDSPEEDDIREC- Array(0 to 0) of string. Array (0 to 15) of Double defining the wind speeds for each
TIONARRAY Array(0) - Speed unit wind rose direction where
default m/s Array(i) is wind speed for direction i. Note i=0 is north,
then each direction increment is 22.5 degrees in a clockwise
direction from the previous direction.
15-65
15-66 IEnvironment Object
WINDSPEEDARRAY Array(0 to 0) of string. Array (0 to N-1) of Double defining the wind speeds that
Array(0) - Speed unit the wind rose is to be calculated for where
default m/s N is number of windspeeds to be considered, max 10
Array(i) is windspeed for direction set i
WINDSPEEDDIREC- Array(0 to 0) of string. Array (0 to 15) of Double defining the wind speeds for each
TIONARRAY Array(0) - Speed unit wind rose direction where
default m/s Array(i) is wind speed for direction i. Note i=0 is north,
then each direction increment is 22.5 degrees in a clockwise
direction from the previous direction.
15-66
OLE Interface 15-67
Count() as Integer
Returns the number of fluid objects in the IFluids collection. Read
only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IFluids collection.
Delete(What as Variant)
Deletes the fluid specified by the What parameter. The What
parameter must be either an integer specifying the number of the
fluid in the collection (first fluid is number 1) or a string containing
the name of the fluid.
15-67
15-68 IFluid Object
15-68
OLE Interface 15-69
LEL % The lower explosive limit for the fluid. Only used
for Brzustowski calculation method.
LEL % The lower explosive limit for the fluid. Only used
for Brzustowski calculation method.
15-69
15-70 IFluid Object
COMPONENT- Array(0 to 0) of string. Array (0 to N-1) of String defining the list of components in
NAMES Array(0) Dummy the fluid where
empty string. N is number components in the fluid
Array(i) is the name of component i
15-70
OLE Interface 15-71
COMPONENTFRAC- Array(0 to 0) of string Array (0 to N-1) of Double defining the component frac-
TIONS Array(0) - Fraction tions in the fluid where
unit, default ““ N is the number of components in the fluid.
Array(i is fraction for component i
COMPONENTFRAC- Array(0 to 1) of string Array (0 to N-1) of Double defining the component frac-
TIONS Array(0) - Fraction tions in the fluid where
unit, default ““ N is the number of components in the fluid.
Array(i is fraction for component i
15-71
15-72 IComponents Object
Count() as Integer
Returns the number of component objects in the IComponents
collection. Read only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IComponents collection.
Delete(What as Variant)
Deletes the component specified by the What parameter. The What
parameter must be either an integer specifying the number of the
component in the collection (first component is number 1) or a string
containing the name of the component. Note library components
cannot be deleted from the IComponents collection.
15-72
OLE Interface 15-73
15-73
15-74 IComponent Object
15-74
OLE Interface 15-75
Count() as Integer
Returns the number of assist fluid objects in the IAssists collection.
Read only property.
NewEnum() as IUnknown
Returns a new enumerator for the collection. Not usually called
directly but supplied to support For Each style iteration over the
IAssists collection.
Delete(What as Variant)
Deletes the assist fluid specified by the What parameter. The What
parameter must be either an integer specifying the number of the
assist fluid in the collection (first assist fluid is number 1) or a string
containing the name of the assist fluid.
15-75
15-76 IAssist Object
15-76
OLE Interface 15-77
15-77
15-78 IAssist Object
15-78
Graphic Report Layout A-1
Page
A.1 Introduction to XML . . . . . . . . . . . . . . . . . . . 4
A.1.1 Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
A.1.2 Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
A.1.3 Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
A-1
A-2
A-2
Graphic Report Layout A-3
A-3
A-4 Introduction to XML
The figure below shows a fragment of the XML language taken from
one of the Flaresim layout files.
A.1.1 Tags
An element’s 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
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>.
A-4
Graphic Report Layout 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.
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”/>
A-5
A-6 Layout File Structure
This defines the version of the XML standard used to encode the file
and the unicode character set used. This is a standard element that
must appear as the first element in the file.
<FlaresimLayout>
This element is the top level data element that contains all other
elements that define the layout of the graphic report.
A-6
Graphic Report Layout A-7
Attributes
X Size of plot in X dimension in mm.
Y Size of plot in Y dimension in mm.
Data Value
None.
Attributes
X Required - X position in mm of the left edge of the
text
Y Required - Y position in mm of the centre line of the
text
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining text height as % of plot
page height
Style Optional - Text describing style of text -
Bold
Italic
BoldItalic
Data Value
The background text to be added to the plot.
A-7
A-8 Layout File Structure
Attributes
X Required - X position in mm of the left edge of the
unit text
Y Required - Y position in mm of the centre line of the
unit text
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining unit text height as % of
plot page height
Style Optional - Text describing style of unit text -
Bold
Italic
BoldItalic
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 follows-
time, 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
Graphic Report Layout A-9
Attributes
X Required - X position in mm of the left edge of the
data value
Y Required - Y position in mm of the centre line of the
value
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining data value height as % of
plot page height
Style Optional - Text describing style of data value -
Bold
Italic
BoldItalic
Data Value
A <Var> data element defining the data item to be output as follows.
Attributes
Stack Optional - index of stack which variable is associated
with.
Tip Optional - index of tip which variable is associated
with. Note this is the index of the tip on the specified
stack i.e. a Tip index value of 1 denotes the first tip
on the specified stack regardless of whether the tip is
the first listed in the model.
A-9
A-10 Layout File Structure
Data Value
A text string identifying the data item to be output. The list of data
identifiers recognised is as follows.
A-10
Graphic Report Layout A-11
MW Required Required
A-11
A-12 Layout File Structure
A-12
Graphic Report Layout A-13
A-13
A-14 Layout File Structure
Attributes
X1 Required - X position in mm of the top left corner of
the graphic item.
Y1 Required - Y position in mm of the top left corner of
the graphic item.
X2 Required - X position in mm of the bottom right
corner of the graphic item.
Y2 Required - Y position in mm of the bottom right
corner of the graphic item.
Data Value
A text string naming the graphic file to be included.
Attributes
X1 Required - X position in mm of the top left corner of
the area for output of the data item.
Y1 Required - Y position in mm of the top left corner of
the area for output of the data item.
X2 Required - X position in mm of the bottom right
corner of the area for output of the data item.
Y2 Required - Y position in mm of the bottom right
corner of the area for output of the data item.
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining data item text height as %
of plot height
A-14
Graphic Report Layout A-15
Data Value
A text string defining the data item to be output. Recognised values
are.
Title
DataFile
Description
LastModified
Author
Revision
CheckedBy
FSWVersion
Attributes
X1 Required - X position in mm of the first end of the
line.
Y1 Required - Y position in mm of the first end of the
line.
X2 Required - X position in mm of the second end of the
line.
Y2 Required - Y position in mm of the second end of the
line.
LineWidth Required - Line width in pixels.
Data Value
None
A-15
A-16 Layout File Structure
Attributes
X1 Required - X position in mm of the top left corner of
the graph area.
Y1 Required - Y position in mm of the top left corner of
the graph area.
X2 Required - X position in mm of the bottom right
corner of the graph area.
Y2 Required - Y position in mm of the bottom right
corner of the graph area.
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.
Attributes
Display Required - defines whether grid is drawn. Allowed
values are Yes or No.
Lines Required - defines number of grid lines within graph
on each axid. Integer
BackColour Required - defines colour of graph background.
Value can be Transparent or one of the colours from
Table A.1 below.
A-16
Graphic Report Layout A-17
Attributes
Display Required - defines whether title is included. Allowed
values are Yes or No.
Space Required - Vertical spacing allowed for title as a
percentage of the Y range of the graph.
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
A-17
A-18 Layout File Structure
Attributes
Display Required - defines whether description is included.
Allowed values are Yes or No.
Space Required - Vertical spacing allowed for description
as a percentage of the Y range of the graph.
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining description text height as
% of graph height.
Style Optional - Text describing style of description text -
Bold
Italic
BoldItalic
Attributes
Display Required - defines whether X axis label is included.
Allowed values are Yes or No.
A-18
Graphic Report Layout A-19
Attributes
Display Required - defines whether Y axis label is included.
Allowed values are Yes or No.
Space Required - Horizontal spacing allowed for Y axis
label as a percentage of the X range of the graph.
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining Y axis label height as % of
graph height.
Style Optional - Text describing style of Y axis label text -
Bold
Italic
BoldItalic
A-19
A-20 Layout File Structure
Attributes
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining scale label height as % of
graph height.
Attributes
Display Required - defines whether the flare will be drawn.
Allowed values are Yes or No.
FlameThick Required - defines thickness of line used to draw
flame in pixels.
FlameColour Required - defines colour of line used to draw flame.
Allowed values are given in Table A.1.
StackThick Required - defines thickness of line used to draw
stack in pixels.
StackColour Required - defines colour of line used to draw stack.
Allowed values are given in Table A.1.
TipThick Required - defines thickness of line used to draw tip
in pixels.
TipColour Required - defines colour of line used to draw tip.
Allowed values are given in Table A.1.
A-20
Graphic Report Layout A-21
Attributes
X1 Required - X position in mm of the top left corner of
the legend data area.
Y1 Required - Y position in mm of the top left corner of
the legend data area.
X2 Required - X position in mm of the bottom right
corner of the legend data area.
Y2 Required - Y position in mm of the bottom right
corner of the legend data area.
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.
Attributes
NumCols Required - Integer defining number of colums to be
used for drawing the legend.
Font Required - Integer denoting font to be used for
legend label -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining legend label height as %
of legend data area height.
A-21
A-22 Layout File Structure
Attributes
Display Required - defines whether description is included.
Allowed values are Yes or No.
Font Required - Integer denoting font to be used -
0 = Arial
1 = Courier
2 = Times Roman
Size Required - Value defining description text height as
% of legend data area height.
Style Optional - Text describing style of description text -
Bold
Italic
BoldItalic
Attributes
UseLayout Required - Specifies whether the contour data from
the layout file is to be used. Allowed values Yes or
No. If set to Yes the contour data will be taken from
the layout file. If not, the contour data will be taken
from the current isopleth definition for the receptor
grid.
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-22
Graphic Report Layout A-23
Attributes
IsoValue Required - Specifies the radiation value of the
isopleth contour in internal program units of W/m2.
Colour Required - Specifies the colour used to draw the
contour. Allowed values are given in Table A.1.
LineWidth Required - Integer specifying the width of the line
used to draw the contour in pixels.
Style Required - Specifies the style of the line used to draw
the contour. Allow values are.
Solid
Dashed
Dotted
DashDot
DashDotDot
Attributes
IsoValue Required - Specifies the noise value of the isopleth
contour in internal program units of dB.
Colour Required - Specifies the colour used to draw the
contour. Allowed values are given in Table A.1.
LineWidth Required - Integer specifying the width of the line
used to draw the contour in pixels.
Style Required - Specifies the style of the line used to draw
the contour. Allow values are.
Solid
Dashed
Dotted
A-23
A-24 Layout File Structure
DashDot
DashDotDot
Attributes
IsoValue Required - Specifies the temperature value of the
isopleth contour in internal program units of K.
Colour Required - Specifies the colour used to draw the
contour. Allowed values are given in Table A.1.
LineWidth Required - Integer specifying the width of the line
used to draw the contour in pixels.
Style Required - Specifies the style of the line used to draw
the contour. Allow values are.
Solid
Dashed
Dotted
DashDot
DashDotDot
A-24