BEST

Documentation

Version. 11.0
May 2008
1-Table of contents

1 Table of contents
1 Table of contents .................................................................................................................................................................. 1
2 Presentation ....................................................................................................................................................................... 10
3 Description of BEST .......................................................................................................................................................... 11
4 Data .................................................................................................................................................................................... 12
4.1 Introduction .................................................................................................................................................................. 12
4.2 Definitions ................................................................................................................................................................ 13
4.2.1 Introduction .......................................................................................................................................................... 13
4.2.2 Block .................................................................................................................................................................... 13
4.2.3 Cut ........................................................................................................................................................................ 13
4.2.4 Fluid ..................................................................................................................................................................... 14
4.2.5 Group .................................................................................................................................................................... 14
4.2.6 DDE ...................................................................................................................................................................... 15
4.3 External data ................................................................................................................................................................ 16
4.3.1 Introduction .......................................................................................................................................................... 16
4.3.2 Fluids file .............................................................................................................................................................. 16
4.3.3 Block calculation parameters................................................................................................................................ 17
4.3.4 External definition of Blocks ................................................................................................................................ 17
4.3.5 Multi Case data file .............................................................................................................................................. 17
4.3.6 Versus Time calculation sheet .............................................................................................................................. 18
4.3.6.1 Line 1: ......................................................................................................................................................... 18
4.3.6.2 Following lines: .......................................................................................................................................... 18
4.4 Internal Data ................................................................................................................................................................ 19
4.4.1 Introduction .......................................................................................................................................................... 19
4.4.2 Formulas ............................................................................................................................................................... 19
4.4.2.1 Operators..................................................................................................................................................... 19
4.4.2.2 Variables ..................................................................................................................................................... 20
4.4.2.3 Expressions ................................................................................................................................................. 20
4.4.3 Topology .............................................................................................................................................................. 20
4.4.4 Calculation results ................................................................................................................................................ 21
4.4.5 Global Parameters ................................................................................................................................................ 21
4.4.6 Equations of State ................................................................................................................................................. 21
4.4.7 Manual data modifications ................................................................................................................................... 21
5 Results ................................................................................................................................................................................ 22
5.1 Introduction .................................................................................................................................................................. 22
5.2 External files ................................................................................................................................................................. 22
5.3 Syntax ............................................................................................................................................................................ 22
5.4 Utilising DDERequest .................................................................................................................................................. 23
6 Parameters ......................................................................................................................................................................... 24
6.1 Introduction .................................................................................................................................................................. 24
6.2 Look of the software .................................................................................................................................................... 25
6.2.1 Input parameters ................................................................................................................................................... 25
6.2.2 Results output formats .......................................................................................................................................... 25
6.3 Software behaviour ...................................................................................................................................................... 27
6.3.1 Cuts....................................................................................................................................................................... 27
6.3.2 Properties .............................................................................................................................................................. 27
6.3.3 Generic ................................................................................................................................................................. 27
6.3.4 Parametres ............................................................................................................................................................ 27

Best - Version. 11.0 Page:1/173

1-Table of contents

6.3.5 Operations ............................................................................................................................................................ 27

6.3.6 Phases ................................................................................................................................................................... 27
6.4 PLUG.XLS file ............................................................................................................................................................. 28
6.4.1 Introduction .......................................................................................................................................................... 28
6.4.2 Results .................................................................................................................................................................. 29
6.4.2.1 Line 1 .......................................................................................................................................................... 29
6.4.2.2 Following lines ........................................................................................................................................... 30
6.4.3 ResultWater .......................................................................................................................................................... 30
6.4.4 ResultSplit ............................................................................................................................................................ 31
6.4.5 ResultMigration .................................................................................................................................................... 31
6.4.6 ResultPiege ........................................................................................................................................................... 31
6.4.7 ResultGenese ........................................................................................................................................................ 32
6.4.8 ResultKiCst .......................................................................................................................................................... 32
6.4.9 ResultCons............................................................................................................................................................ 32
6.4.10 ResultStream .................................................................................................................................................... 32
6.4.11 ResultMMP ...................................................................................................................................................... 33
6.4.12 ResultEnv......................................................................................................................................................... 33
6.4.13 ResultWax ....................................................................................................................................................... 33
6.4.14 InputPT ............................................................................................................................................................ 33
6.4.14.1 Line 1 .......................................................................................................................................................... 33
6.4.14.2 Following lines ........................................................................................................................................... 33
6.4.15 InputPTH ......................................................................................................................................................... 34
6.4.16 InputPTHP ....................................................................................................................................................... 34
6.4.17 InputPTHA ...................................................................................................................................................... 34
6.4.18 InputPTSel ....................................................................................................................................................... 34
6.4.19 InputKiCst ....................................................................................................................................................... 34
6.4.20 InputSplit ......................................................................................................................................................... 35
6.4.21 InputPTV ......................................................................................................................................................... 35
6.4.22 InputPTTETA .................................................................................................................................................. 35
6.4.23 InputCons......................................................................................................................................................... 35
6.4.24 InputMigration ................................................................................................................................................. 35
6.4.25 InputPiege ........................................................................................................................................................ 35
6.4.26 InputGenese ..................................................................................................................................................... 35
6.4.27 InputPrePvt ...................................................................................................................................................... 36
6.4.28 InputMMP ....................................................................................................................................................... 36
6.4.29 InputEnv .......................................................................................................................................................... 36
6.4.30 InputWax ......................................................................................................................................................... 36
6.4.31 Proprietes ......................................................................................................................................................... 36
6.4.31.1 Line 1 .......................................................................................................................................................... 36
6.4.31.2 Following lines ........................................................................................................................................... 36
6.4.31.3 Internal properties ....................................................................................................................................... 37
6.4.32 Parametres ....................................................................................................................................................... 37
6.4.32.1 Line 1 .......................................................................................................................................................... 37
6.4.32.2 Following lines ........................................................................................................................................... 37
6.4.33 Operations ........................................................................................................................................................ 38
6.4.33.1 Line 1 .......................................................................................................................................................... 38
6.4.33.2 Following lines ........................................................................................................................................... 38
6.4.34 Coupes ............................................................................................................................................................. 38
6.4.35 Phases .............................................................................................................................................................. 39
6.4.35.1 Line 1 .......................................................................................................................................................... 39
6.4.35.2 Following lines ........................................................................................................................................... 39
6.4.36 Generic ............................................................................................................................................................ 40
6.4.36.1 Line 1 .......................................................................................................................................................... 40
6.4.36.2 Following lines ........................................................................................................................................... 40
6.4.36.3 Internal properties: ...................................................................................................................................... 41
6.4.37 Calculation functions ....................................................................................................................................... 41
6.4.37.1 Introduction ................................................................................................................................................. 41
6.4.37.2 Default functions ......................................................................................................................................... 41
6.4.37.3 User functions ............................................................................................................................................. 42
7 Operations .......................................................................................................................................................................... 43
7.1 Introduction .................................................................................................................................................................. 43

Best - Version. 11.0 Page:2/173

1-Table of contents

7.2 Flash .............................................................................................................................................................................. 44

7.2.1 Introduction .......................................................................................................................................................... 44
7.2.2 Scheme ................................................................................................................................................................. 44
7.2.3 Data ...................................................................................................................................................................... 44
7.2.4 Results .................................................................................................................................................................. 44
7.3 Constant Ki Flash ........................................................................................................................................................ 46
7.4 Bubble pressure ............................................................................................................................................................ 47
7.4.1 Introduction .......................................................................................................................................................... 47
7.4.2 Scheme ................................................................................................................................................................. 47
7.4.3 Data ...................................................................................................................................................................... 47
7.4.4 Results .................................................................................................................................................................. 48
7.5 Retrograde and Normal dewpoint pressures ............................................................................................................. 49
7.5.1 Introduction .......................................................................................................................................................... 49
7.5.2 Scheme ................................................................................................................................................................. 49
7.5.3 Data ...................................................................................................................................................................... 50
7.5.4 Results .................................................................................................................................................................. 50
7.6 Ger ................................................................................................................................................................................. 51
7.6.1 Introduction .......................................................................................................................................................... 51
7.6.2 Scheme ................................................................................................................................................................. 51
7.6.3 Data ...................................................................................................................................................................... 51
7.6.4 Results .................................................................................................................................................................. 51
7.7 GerP .............................................................................................................................................................................. 52
7.8 GerDiff .......................................................................................................................................................................... 53
7.9 Three-phase water-oil-gas flash .................................................................................................................................. 54
7.9.1 Introduction .......................................................................................................................................................... 54
7.9.2 Scheme ................................................................................................................................................................. 54
7.9.3 Data ...................................................................................................................................................................... 54
7.9.3.1 Remark on required data: ............................................................................................................................ 54
7.9.4 Results .................................................................................................................................................................. 55
7.10 Three-phase Wax-oil-gas flash ............................................................................................................................... 56
7.10.1 Introduction ..................................................................................................................................................... 56
7.10.2 Scheme ............................................................................................................................................................ 56
7.10.3 Data.................................................................................................................................................................. 56
7.10.3.1 Remark on required data: ............................................................................................................................ 56
7.10.4 Results ............................................................................................................................................................. 57
7.11 Wax Tcc calculation ................................................................................................................................................ 58
7.11.1 Introduction ..................................................................................................................................................... 58
7.11.2 Scheme ............................................................................................................................................................ 58
7.11.3 Data.................................................................................................................................................................. 58
7.11.3.1 Remark on required data: ............................................................................................................................ 58
7.11.4 Results ............................................................................................................................................................. 59
7.12 Split ........................................................................................................................................................................... 60
7.12.1 Introduction ..................................................................................................................................................... 60
7.12.2 Scheme ............................................................................................................................................................ 60
7.12.3 Data.................................................................................................................................................................. 60
7.12.4 Results ............................................................................................................................................................. 60
7.13 Stream Generator.................................................................................................................................................... 62
7.13.1 Introduction ..................................................................................................................................................... 62
7.13.2 Data.................................................................................................................................................................. 62
7.13.3 Results ............................................................................................................................................................. 62
7.14 CVD .......................................................................................................................................................................... 63
7.14.1 Introduction ..................................................................................................................................................... 63
7.14.2 Scheme ............................................................................................................................................................ 63
7.14.3 Data.................................................................................................................................................................. 64
7.14.4 Results ............................................................................................................................................................. 64
7.15 Isochor ...................................................................................................................................................................... 65
Best - Version. 11.0 Page:3/173
1-Table of contents

7.15.1 Introduction ..................................................................................................................................................... 65

7.15.2 Scheme ............................................................................................................................................................ 65
7.15.3 Data.................................................................................................................................................................. 65
7.15.4 Results ............................................................................................................................................................. 66
7.16 Set Flash ................................................................................................................................................................... 67
7.16.1 Introduction ..................................................................................................................................................... 67
7.16.2 Scheme ............................................................................................................................................................ 67
7.16.3 Data.................................................................................................................................................................. 67
7.16.4 Results ............................................................................................................................................................. 67
7.17 Genese ...................................................................................................................................................................... 69
7.17.1 Introduction ..................................................................................................................................................... 69
7.17.2 Data.................................................................................................................................................................. 69
7.17.3 Results ............................................................................................................................................................. 70
7.18 Migration ................................................................................................................................................................. 71
7.18.1 Introduction ..................................................................................................................................................... 71
7.18.2 Data.................................................................................................................................................................. 71
7.18.3 Results ............................................................................................................................................................. 71
7.19 Piege.......................................................................................................................................................................... 72
7.19.1 Introduction ..................................................................................................................................................... 72
7.19.2 Data.................................................................................................................................................................. 74
7.19.3 Results ............................................................................................................................................................. 74
7.20 Hydrates formation Temperature ......................................................................................................................... 75
7.20.1 Introduction ..................................................................................................................................................... 75
7.20.2 Data.................................................................................................................................................................. 75
7.20.3 Results ............................................................................................................................................................. 75
7.21 Hydrates formation Pressure ................................................................................................................................. 76
7.21.1 Introduction ..................................................................................................................................................... 76
7.21.2 Data.................................................................................................................................................................. 76
7.21.3 Results ............................................................................................................................................................. 76
7.22 Variable .................................................................................................................................................................... 77
7.22.1 Introduction ..................................................................................................................................................... 77
7.22.2 Data.................................................................................................................................................................. 77
7.22.3 Results ............................................................................................................................................................. 77
7.23 Controller ................................................................................................................................................................. 78
7.23.1 Introduction ..................................................................................................................................................... 78
7.23.2 Data.................................................................................................................................................................. 78
7.23.3 Results ............................................................................................................................................................. 78
7.24 Phase envelope points.............................................................................................................................................. 79
7.24.1 Introduction ..................................................................................................................................................... 79
7.24.2 Data.................................................................................................................................................................. 79
7.24.3 Results ............................................................................................................................................................. 79
7.25 MMP points ............................................................................................................................................................. 80
7.25.1 Introduction ..................................................................................................................................................... 80
7.25.2 Data.................................................................................................................................................................. 80
7.25.3 Results ............................................................................................................................................................. 80
7.26 Black Oil................................................................................................................................................................... 81
7.26.1 Introduction to BO ........................................................................................................................................... 81
7.26.1.1 Liquid BO ................................................................................................................................................... 81
7.26.1.2 Vapor BO .................................................................................................................................................... 81
7.26.2 Data.................................................................................................................................................................. 83
7.26.2.1 Data input by the user ................................................................................................................................. 83
7.26.2.2 Automatic Liquid BO ................................................................................................................................. 83
7.26.2.3 Automatic Vapor BO .................................................................................................................................. 84
7.26.3 Results ............................................................................................................................................................. 84
7.26.3.1 Liquid BO ................................................................................................................................................... 84
7.26.3.2 Vapor BO .................................................................................................................................................... 85

Best - Version. 11.0 Page:4/173

1-Table of contents

7.27 Multi depth .............................................................................................................................................................. 86

7.27.1 Introduction ..................................................................................................................................................... 86
7.27.2 Data.................................................................................................................................................................. 86
7.27.3 Results ............................................................................................................................................................. 86
7.28 Phase envelope ......................................................................................................................................................... 87
7.28.1 Introduction ..................................................................................................................................................... 87
7.28.2 Data.................................................................................................................................................................. 87
7.28.3 Results ............................................................................................................................................................. 87
7.29 Multi Case ................................................................................................................................................................ 88
7.29.1 Introduction ..................................................................................................................................................... 88
7.29.2 Data.................................................................................................................................................................. 88
7.29.3 Results ............................................................................................................................................................. 88
7.30 MMP......................................................................................................................................................................... 89
7.30.1 Introduction ..................................................................................................................................................... 89
7.30.2 Data.................................................................................................................................................................. 90
7.30.3 Results ............................................................................................................................................................. 90
7.31 Versus Time ............................................................................................................................................................. 92
7.31.1 Introduction ..................................................................................................................................................... 92
7.31.2 Data.................................................................................................................................................................. 92
7.31.3 Results ............................................................................................................................................................. 92
7.32 Optimizer ................................................................................................................................................................. 93
7.32.1 Introduction ..................................................................................................................................................... 93
7.32.2 Data.................................................................................................................................................................. 93
7.32.3 Results ............................................................................................................................................................. 93
8 Utilisation ........................................................................................................................................................................... 94
8.1 Introduction .................................................................................................................................................................. 94
8.2 Creating a new session ................................................................................................................................................. 95
8.2.1 Introduction .......................................................................................................................................................... 95
8.2.2 Methodology ........................................................................................................................................................ 95
8.3 Creating a block ........................................................................................................................................................... 96
8.3.1 Introduction .......................................................................................................................................................... 96
8.3.2 Thermodynamic operations .................................................................................................................................. 96
8.3.3 Controllers ............................................................................................................................................................ 96
8.4 Defining block properties ............................................................................................................................................ 97
8.4.1 Introduction .......................................................................................................................................................... 97
8.4.2 Opening a window................................................................................................................................................ 97
8.4.3 Defining properties ............................................................................................................................................... 97
8.5 Defining flow sheet topology ....................................................................................................................................... 98
8.5.1 Presentation .......................................................................................................................................................... 98
8.6 Initialization of a flow sheet ........................................................................................................................................ 99
8.6.1 Presentation .......................................................................................................................................................... 99
8.7 Calculating a flow sheet ............................................................................................................................................. 100
8.7.1 Presentation ........................................................................................................................................................ 100
8.8 Creating a group ........................................................................................................................................................ 101
8.8.1 Introduction ........................................................................................................................................................ 101
8.8.2 Selecting ............................................................................................................................................................. 101
8.8.3 Creation .............................................................................................................................................................. 102
8.9 Retrieving data in Excel ............................................................................................................................................ 104
8.9.1 Introduction ........................................................................................................................................................ 104
8.9.2 Implementation ................................................................................................................................................... 104
8.10 Defining calculation parameters in Excel ............................................................................................................ 105
8.10.1 Introduction ................................................................................................................................................... 105
8.10.2 Implementation .............................................................................................................................................. 105
8.11 Automating calculations using Excel ................................................................................................................... 106
Best - Version. 11.0 Page:5/173
1-Table of contents

8.11.1 Introduction ................................................................................................................................................... 106

8.11.2 Implementation .............................................................................................................................................. 106
8.11.2.1 Standard DDE Functions .......................................................................................................................... 106
8.11.2.2 Specific functions...................................................................................................................................... 107
9 Windows ........................................................................................................................................................................... 111
9.1 Introduction ................................................................................................................................................................ 111
9.2 Main window .............................................................................................................................................................. 112
9.2.1 Introduction ........................................................................................................................................................ 112
9.2.2 Title bar .............................................................................................................................................................. 112
9.2.3 Menu bar ............................................................................................................................................................ 112
9.2.4 Toolbar ............................................................................................................................................................... 113
9.2.4.1 New ........................................................................................................................................................... 113
9.2.4.2 Open .......................................................................................................................................................... 113
9.2.4.3 Save........................................................................................................................................................... 113
9.2.4.4 Select......................................................................................................................................................... 113
9.2.4.5 Rectangle .................................................................................................................................................. 114
9.2.4.6 Diamond.................................................................................................................................................... 114
9.2.4.7 Cut............................................................................................................................................................. 114
9.2.4.8 Copy .......................................................................................................................................................... 114
9.2.4.9 Paste .......................................................................................................................................................... 114
9.2.4.10 Print........................................................................................................................................................... 114
9.2.4.11 Initialize .................................................................................................................................................... 114
9.2.4.12 Calculate ................................................................................................................................................... 115
9.2.4.13 Help........................................................................................................................................................... 115
9.2.5 Display area ........................................................................................................................................................ 115
9.2.5.1 Active window .......................................................................................................................................... 115
9.2.5.2 Block colors .............................................................................................................................................. 115
9.2.6 Status bar ............................................................................................................................................................ 116
9.3 Properties listing window .......................................................................................................................................... 117
9.3.1 Introduction ........................................................................................................................................................ 117
9.3.2 Utilisation ........................................................................................................................................................... 117
9.4 Block properties ......................................................................................................................................................... 118
9.4.1 Introduction ........................................................................................................................................................ 118
9.4.2 OK and Cancel buttons .................................................................................................................................. 118
9.4.3 identification ....................................................................................................................................................... 119
9.4.4 parameters .......................................................................................................................................................... 119
9.4.4.1 Flash .......................................................................................................................................................... 119
9.4.4.2 Bubble pressure ......................................................................................................................................... 120
9.4.4.3 Dewpoint pressure .................................................................................................................................... 120
9.4.4.4 Ger ............................................................................................................................................................ 120
9.4.4.5 Three-phase water-oil-gas flash ................................................................................................................ 120
9.4.4.6 Split ........................................................................................................................................................... 120
9.4.4.7 Set flash..................................................................................................................................................... 120
9.4.4.8 CVD (Constant Volume Depletion) .......................................................................................................... 120
9.4.4.9 Isochor ...................................................................................................................................................... 121
9.4.4.10 Variable..................................................................................................................................................... 121
9.4.5 Feeds................................................................................................................................................................... 121
9.4.6 External streams ................................................................................................................................................. 121
9.4.7 results ................................................................................................................................................................. 122
9.4.8 Specific operations ............................................................................................................................................. 122
9.4.8.1 Copy .......................................................................................................................................................... 123
9.4.8.2 Multi depth ................................................................................................................................................ 123
9.4.9 Graphic characteristics ....................................................................................................................................... 123
9.5 Multi Depth ................................................................................................................................................................ 124
9.5.1 Description ......................................................................................................................................................... 124
9.5.2 Definition of calculation parameters .................................................................................................................. 124
9.5.3 Calculate button .................................................................................................................................................. 125
9.5.4 Ok and Cancel buttons ................................................................................................................................. 125
9.5.5 Results grid ......................................................................................................................................................... 125

Best - Version. 11.0 Page:6/173

1-Table of contents

9.5.6 Copy button ........................................................................................................................................................ 125

9.5.7 Curve plotting area ............................................................................................................................................. 125
9.6 Phase Envelope ........................................................................................................................................................... 126
9.6.1 Description ......................................................................................................................................................... 126
9.7 Group .......................................................................................................................................................................... 127
9.7.1 Introduction ........................................................................................................................................................ 127
9.7.2 OK and Cancel Buttons ...................................................................................................................................... 127
9.7.3 List of component blocks ................................................................................................................................... 127
9.7.4 Ungroup button................................................................................................................................................... 127
9.7.5 Display area ........................................................................................................................................................ 128
9.8 Controller ................................................................................................................................................................... 129
9.8.1 Introduction ........................................................................................................................................................ 129
9.8.2 OK and Cancel Buttons ...................................................................................................................................... 129
9.8.3 Parameters and objective function ...................................................................................................................... 129
9.8.4 Identification ...................................................................................................................................................... 130
9.8.5 Conditions .......................................................................................................................................................... 130
9.8.6 Results for parameters and functions .................................................................................................................. 130
9.9 Components properties.............................................................................................................................................. 131
9.9.1 Introduction ........................................................................................................................................................ 131
9.9.2 OK and Cancel Buttons ...................................................................................................................................... 132
9.9.3 Editing unary properties ..................................................................................................................................... 132
9.9.4 Displaying unary properties................................................................................................................................ 132
9.9.5 editing binary properties ..................................................................................................................................... 132
9.9.6 displaying binary properties ............................................................................................................................... 132
9.10 Copy-Backup Utility ............................................................................................................................................. 133
9.10.1 Introduction ................................................................................................................................................... 133
9.10.2 Buttons ........................................................................................................................................................... 133
9.10.3 editing unary properties ................................................................................................................................. 134
9.10.4 displaying unary properties ............................................................................................................................ 134
9.10.5 editing binary properties ................................................................................................................................ 134
9.10.6 displaying binary properties........................................................................................................................... 134
9.10.7 Selecting a fluid ............................................................................................................................................. 134
9.11 Global Parameters Window ................................................................................................................................. 135
9.11.1 Introduction ................................................................................................................................................... 135
9.11.2 Buttons ........................................................................................................................................................... 135
9.11.3 Editing parameters ......................................................................................................................................... 135
9.11.4 Displaying parameters ................................................................................................................................... 135
9.11.5 Equation of state ............................................................................................................................................ 136
9.12 Optimization parameters ...................................................................................................................................... 137
9.12.1 Introduction ................................................................................................................................................... 137
9.12.2 Ok and Cancel Buttons .................................................................................................................................. 138
9.12.3 Global Parameters .......................................................................................................................................... 138
9.12.4 block parameters ............................................................................................................................................ 138
9.12.5 feed proportions ............................................................................................................................................. 138
9.12.6 unary properties ............................................................................................................................................. 138
9.12.7 binary properties ............................................................................................................................................ 139
9.12.8 selection buttons ............................................................................................................................................ 139
9.12.9 selections performed ...................................................................................................................................... 139
9.13 Specifications ......................................................................................................................................................... 140
9.13.1 Introduction ................................................................................................................................................... 140
9.13.2 Ok and Cancel Buttons .................................................................................................................................. 140
9.13.3 Definition of specifications ............................................................................................................................ 141
9.13.3.1 Definition of the Specification .................................................................................................................. 141
9.13.3.2 Properties .................................................................................................................................................. 141
9.13.4 Specifications editing buttons ........................................................................................................................ 141
9.14 Optimization Echo ................................................................................................................................................ 142
9.15 Black Oil................................................................................................................................................................. 143

Best - Version. 11.0 Page:7/173

1-Table of contents

9.15.1 Introduction ................................................................................................................................................... 143

9.15.2 OK and Cancel Buttons ................................................................................................................................. 143
9.15.3 Black Oil type ................................................................................................................................................ 144
9.15.4 Composite definition ..................................................................................................................................... 144
9.15.5 pressures ........................................................................................................................................................ 145
9.15.6 Results ........................................................................................................................................................... 146
9.15.7 buttons ........................................................................................................................................................... 146
9.15.8 Export buttons................................................................................................................................................ 146
9.16 Multi Case .............................................................................................................................................................. 148
9.16.1 Description..................................................................................................................................................... 148
9.17 MMP....................................................................................................................................................................... 149
9.17.1 Introduction ................................................................................................................................................... 149
9.17.2 OK and Cancel Buttons ................................................................................................................................. 149
9.17.3 Oils and gases used ........................................................................................................................................ 149
9.17.4 Calculation parameters .................................................................................................................................. 150
9.17.5 calculation type .............................................................................................................................................. 150
9.17.6 Calculation ..................................................................................................................................................... 150
9.18 Versus Time ........................................................................................................................................................... 151
9.18.1 Introduction ................................................................................................................................................... 151
9.18.2 OK and Cancel Buttons ................................................................................................................................. 151
9.18.3 Time groups ................................................................................................................................................... 152
9.18.4 Time step ....................................................................................................................................................... 152
9.18.5 Excel worksheet ............................................................................................................................................. 152
9.18.6 calculation ...................................................................................................................................................... 152
9.19 Help ........................................................................................................................................................................ 153
10 Menus ............................................................................................................................................................................... 154
10.1 Introduction ........................................................................................................................................................... 154
10.2 File Menu ............................................................................................................................................................... 155
10.2.1 Introduction ................................................................................................................................................... 155
10.2.2 New................................................................................................................................................................ 155
10.2.3 Open .............................................................................................................................................................. 155
10.2.4 Close .............................................................................................................................................................. 155
10.2.5 Save ............................................................................................................................................................... 155
10.2.6 Save As .......................................................................................................................................................... 156
10.2.7 Export to Text ................................................................................................................................................ 156
10.2.8 Print ............................................................................................................................................................... 156
10.2.9 Print Preview ................................................................................................................................................. 156
10.2.10 Print Setup ..................................................................................................................................................... 156
10.2.11 Recently used file list ..................................................................................................................................... 156
10.2.12 Exit ................................................................................................................................................................ 157
10.3 Edit Menu .............................................................................................................................................................. 158
10.3.1 Introduction ................................................................................................................................................... 158
10.3.2 Undo .............................................................................................................................................................. 158
10.3.3 Redo ............................................................................................................................................................... 158
10.3.4 Cut ................................................................................................................................................................. 158
10.3.5 Copy .............................................................................................................................................................. 158
10.3.6 Paste ............................................................................................................................................................... 158
10.3.7 Delete ............................................................................................................................................................. 158
10.3.8 Select All ....................................................................................................................................................... 159
10.3.9 Properties ....................................................................................................................................................... 159
10.3.10 Insert New Object .......................................................................................................................................... 159
10.3.11 Links .............................................................................................................................................................. 159
10.3.12 Object ............................................................................................................................................................ 159
10.4 View Menu ............................................................................................................................................................. 160
10.4.1 Introduction ................................................................................................................................................... 160
10.4.2 Grid lines ....................................................................................................................................................... 160
10.4.3 Paper Color .................................................................................................................................................... 160
10.4.4 Show Objects ................................................................................................................................................. 160
Best - Version. 11.0 Page:8/173
1-Table of contents

10.4.5 ToolBar .......................................................................................................................................................... 160

10.4.6 Status Bar ....................................................................................................................................................... 160
10.5 Draw Menu ............................................................................................................................................................ 161
10.5.1 Introduction ................................................................................................................................................... 161
10.5.2 Select ............................................................................................................................................................. 161
10.5.3 Line ................................................................................................................................................................ 161
10.5.4 Rectangle ....................................................................................................................................................... 161
10.5.5 Diamond ........................................................................................................................................................ 161
10.5.6 Polygon .......................................................................................................................................................... 162
10.6 Object Menu .......................................................................................................................................................... 163
10.6.1 Introduction ................................................................................................................................................... 163
10.6.2 Line Color ...................................................................................................................................................... 163
10.6.3 Fill Color........................................................................................................................................................ 163
10.6.4 Move to Front ................................................................................................................................................ 163
10.6.5 Move to Back................................................................................................................................................. 163
10.6.6 Move Forward ............................................................................................................................................... 163
10.6.7 Move Back ..................................................................................................................................................... 163
10.6.8 Group ............................................................................................................................................................. 163
10.7 Window Menu ....................................................................................................................................................... 165
10.7.1 Introduction ................................................................................................................................................... 165
10.7.2 New Window ................................................................................................................................................. 165
10.7.3 Cascade .......................................................................................................................................................... 165
10.7.4 Tile................................................................................................................................................................. 165
10.7.5 Arrange icons ................................................................................................................................................. 165
10.7.6 Opened windows ........................................................................................................................................... 165
10.8 Data menu .............................................................................................................................................................. 166
10.8.1 Introduction ................................................................................................................................................... 166
10.8.2 Components ................................................................................................................................................... 166
10.8.3 Save ............................................................................................................................................................... 166
10.8.4 Parameters ..................................................................................................................................................... 166
10.9 Optimization menu ................................................................................................................................................ 167
10.9.1 Introduction ................................................................................................................................................... 167
10.9.2 Optimzation is active ..................................................................................................................................... 167
10.9.3 Parameters ..................................................................................................................................................... 167
10.9.4 Specifications................................................................................................................................................. 167
10.10 Calculations menu ................................................................................................................................................. 168
10.10.1 Introduction ................................................................................................................................................... 168
10.10.2 Calculate ........................................................................................................................................................ 168
10.10.3 Black Oil ........................................................................................................................................................ 168
10.10.4 Multi Case...................................................................................................................................................... 168
10.10.5 MMP .............................................................................................................................................................. 168
10.10.6 Versus Time ................................................................................................................................................... 169
10.10.7 Initialize ......................................................................................................................................................... 169
10.11 Help Menu ............................................................................................................................................................. 170
10.11.1 Introduction ................................................................................................................................................... 170
11 Index ................................................................................................................................................................................. 171

Best - Version. 11.0 Page:9/173

2-Presentation

2 Presentation
This document is divided into 8 chapters and an index at the end.
The 8 chapters are listed here below:
A Description of BEST, which briefly describes what BEST is and what it can do,
Data, which provides a description of the data used and processed during a BEST
session,
Results, which explains how the structure of the operations results are built and how they
can be employed and employed,
Parameters, which define how BEST is configured from the outside and how the
configuration affects its appearance and behavior,
Operation which lists and describes the different types of calculations that BEST can
perform,
Functions which explains how to implement BEST’s different functions,
Windows which describes the different windows in BEST ,
Menus which lists and describes all the menus and sub-menus in BEST ,

In this document:
This Text style indicates that there is a hyperlink associated with the text. Just click on it
with the left mouse button to go to the relevant topic.
This Text style indicates that the text is displayed exactly that way in a BEST
window.

Best - Version. 11.0 Page:10/173

3-Description of BEST

3 Description of BEST
BEST (Basic Elements for Simulation in Thermodynamics) is an application developed by Elf
Exploration Production.
Its aim is to provide for the needs of all PVT studies conducted by EEP.
In this framework, it can be said that BEST combines the functions of:
A PVT package,
A 1D simulator,
A data table generator,
A calculation engine,
A simplified process simulator,
A test container for user-developed modules
BEST processes Data in the standard office application format (.txt, .xls, files) and can directly
exchange External Data with other programs through DDE processes.
Most of the software characteristics are defined externally in a configuration file named PLUG.XLS
file.
BEST’s functions are used in Elementary Blocks of Operation calculations, but they can also be
predefined (Black Oil, MMP).
Case studies are easy to perform by defining a special Multi Case file. Results are automatically
generated for all the relevant cases.
The software has an internal calculator (such as Excel’s Formula manager) that enables the user to
create references, and an Optimizer that can provide solutions to optimization and matching
problems.
The software can be controlled from outside through DDE functions which allow Automation of
calculations using Excel
Any Calculation Function which can calculate a new property from an existing phase Properties can
be entered by a user who is familiar with programming under FORTRAN.
The formatting of Results generated by each block can be modified as desired by the user and the
Look of the Software can be customized without having to modify the code.

Best - Version. 11.0 Page:11/173

4-Data Introduction

4 Data

4.1 Introduction
This chapter describes the data used in a BEST session:
These data can be classified in two categories:
External Data, which comprise all data that can be imported into BEST and exported or
saved for later use,
Internal Data which are generated by BEST and can only be saved in BEST file format.
A few Definitions of commonly used terms are provided in this chapter.

Best - Version. 11.0 Page:12/173

4-Data Definitions

4.2 Definitions

4.2.1 Introduction

Certain words or expressions are used repeatedly throughout the present document to describe Data
or Operations.
To leave no doubt as to their meaning, the terms below are defined in the following pages:
Blocks
Cut
Fluid
Group
DDE

4.2.2 Block

Blocks are basic building blocks that are a visual representation of Operations processed by BEST.
Each box has a specific type which is defined in the Operations worksheet of the file PLUG.XLS.
The following types of blocks are presently available:
1. Flash,Constant Ki Flash
2. Bubble Pressure , Retrograde and Normal Dew-Point Pressure
3. Ger, GerP, GerDiff,
4. Water-Oil-Gas Three-phase Flash,WaxFlash,Wax Tcc
5. Split, Set Flash, StreamGenerator
6. CVD (Constant Volume Depletion), Isochor, MMP, Phase Enveloppe
7. Genese Migration, Piege
8. Variable,
9. Controller
Data input into blocks can be either Fluids generated by other blocks or external fluids stored in a
Fluids File.
Each block can be related to one or more other blocks through:
stream it accepts as input
stream generated as output
Each box defined is associated, through its type, to one and only one Operation.
The properties of the blocks are defined in the Block Properties window.

4.2.3 Cut

A cut is a pseudo component defined by at minimum, the following characteristics:

Tc: Critical temperature
Pc: Critical pressure
Omega: Acentric factor
Mw: Molecular weight
And optionally by these characteristics:
Ci: Volume translation (constant term)
Cj: Volume translation (Temperature dependent term)
Parachor: Parachor
Sg: Specific gravity
Best - Version. 11.0 Page:13/173
4-Data Definitions
PCS: Gross calorific value
S0: Reference entropy
The coefficients: CpA, CpB, CpC, CpD Cp
Model parameters: OmegaA, OmegaB
Artep code number
V0 Parameter for Zhou viscosity model
Fusion Temperature and enthalpy
Solid Solid Transition temperature,and enthalpy
BEST can access cut properties that are defined in the Cuts worksheet of the PLUG.XLS file.
A cut is the basic element of a Fluid

Important remark:
The properties above are referenced by codes in the Cuts worksheet of the PLUG.XLS file. To
ensure that properties are properly identified, their identifier codes must not be modified.

4.2.4 Fluid

A fluid is a set of Cuts whose properties are supplemented by a quantity of matter (always in moles)
and, if necessary, by a set of binary interaction coefficients.
In BEST fluids are defined and are present as:
External fluids stored in Fluids files,
Fluids generated by BEST as output of Block calculations.
In BEST fluids are managed through a feeds field and an External streams field in the Block
properties Window.
Fluid properties are calculated when the blocks that use or produce the fluids are calculated.
Properties calculated for a fluid are defined by the block in which the fluid is used. They are
explicitly defined in the Results file associated with each block in the Operations worksheet of the
PLUG.XLS file and therefore they are directly related to the Operation performed.

4.2.5 Group

A group is a set of Blocks.

It is created with the sub-menu Group under the Object Menu.
All blocks that compose it are accessible, in particular to define the feed for other blocks.
However, their names are changed from NameBlock to NameGroup_NameBlock.
Groups are mandatory in operations such as:
Black Oil
Versus Time
And are extremely useful for:
Simplifying complex flow sheets
Copying/pasting a set of already defined blocks
for example.
Once created, the contents of a group can be accessed by double clicking on the left mouse button.
The contents are displayed on the background of the Group definition window as a diagram of
blocks composing the group and their sequencing.
For easy recognition, a group is color coded by a specific color.

Best - Version. 11.0 Page:14/173

4-Data Definitions
Finally, a group can be ungrouped again into its original blocks.

4.2.6 DDE

DDE signifies Dynamic Data Exchange. It is a standard protocol for data exchange between
Windows programs.
DDE is based on a formula with 3 parts:
The application name,
The file name or subject,
The cell range, value, field or data
to which it refers.
In BEST DDE is used to retrieve Block calculation parameters in Excel and conversely, DDE
makes it possible for Excel to directly retrieve calculation Results from BEST.
Moreover, macro commands were developed to control BEST from within files and to Automate
the calculation process in Excel or in other external DDE-compatible applications. When BEST is
installed, a sample of this type of software application is provided.

Best - Version. 11.0 Page:15/173

4-Data External data

4.3 External data

4.3.1 Introduction

The following types of external Data can be accessed by BEST:

Fluids file
Block calculation parameters
External definition of Blocks
Multi-Case Data File
Versus-Time calculation worksheet
These are qualified as External data because they are accessible by BEST.
From specific files that are only read,
Using DDE links to access certain Block calculation parameters.

4.3.2 Fluids file

Fluids files constitute part of the External data that can be used by BEST.
Fluids files consist in one Excel files sheet that must be formatted as follows:
Line 1
Each cell must contain
One and only one keyword of the list available in the Cuts sheet of the PLUG.XLS file or
The keyword Cut that defines the name of a Cut or
The keyword Mole that defines the number of moles in the corresponding Cut.
Or the name of a cut as defined in the Cut column
Following lines:
They contain the values of the properties given in each of the columns of the first line
If the column name is the name of a cut, the value to enter at the intersection with another cut is the
binary interaction coefficient between the two cuts.

Cut Mole Tc Pc Om
N2 30.0
C1 45.0
C2 25.0

Important remark:
You must notice that from version 9.1, the Excel sheet defining the fluid components data and the
fluid composition must be named "Reference".

Important remark:
You must notice that from version 11.0, the Excel sheet defining the fluid components data and the
fluid composition may not define any fluid composition if the StremGenerator box is sued as
the first box of the flowsheet. .

Best - Version. 11.0 Page:16/173

4-Data External data
4.3.3 Block calculation parameters

Each type of Block requires calculation parameters for each Operation performed.
These parameters are entered in the Block properties window, and can also be defined as External
data, i.e. in a file created outside of BEST.
These values are imported into BEST blocks using a DDE syntax in the Block Properties window.
The precise syntax to use is:
Excel | [ file_name ] sheet_name ! LiCj
Where:
Excel is the application name
| is the pipe symbol
[ is an opening brackett
file_name is the name of the excel file containing the data
] is a closing bracket
sheet_name is the name of the target Excel sheet in file_name
! is an excalamation mark
LiCj is the target cell reference in the sheet_name sheet of file_name
For an example, you can use the best data file BEST.eqf and the BEST.xls Excel file, which are
linked and interdependent.

Important remark:
It is very important to note that the file containing the calculation parameters and used in a
calculation must be opened before executing the calculation itself. If this is not done, a message
“DDE Request failed” is displayed by the system.

Important remark:
In the syntax above, the filename is the one displayed in the Excel title bar and therefore
corresponds to the filename, but without its path.

4.3.4 External definition of Blocks

Each Block type can be defined externally, in terms of its operating parameters, as well as its type,
its position, its connections and its feed.
The parameters are defined using specific DDE functions described in the section on Automation of
calculations using Excel.

4.3.5 Multi Case data file

These Excel-type External Data files are used to implement Multi Case studies on the same flow
sheet.
Their syntax is given below:
Line 1:
Best - Version. 11.0 Page:17/173
4-Data External data
Contains the headers of the columns in the file:
Case for the first column that contains the name of the case to process
Block_Parameter (Block_Name) for headers of all other columns.
Lines 2 to n:
Contain:
The name of the case in the first column
The value of the parameter (described in the column header) to take into account for the
case cited for each of the other columns.
The files MultiCas.xls and MultiCas.eqf give an example of a Multi Case calculation
Case Pressure(Block1) Temperature(Block1)
Case_1 20 10
Case_2 30 15

Important remark:
You must notice that from version 9.2.1, the Excel sheet defining the Multi Case data must be
named "MultiCase"(no white Space between Multi and Case).

4.3.6 Versus Time calculation sheet

These External Data sheets are required by the Versus Time calculation.
They are formatted as follows:

4.3.6.1 Line 1:
List of Block or variable parameters:
Pressure(block) for example,
Note that the block names are generated and that the syntax is Pressure(block) and not
Pressure(G1_block) (see Group and Versus Time)

4.3.6.2 Following lines:

Values of the parameters given in the first line.

Pressure(Block1) Temperature(Block1)
20.0 10.0
30.0 15.0

Important remark:
You must notice that from version 9.2.1, the Excel sheet defining the VersusTime data must be
named "VersusTime" (no white Space between Versus and Time).

Best - Version. 11.0 Page:18/173

4-Data Internal Data

4.4 Internal Data

4.4.1 Introduction

BEST handles the following types of internal Data:

Formulas
Topology
Results of matching
Global Parameters
Manual data modifications
These data are qualified as internal as, theoretically, they cannot be saved and stored other than by
saving them in a BEST file format (*. eqf).

4.4.2 Formulas

All information input in BEST editable fields is run through a formula interpreter.
Formulas are Internal Data that can be saved only in BEST file format (*.eqf).
This particular approach makes it possible to process all information entered in BEST like a
formula comprising the following items:
Operators
Variables
This makes it possible to build complex expressions.

4.4.2.1 Operators
The following operators are available for building Formulas:
Operator Description
ABS(...) Absolute value
EXP(...) Exponent
LOG(...) Neperian logarithm
LOG10(...) Base 10 logarithm
Racine(...)
Square root
SQRT(...)
... + ... Addition
... - ... Subtraction
- ... Change of sign
... * ... Multiplication
... / ... Division
... = ... Equality (see IF)
... > ... Greater than
... < ... Less than
... <> ..., Different than
... >= ... Greater than or equal to
... =< ... Less than or equal to

Best - Version. 11.0 Page:19/173

4-Data Internal Data
Operator Description
Test that evaluates the value of...1 and returns:
...2 if ...1 is true
IF(...1;...2;...3) ...3 if ...1 is false
Note that the delimiter between...1 and ...2 and
between ...2 and ...3 is a ";" (semi-colon)

4.4.2.2 Variables
The variables that can be used in the Formulas are:
Any character string that can be interpreted as a number,
Any character string that can be interpreted as XXXX(YYYY) where:
XXXX is the name of a property that can be calculated as defined in the Properties sheet
of the PLUG.XLS file
YYYY is the name of a Block
any character string that can be interpreted as XXXX(YYYY,ZZZZ) where:
XXXX is the name of a property that can be calculated as defined in the Properties
worksheet of the PLUG.XLS file
YYYY is the name of a Block.
ZZZZ is the name of a Cut

4.4.2.3 Expressions
An expression is a string of characters composed of Operators and Variables.
A certain number of examples are given below:
Xi(block,N2)+Xi(block,CO2)
DeltaH(block)*Temperature(block)
Split(block,CO2)*0.1
ViscosityLiquid(block)/100.0

4.4.3 Topology

The topology of flow sheets defined in BEST is part of BEST Internal Data as it can only be saved
and stored in BEST file format (*.eqf) generated by the Save or Save As submenu in the File
Menu.
The topology is created and modified by creating Blocks and by defining/modifying feeds (in the
Block properties window) of the various blocks composing the flow sheet.
It can be viewed in the Display Area of the Main Window .

Important remark:
You must notice that from version 11.0, the topology can be saved in a text file. This text file can
then be used to recreate the topology using DDE commands..

Best - Version. 11.0 Page:20/173

4-Data Internal Data
4.4.4 Calculation results

Matching that are performed using the Optimizer makes it possible to adjust the Optimization
parameters to comply with Specifications.
Once performed, the matches modify the Block operating parameters or the Cut properties.
The calculation results can be saved only in BEST file format (*.eqf) generated using the Save or
Save As submenu in the File Menu.

4.4.5 Global Parameters

These parameters are global in the way that they are not associated to any Block or Cut.
They are available and editable in the Parameters Window available using the Parameters submenu
of the Data menu

4.4.6 Equations of State

Different cubic equations of state are available in Best.

They can be chosen in the Parameters Window available using the Parameters submenu of the Data
menu

4.4.7 Manual data modifications

As for practically any software, the BEST configuration data can be modified manually:
These modifications essentially involve:
Data that can be accessed in the Block properties window
Data that can be accessed in the Cuts properties window.
Data that can be accessed in the Parameters window.
Although these data (in particular Block calculation parameters) can be output by files defining
External Data linked by DDE, the most common case remains that of an internal definition.
Any modification will only be saved by the Save or Save As submenu in the File Menu.

Best - Version. 11.0 Page:21/173

5-Results Introduction

5 Results

5.1 Introduction
As described in the chapter on Parameters used to configure BEST, the results of successful Block
operations are:
Formatted according to the definitions and formats in the Operations worksheet of the
PLUG.XLS file
Accessible in the Block Properties window, after the calculation is performed.
However, a very powerful method of managing BEST results is possible using DDE with External
files.
A specific syntax must always be used for such exchanges.
The DDE links can also be used to define the Block calculation parameters, also in external files.

5.2 External files

Any external file that supports DDE can be used to retrieve calculation results output by BEST.
In most cases, the files implemented in data exchange are Excel files as they can also be used to
easily create graphs and perform additional calculations.
The reader should also note that objects can also be inserted in BEST worksheets (using the
submenu Insert New Object under the Edit Menu) to give access to external files embedded in the
structure of BEST worksheets.

5.3 Syntax
The following syntax must be respected when retrieving BEST calculation results:

Application name property name

Opened file name

= symbol block name

=THERMO|file.eqf!'property(block)'

Pipe (|) symbol

Exclamation mark Quote (') symbols

The block argument of the property may also be replaced by the arguments:
cut,block when the property is a cut property.
The syntax is then:
=THERMO|file.eqf!'property (cut,block)'
The files Best.eqf and Best.xls available in the BEST installation directory support the data
exchange described above.
The reader should note that performing “Drag and Drop” operations in the Properties List Window
generates the proper syntax directly.

Best - Version. 11.0 Page:22/173

5-Results Utilising DDERequest

Important remark:
In the syntax above, the filename is the one displayed in the Best title bar and therefore corresponds
to the filename, but without its path.

Important remark:
The file name appearing in the Best window title bar may or may not include the .eqf extension.
This only depends on your microsoft window display option. In any case, the file name to use is
exactly the one appearing in the window because Microsoft windows looks for windows by
analyzing the text appearing in their title bars.

5.4 Utilising DDERequest

The standard function DDERequest can also be used very effectively to retrieve values.
Its use is described in the section on Automation of calculations using Excel.

Best - Version. 11.0 Page:23/173

6-Parameters Introduction

6 Parameters

6.1 Introduction
To enhance its adaptability and evolution, BEST was designed to be configured as extensively as
possible.
BEST parameters are used to define the:
Look of the software
Behaviour of the software
The parameters are entered in the PLUG.XLS file, which can be edited using the Microsoft Excel
application.

Best - Version. 11.0 Page:24/173

6-Parameters Look of the software

6.2 Look of the software

As regards the Look of the software, the Parameters used are those contained in the calculation
sheets whose names begin with the words Input or Result and which correspond respectively
to:
Sheets that define the Input parameters of the blocks:
Sheets that define the Format of output results

6.2.1 Input parameters

They are defined in the sheets named

InputPT,
InputPTH,
InputPTSel,
InputPTHP,
InputPTHA,
InputSplit,
InputKiCst,
InputPTV,
InputPTTETA,
InputCons,
InputMigration
InputPiege
InputGenese
InputPrePvt
InputMMP
InputEnv
InputWax

6.2.2 Results output formats

They are defined in the sheets named:

Results,
ResultWater,
ResultSplit,
ResultCons,
ResultMigration
ResultPiege
ResultGenese
ResultKiCst
ResultStream
ResultMMP
ResultEnv
Best - Version. 11.0 Page:25/173
6-Parameters Look of the software
ResultWax

Best - Version. 11.0 Page:26/173

6-Parameters Software behaviour

6.3 Software behaviour

The behaviour of the software, i.e. how it deals with the calculations requested and performed, is
entirely controlled by parameters in the sheets below:
Cuts,
Properties,
Generic
Parametres,
Operations,
Phases
Contained in the PLUG.XLS file.

6.3.1 Cuts

The Cuts sheet defines the identifiable properties of oil Cuts characterising a Fluid in terms of
composition.

6.3.2 Properties

The Properties sheet defines how the phase properties are calculated

6.3.3 Generic

The Generic sheet defines how properties are calculated when they exist for each phase.

6.3.4 Parametres

The Parametres sheet defines the global parameters associated with specific prioperties. These
parameters have available for modification and can be used in fitting procedures.

6.3.5 Operations

The Operations sheet defines the different Operations available and their relation with the sheets
that define Input parameters and Formats of output results.

6.3.6 Phases

The Phases sheet defines which names or aliases are used to identify phases.

Best - Version. 11.0 Page:27/173

6-Parameters PLUG.XLS file

6.4 PLUG.XLS file

6.4.1 Introduction

The file PLUG.XLS is the BEST software configuration file.

It is an Excel file that contains the following sheets:
Results which defines the format called Results associated with several types of blocks as
indicated in the Operations sheet
ResultWater , which defines the format called ResultWater associated with Water-oil-
gas three-phase flash blocks as indicated in the Operations sheet
ResultSplit , which defines the format called ResultSplit associated with the Split
blocks as indicated in the Operations sheet
ResultCons which defines the format called ResultCons associated with Variable blocks
as indicated in the Operations sheet
ResultMigration which defines one of the formats associated with the exploration
functionnalities
ResultPiege which defines one of the formats associated with the exploration
functionnalities
ResultGenese which defines one of the formats associated with the exploration
functionnalities
ResultKiCst which defines the format called ResultKiCst associated with the Constant
Ki Flash blocks as indicated in the Operations sheet
ResultStream which defines the format called ResultStream associated with the Stream
Generator blocks as indicated in the Operations sheet
ResultMMP which defines the format called ResultMMP associated with the MMP blocks
as indicated in the Operations sheet
ResultEnv which defines the format called ResultEnv associated with the Phase
Envelope blocks as indicated in the Operations sheet
ResultWax which defines the format called ResultWax associated with the FlashWax end
TccWax blocks as indicated in the Operations sheet

The calculation Data definition file for the Blocks:

InputPT,
InputPTH,
InputPTSel,
InputPTHP,
InputPTHA,
InputSplit,
InputKiCst,
InputPTV,
InputPTTETA,
InputCons,

Best - Version. 11.0 Page:28/173

6-Parameters PLUG.XLS file
InputMigration
InputPiege
InputGenese
InputPrePvt
InputMMP
InputEnv
InputWax

Specific sheets:
Proprietes, which defines which Calculation functions, are used for properties associated
with specific phases,
Parametres, which defines the parameters associated with some of the calculated
properties,
Operations, which define the different Operations available
Coupes, which define the identifiable properties of oil Cuts, characterizing a Fluid in
terms of composition.
Phases, which define the phases that can be used for the different blocks.
Generique, which defines the properties associated with all the phases.

6.4.2 Results

The Results sheet in the PLUG.XLS file defines the printout format called Results.
It is referred to in the sheet Operations where it is associated with one or several Operations.
All results sheets have the same layout, i.e. the table of results is defined by creating an equivalent
table containing the names of the properties to be printed.

This table is defined in an Excel file that is formatted as follows:

6.4.2.1 Line 1
This line is present in all the sheets that define the results format. It contains the definition of the
results table that provides the number of moles and the molar composition for the block inputs and
outputs associated with this results format.
It is organized in cells:
1. The text Libelle identifies the Proprietes labels column. The properties present in this column
must be present in the output of the block that uses this results format
1. The text Coupe, which indicates that a column containing the names of the Cuts must be
generated,
2. The code Nif, which indicates that a column containing the number of moles in each cut in
the Block feed must be generated
3. The code Niv, which indicates that a column must be generated containing the number of
moles in each cut in the block vapor output. The association between Niv and the phase
designated as vapor is detailed in the Phases sheet
4. The code Nil, which indicates that a column must be generated containing the number of
moles in each cut in the block liquid output. The association between Nil and the phase
designated as liquid is detailed in the Phases sheet

Best - Version. 11.0 Page:29/173

6-Parameters PLUG.XLS file
5. The code Zi, which indicates that a column must be generated containing the standardized
mole fractions for each cut in the block feed
6. The code Yi, which indicates that a column must be generated containing the standardized
mole fractions for each cut in the block vapor output. The association between Yi and the
phase designated as vapor is detailed in the Phases sheet
7. The code Xi, which indicates that a column must be generated containing the standardized
mole fractions for each cut in the block liquid output. The association between Xi and the
phase designated as liquid is detailed in the Phases sheet

6.4.2.2 Following lines

The following lines all have the same organization that is, again, defined by cells. These cells are
defined by:

1. Label of property calculated, which will be displayed in Results table.

2. Empty cell
3. Name of property to display. This name should correspond to one of the names available
in:
the Proprietes sheet, or
the Generique sheet (see Remark 2 below) or
the cell corresponding to the operation pertaining to the Output column in the
Operations sheet in the PLUG.XLS file.
4. Name of a property to be displayed, this name must comply with the same rules as those
listed for cell 3, above.
5. Name of a property to be displayed, this name must comply with the same rules as those
listed for cell 3, above.

Remark :
The position of the property names in the cells can be used to position the corresponding values in
the Results table. It is therefore recommended to place the names of the feed properties in the same
column as Nif, the names of the phase associated with Nil in the Phases sheet in the same column as
Nil, etc…

Remark 2:
The names of the properties in the Generique sheet cannot be used directly. Consult the
documentation on this sheet for details on how to use these properties.

6.4.3 ResultWater

The ResultWater sheet in the PLUG.XLS file defines the ResultWater printout format.
It is referenced in the Operations sheet where it is associated with one or several Operations.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Results sheet.

Best - Version. 11.0 Page:30/173

6-Parameters PLUG.XLS file
6.4.4 ResultSplit

The ResultSplit sheet in the PLUG.XLS file defines the printout format named ResultSplit .
It is referenced in the Operations sheet where it is associated with one or several Operations.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Results sheet.

6.4.5 ResultMigration

The sheet ResultMigration in the PLUG.XLS file defines the printout format named
ResultMigration.
It is referenced in the Operations sheet where it is associated with the Migration Operation
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Resultats sheet.

Remark :
In this sheet, the output phases are not explicitly distinctive (in terms of liquid and vapor) but their
definition corresponds in all points with the definitions given:
In the Phases sheet as regards the phase names and
In the Generique sheet as regards the properties to be printed.
For example MoleTr1 , MasseTr1 and MwTr1 are output by the MolePhase , MassePhase
and MwPhase properties in the Generique sheet by replacing the Phase string by a Tr1 string.
Tr1 is the name of one of the phases output by the Migration Operationas indicated in the Phase
column of the Operations sheet.
.

6.4.6 ResultPiege

The sheet ResultPiege in the PLUG.XLS file defines the printout format named ResultPiege.
It is referenced in the Operations sheet where it is associated with the Trap Operation.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Resultats sheet.

Remark
In this sheet, the output phases are not explicitly distinctive (in terms of liquid and vapor) but their
definition corresponds in all points with the definitions given:
In the Phases sheet as regards the phase names and
In the Generique sheet as regards the properties to be printed.

Best - Version. 11.0 Page:31/173

6-Parameters PLUG.XLS file
For example MoleBTr1 , MasseBTr1 and MwBTr1, are output by the MolePhase ,
MassePhase and MwPhase properties in the Generique sheet by replacing the Phase string by a
B Tr1 string. B Tr1 is the name of one of the phases output by a Trap Operation as indicated in
the Phase column of the Operations sheet

6.4.7 ResultGenese

The sheet ResultGenese in the PLUG.XLS file defines the printout format named
ResultGenese.
It is referenced in the Operations sheet where it is associated with the Generation Operation.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Resultats sheet.

Remark
In this sheet, the output phases are not explicitly distinctive (in terms of liquid and vapor) but their
definition corresponds in all points with the definitions given:
In the Phases sheet as regards the phase names and
In the Generique sheet as regards the properties to be printed.
For example MoleTr1 , MasseTr1 and MwTr1 are output by the MolePhase , MassePhase
and MwPhase properties n the Generique sheet by replacing the Phase string by a Tr1 string.
Tr1 is the name of one of the phases output by a Generation Operation as indicated in the Phase
column of the Operations sheet.

6.4.8 ResultKiCst

The sheet ResultCons in the PLUG.XLS file defines the printout format named ResultKiCst.
It is referenced in the Operations sheet where it is associated with the Flash Ki Constants Operation.

6.4.9 ResultCons

The sheet ResultCons in the PLUG.XLS file defines the printout format named ResultCons.
It is referenced in the Operations sheet where it is associated with the Variable Operation.
This sheet is quite specific in that it defines a single output value, the one defined in the Variable
type block with which it is associated.

6.4.10 ResultStream

The ResultStream sheet in the PLUG.XLS file defines the printout format named
ResultStream.
It is referenced in the Operations sheet where it is associated with one or several Operations.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.

Best - Version. 11.0 Page:32/173

6-Parameters PLUG.XLS file
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Results sheet.

6.4.11 ResultMMP

The ResultMMP sheet in the PLUG.XLS file defines the printout format named ResultMMP.
It is referenced in the Operations sheet where it is associated with one or several Operations.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Results sheet.

6.4.12 ResultEnv

The ResultEnv sheet in the PLUG.XLS file defines the printout format named Resultenv.
It is referenced in the Operations sheet where it is associated with one or several Operations.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Results sheet.

6.4.13 ResultWax

The ResultWax sheet in the PLUG.XLS file defines the printout format named ResultWax.
It is referenced in the Operations sheet where it is associated with one or several Operations.
The results sheets all have the same layout, i.e. the table of results is defined by creating an
equivalent table containing the names of the properties to be printed.
This table is defined in an Excel sheet. Its layout follows the principle detailed in the paragraph on
the Results sheet.

6.4.14 InputPT

The sheet InputPT in the PLUG.XLS file defines the data used to calculate the Blocks associated
with it in the Operations sheet .
It is organised as follows:

6.4.14.1 Line 1
This line simply contains the titles of the columns in the sheet.

6.4.14.2 Following lines

They contain, cell by cell from left to right:
1. The Name of the data item,
2. The Label of the data item as it appears in the window of relevant blocks,
Best - Version. 11.0 Page:33/173
6-Parameters PLUG.XLS file
3. The Type of data (0=scalar, 1=vector)
4. The Default value to associate with it
5. The indication to Show or hide it in the Block parameters.
Use of these last two parameters is detailed in the InputGenese sheet

Remark:
A vector data item (type = 1) has the size of the maximum number of components that BEST will
accept.

6.4.15 InputPTH

The sheet InputPTH in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.16 InputPTHP

The sheet InputPTHP in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.17 InputPTHA

The sheet InputPTHP in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.18 InputPTSel

The sheet InputPTSel in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.19 InputKiCst

The sheet InputSplit in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

Best - Version. 11.0 Page:34/173

6-Parameters PLUG.XLS file
6.4.20 InputSplit

The sheet InputSplit in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.21 InputPTV

The sheet InputPTV in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.22 InputPTTETA

The sheet InputPTTETA in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.23 InputCons

The sheet InputCons in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.24 InputMigration

The sheet InputMigration in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.25 InputPiege

The sheet InputPiege in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.26 InputGenese

The sheet InputGenese in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

Best - Version. 11.0 Page:35/173

6-Parameters PLUG.XLS file
6.4.27 InputPrePvt

The sheet InputPrePvt in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.28 InputMMP

The sheet InputMMP in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.29 InputEnv

The sheet InputEnv in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.30 InputWax

The sheet InputWax in the PLUG.XLS file defines the data used to calculate the Blocks
associated with it in the Operations sheet .
It is structured like the InputPT sheet.

6.4.31 Proprietes

The sheet Properties in the PLUG.XLS file specifies how properties in a specific phase are
calculated.

Remark:
When a property can be applied to all the phases – see Phases – it must be defined in the Generique
sheet.

The specification of the calculation of a property requires, in particular, the definition of the name
of the Calculation functions used and the listing of its arguments.
All this information is provided in the Properties sheet which is structured as follows:

6.4.31.1 Line 1
This line simply contains the titles of the columns in the sheet

6.4.31.2 Following lines

They contain, cell by cell, from left to right:
Best - Version. 11.0 Page:36/173
6-Parameters PLUG.XLS file
1. The name of the property, which is also the name of the Calculation function which is used to
determine it
2. The number of the property code (this number is only defined for properties which are
calculated internally, and must in no case be modified).
Internal Properties and their numbers are listed at the end of this section.
3. The type of property, which defines if the property is scalar (0) or vector (1)
4. The arguments of the property’s calculation function, and consequently the list of properties
that must be known so that the property in question can be calculated. Any property name
that appears in this list must also be located in:
- in the first column of the sheet or
- in the Generique sheet or
- in the Coupes sheet.
5. The phase at which the property calculation can be applied.
If the property is applicable to all phases, its definition must appear in the Generique sheet.
6. The fact that the property is declared or not declared as "user". If the property is assigned the
number of 1, it is defined as "user".
This means that it will appear in the list of properties in the Properties listing window when
the User toggle is selected.
If the property is not assigned the number of 1, it will not appear in the list of properties
when the User toggle is selected.

6.4.31.3 Internal properties

These properties are generated directly by the system and their definitions must not be modified.
4 VolumeGazStandard Volume of Gas calculated at 1 bars and 15 degrees Celsius, considering
that the phase Z factor is equal to unity (the gas is so considered as perfect)
22 Nif Number of moles of feed (Vector)
29 Zi Compositions of feed (Vector)
30 EnthalpieFeed Enthalpy of feed
31 EntropyFeed Entropy of feed

6.4.32 Parametres

The sheet Parametres in the PLUG.XLS file defines:

the global parameters.
the available Equations of State

The parameters are defined as follows

6.4.32.1 Line 1
This line simply contains the titles of the columns in the sheet

6.4.32.2 Following lines

They contain, cell by cell, from left to right:
1. The Name of the global
2. The Symbolof the parameter, the one which is used to identify the parameter in the
Properties listing window
Best - Version. 11.0 Page:37/173
6-Parameters PLUG.XLS file
3. The Default value of the paremeter
4. The indication to Show or hide it inParameters Window .
5. The fact that the property is declared or not declared as "user". If the property is assigned the
number of 1, it is defined as "user".
This means that it will appear in the list of properties in the Properties listing window when
the User toggle is selected.
If the property is not assigned the number of 1, it will not appear in the list of properties
when the User toggle is selected.

The equation of state to use for the calculation is defined by selecting one name in the
coprresponding list box.

6.4.33 Operations

The sheet Operations in the PLUG.XLS file specifies how the Operations work.
This is defined in the sheet in the following way:

6.4.33.1 Line 1
This line simply contains the titles of the columns in the sheet

6.4.33.2 Following lines

They contain, cell by cell, from left to right:
1. The name (label) of the operation,
2. The number of the operation
3. The maximum Number of Phases produced by the operation
4. The name of the result Template to use to output the calculation results. This name must
correspond to the name of one of the other sheets in the PLUG.XLS file (Resultats, for
example)
5. the name of the Parameter sheet that defines the Block calculation parameters required to
run the calculation
6. The name of the corresponding function
7. The list of phases produced by the operation (the names are separated by commas)
8. The list of Outputs calculated by the operation (the names are separated by commas)

6.4.34 Coupes

The Coupes sheet in the PLUG.XLS file specifies how the Cuts are defined.
This definition is specified by a single column in the sheet
The first cell contains the name of the column and the following cells contain the names of the
properties BEST can identify, in particular in the framework of the Properties sheet.
This sheet currently contains the following properties names, which must in no case be modified:
Mw: Molecular weight
Tc: Critical temperature (K)
Pc: Critical pressure (Bars)
Omega: Acentric factor

Best - Version. 11.0 Page:38/173

6-Parameters PLUG.XLS file
Ci: Volume translation / bi
Vc: Critical volume (cm3/mole)
Parachor: Parachor
Sg: Specific Gravity
Pcs: Gross calorific value
S0: Reference Entropy
CpA to CpD: Cp coefficients
OmegaA: EOS model constant for "a"
OmegaB: EOS model constant for "b"
Artep: Artep Code number
V0: Parameter for Zhou viscosity model
TF: Fusion Temperature (C)
HF: Fusion enthalpy (J/mole)
TSSO: Solid Solid Transition temperature (C)
HSSO: Solid Solid Transition enthalpy (J/mole)

6.4.35 Phases

The sheet Phases in the PLUG.XLS file specifies how the phases produced by the operation are
managed.
These specifications are defined in the sheet as follows:

6.4.35.1 Line 1
This line simply contains the labels of the columns in the sheet

6.4.35.2 Following lines

They contain, cell by cell from left to right:
1. The name (label) of the phase
2. The Alias of the phase name
3. The Abbreviation defining the numbers of moles in the phase
4. The code defining the molar Percentage in the phase
5. The HighLow position of the arrow that graphically defines the phase output by the block
that generates it
6. The Red component value of the RVB color definition of the arrow that graphically defines
the phase output by the block that generates it
7. The Green component value of the RVB color definition of the arrow that graphically
defines the phase output by the block that generates it
8. The Blue value component of the RVB color definition of the arrow that graphically
defines the phase output by the block that generates it
9. The Position (in fraction of the width of the block, from the left) of the arrow that
graphically defines the phase output by the block that generates it

Best - Version. 11.0 Page:39/173

6-Parameters PLUG.XLS file
6.4.36 Generic

The Generic sheet of the PLUG.XLS file specifies how the properties of all the phases defined in
the sheet Phases are calculated.

Remark: When a property is applicable to a single phase it must be defined in the Properties
sheet.

The specification of a property calculation requires that the name of the Calculation function used
be defined and that its arguments be listed.
All of this information is provided in the Generic sheet, which is structured as follows:

6.4.36.1 Line 1
This line simply contains the titles of the columns in the sheet

6.4.36.2 Following lines

They contain, cell by cell from left to right:
1. The name of the property, which is also the name of the Calculation function used to determine it.
2. The Number of the property code (This number is only defined for properties that are
calculated internally and must in no case be modified).
The Internal properties: and their numbers are listed at then end of this section.
3. The Type of property, which defines if the property is scalar (0) or vector (1)
4. The Arguments of the property’s calculation function, and consequently the list of
properties which must be known so that the relevant property can be calculated. Any
property name that appears in this list must also be:
- in the first column of the sheet or
- in the Proprietes sheet or
- in the Coupes sheet.
5. The fact that the property is declared or not declared as "user". If the property is assigned the
number of 1, it is defined as "user".
This means that it will appear in the list of properties in the Properties listing window when
the User toggle is selected.
If the property is not assigned the number of 1, it will not appear in the list of properties
when the User toggle is selected.

Remark: The names listed in the first column of this sheet do not appear in the definition of
results of calculations performed by the blocks (see Resultats sheet for example)
This is explained by the fact that as indicated by the very name of the "Generique" sheet, the
properties listed are generic.
To truly access their value, you must replace the “phase” string by a string that defines the relevant
phase, a string that can be accessed in the “Name” column of the Phases sheet.
For example, the property ViscocityPhase in the Generique sheet is used in the Resultats file
in the form ViscosityVapour and ViscosityLiquid, Vapor and Liquid are the
names of the 2 phases defined in the Phases sheet.

Best - Version. 11.0 Page:40/173

6-Parameters PLUG.XLS file
6.4.36.3 Internal properties:
1. NiPhase : Number of moles of the components of a phase (Vector)
2. ZiPhase: Phase composition (Vector)
3. MolePhase: Total number of moles in a phase
4. MassePhase: Mass of a phase
5. MwPhase: Molecular weight of a phase
6. RoPhasePT: Density of a phase at P and T
7. Zphase: Compressibility factor of a phase
8. VolumePhasePT: Volume of a phase at P and T

6.4.37 Calculation functions

6.4.37.1 Introduction
The concept of a calculation function is specific to BEST. It allows any user to enhance the
product’s functions by developing and inserting customised calculation functions.

6.4.37.2 Default functions

The default properties calculation functions in BEST can be identified in the Properties and
Generique sheets of the PLUG.XLS file .
They are in fact stored in a DLL named BestDll.DLL, that comes with the product.
They have the following form:
DOUBLE PRECISION FUNCTION ZGAZ(N,IWORK,WORK)
IMPLICIT DOUBLE PRECISION (A-H,O-Z)
!MS$ATTRIBUTES C,ALIAS:'ZGaz': ZGAZ
!MS$ATTRIBUTES REFERENCE:N,IWORK,WORK
!MS$ATTRIBUTES DLLEXPORT: ZGAZ
DIMENSION IWORK(*),WORK(*)
PRESSION = WORK(IWORK((1))
TEMP = WORK(IWORK((2))
VOLUME = WORK(IWORK((3))
XMOLE = WORK(IWORK((4))
IF (XMOLE .GT. 0) THEN
ZGAZ =PRESSION*VOLUME / XMOLE / (TEMP+273.15) / 0.0831451
ELSE
ZGAZ =0
ENDIF
END
Each line is numbered so as to simplify its identification, but the numbering is not part of the original
code.
Line 1 defines the name of the function
Lines 3, 4 and 5 define:
The external name of the function, which is the name found in the Proprietes or Generique sheets of the
PLUG.XLS file,
Its arguments and
The name under which the DLL it contains is exported.
Lines 7, 8, 9 and 10 retrieve the contents of the WORK table, indexed by the IWORK table. It is important
to note that the contents of WORK is explicitly defined by the list of arguments provided by the Zgaz
function in the Proprietes sheet in the PLUG.XLS file
The following lines perform the calculation of the value returned by the function.

Best - Version. 11.0 Page:41/173

6-Parameters PLUG.XLS file
All functions implicitly listed in the Proprietes or Generique sheets of the PLUG.XLS file are built on the
basis of the same model.

6.4.37.3 User functions

BEST users can develop their own functions to calculate properties.
They are comparable to the Default Functions present in BEST but must be stored in a specific
DLL.
The name of this DLL is provided when using the IniBest program which overall allows the
user to define:
the real name and location of the PLUG.XLS file
the real name and location of the BEST DLL which contains the models for the Operation
calculations
the real name and location of the BEST DLL which contains the models for the Block
Properties calculations
the real name and location of the DLL which contains the user functions:
When in use, IniBest displays the following on screen:

Best - Version. 11.0 Page:42/173

7-Operations Introduction

7 Operations

7.1 Introduction
An operation is a calculation performed by BEST. A Block allows the calculation of one and only
one operation in the list:
Flash, Constant Ki flash
Bubble Pressure , Retrograde and Normal Dew-Point Pressure
Ger, GerP, GerDiff
Water-Oil-Gas Three-phase Flash, Wax Flash, Wax Tcc
Split, Stream Generator ,Set Flash,
CVD (Constant Volume Depletion), Isochor,
Genese, Piege, Migration
Hydrates formation Pressure and Hydrate formation Temperature ,
Variable,
Controller
Phase envelope points
MMP points
But certain operations:
Black Oil,
Multi Depth,
Phase Envelope,
Multi Case,
MMP,
Versus Time,
Optimizer.
are not associated with blocks or are also available without blocks.

Best - Version. 11.0 Page:43/173

7-Operations Flash

7.2 Flash

7.2.1 Introduction

This Operation is a calculation of a liquid-vapor equilibrium at set Temperature and Pressure.

It is defined in the Block Properties window.
Based on the compositional definition of a fluid, a flash determines, at a given T and P, the
compositions and respective quantities of the vapor and liquid phases at equilibrium.
The two phases produced by a flash (if they exist) are at thermodynamic equilibrium.

7.2.2 Scheme

7.2.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
and
the Fluids defining the feed

7.2.4 Results

If the flash is two-phase, the result is:

a quantity of vapor
a quantity of liquid
the composition of the vapor
the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.
If the flash is single phase the result is:
a quantity of vapor (or a quantity of liquid)
the vapor (or liquid) composition which is, moreover, the same as the feed composition
Best - Version. 11.0 Page:44/173
7-Operations Flash
the properties of this single phase as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.

Best - Version. 11.0 Page:45/173

7-Operations Constant Ki Flash

7.3 Constant Ki Flash

This operation allows the same calculation than the Flash Calculation.
It also gives the same results.
The only difference is that this operation uses given values of the equilibrium constants Ki instead
of calculating them using the compoenents physical properties and the Temperature and Pressure as
in the Flash calculation.

Best - Version. 11.0 Page:46/173

7-Operations Bubble pressure

7.4 Bubble pressure

7.4.1 Introduction

This Operation is a liquid-vapor equilibrium calculation at known Temperature and Vapor Fraction.
It is defined in the the Block Properties window.
It determines the pressure at which the first vapor bubble appears in the relevant fluid, at the
temperature entered.
Based on the compositional definition of a fluid, at given T and for a nil vapor fraction, the
corresponding pressure is calculated, as well as the hypothetical composition of the first gas bubble
formed.
The two phases output by the Bubble Pressure are at thermodynamic equilibrium, even though the
vapor phase is virtual and in nil quantity.

Remark:
It is essential to note that the calculation performed by this operation results in a two-phase system
with a vapor fraction whose value is very close to 0.

7.4.2 Scheme

7.4.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
An estimation of the pressure to be found
and
The vapor fraction set to 0 by BEST
The Fluid defining the feed

Best - Version. 11.0 Page:47/173

7-Operations Bubble pressure
7.4.4 Results

A nil quantity of vapor

A quantity of liquid equal to that in the feed
The composition of the vapor
The composition of the liquid identical to that in the feed
The properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file. .

Best - Version. 11.0 Page:48/173

7-Operations Retrograde and Normal dewpoint pressures

7.5 Retrograde and Normal dewpoint pressures

7.5.1 Introduction

These two Operations correspond to a calculation of the liquid-vapor equilibrium at known

Temperature and Vapor Fraction. They are defined in the Block Properties window.

They determine the pressure at which the first drop of liquid appears in the relevant fluid, at the
temperature entered. The Normal calculation provides a lower pressure than the Retrograde
calculation.
Based on the compositional definition of a fluid, at given T and for a vapor fraction equal to one
(1), the corresponding pressure is calculated, as well as the hypothetical composition of the first
drop of liquid formed.
The two phases output by the dewpoint pressure are in thermodynamic equilibrium, even though the
liquid phase is virtual and in nil quantity.

Remark:
It is essential to note that the calculation performed by this operation results in a two-phase system
with a vapor fraction whose value is very close to 1.

7.5.2 Scheme

Best - Version. 11.0 Page:49/173

7-Operations Retrograde and Normal dewpoint pressures
7.5.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
an estimation of the pressure to be found
and
The vapor fraction set to 0 by BEST
The Fluids defining the feed

7.5.4 Results

A nil quantity of liquid

A quantity of vapor equal to that in the feed
The composition of the liquid
The composition of the vapor identical to that in the feed
The properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

Best - Version. 11.0 Page:50/173

7-Operations Ger

7.6 Ger

7.6.1 Introduction

This Operation calculates the composition of a fluid at a given depth, knowing its composition at a
reference depth.
It is defined in the the Block Properties window.

Remark:
It is essential to note that this operation requires the definition of one and only one single-phase
feed (corresponding to the fluid at the reference depth) for the block performing the GER operation.

7.6.2 Scheme

7.6.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
the Temperature of the fluid at the depth at which the pressure is sought
the Pressure (optional)
Deltah: difference in depth (the depths increase in the downward direction)
and
The Fluid defining the feed

7.6.4 Results

The Pressure at the new depth

The composition at the new depth, associated with the stable phase at that depth.
The phase properties such as those defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.

Best - Version. 11.0 Page:51/173

7-Operations GerP

7.7 GerP
This Operation calculates the composition of a fluid at a given depth, knowing its composition at a
reference depth.
This operation uses the same calculation scheme as the Ger operation.
The only difference is that a Partial Segregation Coefficient can be associated to each component
The Data and Results are the same than for the Ger Calculation.

Best - Version. 11.0 Page:52/173

7-Operations GerDiff

7.8 GerDiff
This Operation calculates the composition of a fluid at a given depth, knowing its composition at a
reference depth.
Depending of your authorization level it may or may not be available in your own version of Best
This operation uses the same calculation scheme as the Ger operation.
The Results are the same than for the Ger Calculation.

The following image describes the GerDiff specific data which are described hereunder.

The calculation data may be completed using the following items:

- a gap in the X direction allowing to take into account a non vertical fluid column
- an Angle α defining from which direction fluxes are coming
- a mean permeability
- a mean porosity
- a flux Ji for each component
- a diffusion coefficient for each component

Best - Version. 11.0 Page:53/173

7-Operations Three-phase water-oil-gas flash

7.9 Three-phase water-oil-gas flash

7.9.1 Introduction

This Operation calculates the water-liquid-vapor equilibrium at set Temperatures and Pressures.
It is defined in the Block Properties window.
Using the compositional definition of a fluid, the three-phase flash operation calculates, at set T and
P, the quantities of each phase as well as their compositions.
For this operation, the Soreide and Whitson thermodynamic model is used.
The phases output by a three-phase flash are in thermodynamic equilibrium.

7.9.2 Scheme

7.9.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
Number of moles of salt
and
the Fluids defining the feed

7.9.3.1 Remark on required data:

To ensure the proper calculation of this type of block (i.e. with specific processing of water and
certain components) the Fluids file must contain the Artep codes of the Cuts.
These codes are used to define the following components:

Best - Version. 11.0 Page:54/173

7-Operations Three-phase water-oil-gas flash
H2O water 77
N2 nitrogen 56
CO2 carbon dioxide 1700
H2S Hydrogen sulphide 78
C6H6 Benzene 6300
C7H8 Toluene 7300
CH4 methane 1000
C2H6 ethane 2000
C3H8 propane 3000
nC4H10 n-butane 4000
iC4H10 iso-butane 4001
nC5H12 n-pentane 5000
iC5H12 iso-pentane 5001
nC6H14 n-hexane 6000
and to generate the binaries comprising these components by generating specific kijs.

7.9.4 Results

If the flash is three-phase, the result is:

a quantity of vapor
a quantity of hydrocarbon liquid
a quantity of aqueous liquid
the composition of the vapor
the composition of the hydrocarbon liquid
the composition of the aqueous liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

If the flash is two-phase, the result is:

a quantity of vapor
a quantity of liquid
the composition of the vapor
the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

If the flash is single-phase, the result is:

a quantity of vapor (or a quantity of liquid)

the composition of the vapor (or the liquid) which is, moreover the same as that of the feed
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

Best - Version. 11.0 Page:55/173

7-Operations Three-phase Wax-oil-gas flash

7.10Three-phase Wax-oil-gas flash

7.10.1 Introduction

This Operation calculates the Wax-liquid-vapor equilibrium at set Temperatures and Pressures.
It is defined in the Block Properties window.
Using the compositional definition of a fluid, the three-phase Wax flash operation calculates, at set
T and P, the quantities of each phase as well as their compositions.
The phases output by a three-phase Wax flash are in thermodynamic equilibrium.

7.10.2 Scheme

7.10.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
A WaxParam adjustment coefficient which can be used in tuning procedures
and
the Fluids defining the feed

7.10.3.1 Remark on required data:

To ensure the proper calculation of this type of block (i.e. with specific processing of parafins ) the
Fluids file must contain the Artep codes of the Cuts.
The TF, HF, TSSO and HSSO values MUST also be given. (see 6.4.34)

Best - Version. 11.0 Page:56/173

7-Operations Three-phase Wax-oil-gas flash
7.10.4 Results

If the flash is three-phase, the result is:

a quantity of vapor
a quantity of hydrocarbon liquid
a quantity of wax solid
the composition of the vapor
the composition of the hydrocarbon liquid
the composition of the wax
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

A return code is set after calculation completion:

If this code is 0, everything is OK
If this code is -2, the TF or TSSO data are missing

Best - Version. 11.0 Page:57/173

7-Operations Wax Tcc calculation

7.11Wax Tcc calculation

7.11.1 Introduction

This Operation calculates the Wax appearance temperature for a fluid at a given Pressure.
It is defined in the Block Properties window.
The phases output by a this operation are in thermodynamic equilibrium.

7.11.2 Scheme

An iteration scheme is added to this calculation in order to calculate the wax appearance
temperature.

7.11.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature as an initial value which will be calculated
Pressure
A WaxParam adjustment coefficient which can be used in tuning procedures
and
the Fluids defining the feed

7.11.3.1 Remark on required data:

To ensure the proper calculation of this type of block (i.e. with specific processing of parafins ) the
Fluids file must contain the Artep codes of the Cuts.
The TF, HF, TSSO and HSSO values MUST also be given. (see 6.4.34)

Best - Version. 11.0 Page:58/173

7-Operations Wax Tcc calculation

7.11.4 Results

If found, the waw appearance temperature displayed.

If the flash is three-phase, the result is:
a quantity of vapor
a quantity of hydrocarbon liquid
a quantity of wax solid
the composition of the vapor
the composition of the hydrocarbon liquid
the composition of the wax
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

A return code is set after calculation completion:

If this code is 0, everything is OK
If this code is
-1, the maximum number of iteration to calculate Tcc has been reached
-2, the TF or TSSO data are missing
-3, the Tcc calculation has reached the maximum allowed temperature (10K < Tcc < 1000 K)

Best - Version. 11.0 Page:59/173

7-Operations Split

7.12Split

7.12.1 Introduction

This Operation calculates the separation of a fluid into two other fluids, which is set by entering a
Split coefficient for each component.
It is defined in the Block Properties window.
The split coefficient is expressed as the percent quantity of each component to be transferred to the
Spec(see ResultSplit) output. The quantity in the AntiSpec is simply calculated by taking the
difference.
The Phases Spec and AntiSpec output by a Split are usually not in thermodynamic equilibrium.

7.12.2 Scheme

7.12.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Split coefficient per component expressing the percentage of the component which must
be affected to the "Spec" fluid.
and

the Fluids defining the feed

7.12.4 Results

Split is necessarily two-phase. The result is:

a quantity of a fluid named "Spec"

Best - Version. 11.0 Page:60/173

7-Operations Split
a quantity of la fluide name "AntiSpec"
the composition of "Spec" fluid
the composition of the "AntiSpec" fluid
the properties of these fluids, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

Remark on the generation of fluid compositions:

As Split (voluntarily) does not respects the material balance, it is possible to generate, from a
unique fluid, as many different fluid compositions as desired by performing a Split for each fluid
generated.

Best - Version. 11.0 Page:61/173

7-Operations Stream Generator

7.13Stream Generator

7.13.1 Introduction

This Operation calculates the composition of a fluid by entering a Split coefficient for each
component.
It is defined in the Block Properties window.
The split coefficient is expressed as the percent quantity of each component to be transferred to the
output..
The Phases Stream is output by a Stream Generator block.

7.13.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Split coefficient per component expressing the percentage of the component which must
be affected to the "Spec" fluid.
A Stream Generator has no Feed
It is assumed that all the components defined in the .xls data file are present with an amount of
100 moles each. The split factors are applied to these mole numbers to generate a newx
composition

7.13.3 Results

Stream Generator is necessarily one-phase (undetermined). The result is:

a quantity of a fluid named "Stream"
the composition of "Stream" fluid
the properties of this fluid, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file

Remark on the generation of fluid compositions:

As Stream Generator does not take care of the material balance, it is possible to generate, from a
unique .xls file, as many different fluid compositions as desired by performing a Stream Generator
for each fluid generated.

Best - Version. 11.0 Page:62/173

7-Operations CVD

7.14CVD

7.14.1 Introduction

This Operation calculates the depletion at a constant volume.

Using a reference fluid that defines a volume, the operation determines what quantity of vapor must
be removed from the reference fluid to preserve the initial volume when the temperature and
pressure are modified.
It is defined in the Block Properties window.

Remark:
The reader must note that this operation requires, even if this is not tested, the definition of a single
block for the feeding of the CVD operation.
This single block will ensure that the reference volume, calculated by suming the volumes of the
CVD block feed, can effectively be calculated (this is the case if all the feeds are coming from a
single block, because the Pressure and tTemperature are the same).
This reference volume is then used to calculate whiche quantity of vapor it is necessary to remove
to keep the total volume of the CVB block (calculated at the T and P of the CVD) equal to the
reference volume (calculated at the T and P of the feeding block).

7.14.2 Scheme

Best - Version. 11.0 Page:63/173

7-Operations CVD
7.14.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
Number of moles of salt
and
the Fluids defining the feed

7.14.4 Results

a quantity of vapor adjusted so as to respect the specification of the volume implicitly

supplied by the block feed
a quantity of liquid
the composition of the vapor
the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file
The resulting quantities of gas and liquid determine the quantity of vapor that must be removed to
remain consistent with the reference volume.

The reader should note that if the CVD block produces no vapor, it will be plotted in red and
will be assigned an error code of –2.

Best - Version. 11.0 Page:64/173

7-Operations Isochor

7.15Isochor

7.15.1 Introduction

This Operation calculates the pressure corresponding to an Isochor operation.

It is defined in the Block Properties window.

The pressure P calculated is the one which fits the equation:

VT(1-α(Pini-P)) - Vs = 0
where VT is the total volume (Liquid + Vapor) calculated at P

7.15.2 Scheme

7.15.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature: T
Specified volume: Vs
Initial pressure: Pini
Pressure coefficient: α
and
the Fluids defining the feed

Best - Version. 11.0 Page:65/173

7-Operations Isochor
7.15.4 Results

a quantity of vapor
a quantity of liquid
the composition of the vapor
the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.
The pressure P output is that which fits the equation above.

Best - Version. 11.0 Page:66/173

7-Operations Set Flash

7.16Set Flash

7.16.1 Introduction

This Operation calculates the properties of a fluid for a set physical state, liquid or vapor.
It is defined in the Block Properties window.

7.16.2 Scheme

7.16.3 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
The vapor fraction which can only be equal to 0 (any liquid) or 1 (any vapor)
and
the Fluids defining the feed

7.16.4 Results

When the flash is set, it is inevitably single phase and the result is therefore:
a quantity of vapor (or a quantity of liquid)
the composition of the vapor (or the liquid) which is, moreover, the same as that of the
feed
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file
Best - Version. 11.0 Page:67/173
7-Operations Set Flash

Best - Version. 11.0 Page:68/173

7-Operations Genese

7.17Genese

7.17.1 Introduction

This Operation generates a fluid in the Evapex HC Generation sense.

It is defined in the Block Properties window.
It requires no fluids at input and outputs 9 fluids.

7.17.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
The oil generating Potential
The % Type I source rock
The % Type II source rock
The % Type III source rock
The source rock density
The % minimum transformation rate of expulsion
The temperature
The Pressure
The % net source rock
A table of definitions giving the thickness of the source rocks and the accumulation of
surfaces at the top
7.17.2.1.1.1 Remark on required data:
To ensure the proper calculation of this type of block (i.e. with specific processing of water and
certain components) the Fluids file must contain the Artep at least the following components and
their codes.
These codes are used to define the following components:
CH4 methane 1000
C2H6 ethane 2000
C3H8 propane 3000
C4 Cut C4 -4000
C5 Cut C5 -5000
C6-10 Cut C6 to C10 -6000
C11-13 Cut C11 to C13 -11000
C14-24 Cut C14 to C24 -14000
C25-49 Cut C25 to C49 -25000
C50+ Cut C50 and more -50000

The HC Generation block creates matter using the above components. It is therefore essential that:
They be identifiable and that is the purpose of the Artep codes
They be always present in the external feeds of the flow sheet, as if the HC Generation block
can modify their quantity, they must all be present in the fluid.

Best - Version. 11.0 Page:69/173

7-Operations Genese
7.17.3 Results

The results of this operation are defined in the results Template associated with it in the
Operations sheet of the PLUG.XLS file

The following is provided for each of the fluids output:

molar flowrates for each component,
total number of moles
total mass
molecular weight

Best - Version. 11.0 Page:70/173

7-Operations Migration

7.18Migration

7.18.1 Introduction

This Operation involves the calculation of a migration in the Evapex sense. It is defined in the
Block Properties window.
It requires 9 fluids at input and generates 9 fluids at output.
Each of the input streams is flashed and the produced liquid and vapor volumes are calculated.
The vapor produced for each fluid is trapped (the fluids are processed sequentially) in the migration
zone up to a total volume equal to 0.4 times the input migration surface.
The remaining vapor and liquid produced (sequentially for each fluid) are then trapped (vapor and
then liquid in fluid 1, then vapor and then liquid in fluid 2, etc.) in a so-called hydrocarbon retention
volume, up to a total volume equal to the migration coefficient multiplied by the
drainage surface.

7.18.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
Drainage surface (in km2)
Migration coefficient
and
the 9 Fluids defining the feed

Remark: the 9 fluids provided as input for this operation must be either all external or all
internal (output by other Operations). It is not possible to use a combination of external and internal
fluids.

7.18.3 Results

The results of this operation are defined in the results Template associated with it in the
Operations sheet of the PLUG.XLS file

The following information is provided for each of the 9 fluids output:

molar flowrates per component
total number of moles
total mass
molecular weight

The feed in the block is also provided in the form of the same properties as above, but for the total
of all 9 fluids provided at input.

Best - Version. 11.0 Page:71/173

7-Operations Piege

7.19Piege

7.19.1 Introduction

This Operation calculates a trap in the Evapex sense.

It is defined in the Block Properties window.
It requires 9 fluids at input and generates 20 fluids at output.

9 fluids, associated to the 9 input fluids, corresponding to the part of the input fluids that
leaks out of the bottom of the trap
9 fluids, associated with 9 input fluids, corresponding to the part of the input fluids that
spills over the top of the trap
2 fluids corresponding to quantities of liquid and vapor that remain in the trap.
The input streams are processed in the REVERSE ORDER OF THEIR FEED DEFINITION.
For input each fluid, and depending on the input data, the following process is run:
Fluid mixture with contents of trap
Flash of resulting fluid
Calculation of volumes of vapor and liquid produces
Calculation of corresponding heights in trap
For each fluid, the calculations are executed as per the pseudo-code given below:
(the character formats help identify the data provided and the calculated values).
If Equivalent Height >= Closure Height
| Closure is good
| The trap does not spill over the top
| The trap may leak out from the bottom
| If the height of vapor is > Closure height
| | The trap is full of vapor
| | The excess vapor and all the liquid leak out from the bottom
| Else
| | All the vapor is in the trap
| | If the height of the liquid > Closure height – height of vapor
| | | All of the vapor is in the trap
| | | The trap is full
| | | The excess liquid leaks out from the bottom
| | Else
| | | All of the vapor is in the trap
| | | All of the liquid is in the trap
| | | The trap is not full
| | Endif
| Endif
Else
| The caprock is poor
| Vapor may escape from the top
| Liquid may leak out from the bottom or top.
Best - Version. 11.0 Page:72/173
7-Operations Piege
| If the liquid height is > Equivalent height
| | The trap contains only liquid, all the vapor has escaped from the top
| | If Liquid Equivalent height < Closure height
| | | Poor cap rock for the liquid
| | | If there is too much liquid it will spill over the top
| | | If the Liquid height < Liquid Equivalent height
| | | | The trap is not full
| | | | All the vapor escapes from the top
| | | | All the liquid is in the trap
| | | Else
| | | | The trap is full of liquid up to the liquid equivalent height
| | | | There is too much liquid, all the vapor escapes from the top
| | | Endif
| | Else
| | | Good caprock for liquid
| | | Liquid spills out of base if in excess
| | | If height of liquid < Closure height
| | | | The trap is not full
| | | | All the vapor escapes from the top
| | | | All the liquid is in the trap
| | | Else
| | | | The trap is full of liquid
| | | | All the vapor escapes from the top
| | | | The excess liquid spills out of the base
| | | Endif
| | Endif
| Else
| | All the liquid is in the trap
| | If vapor height > equivalent height – liquid height
| | | All the liquid is in the trap
| | | The trap is full up to the equivalent height
| | | Excess vapor escapes from the top
| | Else
| | | All the liquid is in the trap
| | | All the vapor is in the trap
| | | The trap is not full
| | Endif
| Endif
Endif

Best - Version. 11.0 Page:73/173

7-Operations Piege
7.19.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
Equivalent height
Closure height
Liquid equivalent height
A table defining the vapor volume and liquid volume curves as a function of depth (z
increases downwards with a maximum of 20 data points).
and
the 9 Fluids defining the feed

Remark: the 9 Fluids provided as input for this operation must be either all external or all
internal (output by other Operations). It is not possible to use a combination of external and internal
fluids.

7.19.3 Results

The results of this operation are defined in the results Template associated with it in the
Operations sheet of the PLUG.XLS file.

For each of the fluids output, the following data is provided:

Molar flowrates per component,
Total number of moles
Total mass
Molecular weight
These fluids are categorized as:
9 fluids corresponding to spill-over from the top and named Htr1 to Htr9 , (their
physical state can be determined by a subsequent flash)
9 fluids corresponding to leaks from the base and named Btr1 to Btr9 (their physical
state can be determined by a subsequent flash)
3 fluids named Feed, Liquid and Vapor which correspond respectively to the fluid in
the trap and to the two phases liquid and vapor that compose it (liquid and vapor are the
results of a flash, at trap conditions, on feed).

Remark: As indicated above, Feed, Liquid and Vapor do not correspond to the sum of
the fluids entering the trap but rather to what remains once the calculation is performed.

Best - Version. 11.0 Page:74/173

7-Operations Hydrates formation Temperature

7.20Hydrates formation Temperature

7.20.1 Introduction

This Operation is a calculation of the temperature at which gas Hydrates may appear..
It is defined in the Block Properties window.

7.20.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
and
the Fluids defining the feed

7.20.3 Results

The required Temperature and:

a quantity of vapor
a quantity of liquid
the composition of the vapor
the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.

Best - Version. 11.0 Page:75/173

7-Operations Hydrates formation Pressure

7.21Hydrates formation Pressure

7.21.1 Introduction

This Operation is a calculation of the pressure at which gas Hydrates may appear..
It is defined in the Block Properties window.

7.21.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
and
the Fluids defining the feed

7.21.3 Results

The required pressure and:

a quantity of vapor
a quantity of liquid
the composition of the vapor
the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.

Best - Version. 11.0 Page:76/173

7-Operations Variable

7.22Variable

7.22.1 Introduction

This Operation makes it possible either to calculate a value (in particular using the Formula
interpreter) or to re-use it, by referencing it for example, in one or more other Blocks.
It is defined in the Block Properties window.

7.22.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file and consist only in the value of the variable block.
It can be assigned directly a numerical value or a result using a Formula.

7.22.3 Results

The value defined by the formula is calculated and can be used in another block by using the
syntax: Value (Block) where Block is the name of the variable-type block.

It is highly important to note that when Retrieving the results in Excel by DDE,
Formula(Block)must be used where Block is the name of the variable-type block.

Best - Version. 11.0 Page:77/173

7-Operations Controller

7.23Controller

7.23.1 Introduction

Like the Optimizer, this Operation is used to set up matches or optimizations.

It uses a set of Optimization parameters defined by the user and attempts to reproduce the selected
Specifications.

7.23.2 Data

They are input in the Optimization parameters window and in the Specifications.

7.23.3 Results

The user must exercise caution and method when analysing the results, which appear in the
controller window itself.

Remark:
The difference between the controller and the optimizer is that the controller is an operation which
may itself be included in an optimization or a Versus Time.

Best - Version. 11.0 Page:78/173

7-Operations Phase envelope points

7.24Phase envelope points

7.24.1 Introduction

This Operation is a calculation of specific phase envelope points:

 Critical point
 Cricodentherm
 Cricodenbar
It is defined in the Block Properties window.

7.24.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Pressure
Vapor Fraction
Calculation Step
Minimum Pressure
Maximum Pressure
and
the Fluids defining the feed

7.24.3 Results

The results of a flash performed on the feed at the given P and T, that is:
 a quantity of vapor
 a quantity of liquid
 the composition of the vapor
 the composition of the liquid
the properties of these phases, as defined in the results Template associated with this
operation in the Operations sheet of the PLUG.XLS file.
the Critical Pressure if the critical point has been found
the Critical Temperature if the critical point has been found
the Cricodentherm Pressure if this point has been found
the Cricodentherm Temperature if this point has been found
the Cricodenbar Pressure if this point has been found
the Cricodenbar Temperature if this point has been found

Best - Version. 11.0 Page:79/173

7-Operations MMP points

7.25MMP points

7.25.1 Introduction

This Operation is a calculation of MMP values, it calculates the same values than the MMP
calculation but within a box and the calculated values can then be accessed using the Properties
listing window.
It is defined in the Block Properties window.

7.25.2 Data

The data are defined in the Parameters file associated with this operation in the Operations
sheet of the PLUG.XLS file. They are:
Temperature
Cells number
MMP First contat
MMP Vaporizing Gas Drive
MMP Condensing Gas Drive
MMP Vaporizing Gas Drive (Negative Flash)
MMP Condensing Gas Drive (Negative Flash)
MMP Combined
and
the Fluids defining the feed which must be:
 one and only one liquid
 one and only one vapour

Remark:
All the MMP described above will only be calculated if their initial value in the box is set greater
than 0 (>0).

7.25.3 Results

The results are the same than the ones of the MMP calculation.
See the Remark above

Best - Version. 11.0 Page:80/173

7-Operations Black Oil

7.26Black Oil

7.26.1 Introduction to BO

This Operation calculates a liquid or vapor BO.

It is executed by selecting the Black Oil submenu in the Calculations menu.
It calculates a Liquid BO or Vapor BO using User supplied data, or more easily by choosing the
possibilities for an Automatic Liquid BO or and Automatic Vapor BO.
The Results are then generated as a function of the choice made: Liquid BO or Vapor BO.

7.26.1.1 Liquid BO

Liquid Bo
G
H
G
Psat H

P1<Psat H G

P2<P1
H
P3<P2

Gas
G
collector
G
H T=15 C
G Oil
H atmospheric Process Group
H flash

P=1 bar

7.26.1.2 Vapor BO

Best - Version. 11.0 Page:81/173

7-Operations Black Oil
Process Group

Gp
V
G G Gp
V
Psat
H
G Gp
V
P1<Psat H G
V
P2<P1
H
P3<P2

Gas
G
collector
G
H T=15 C
G Oil
H atmospheric Process Group
H flash
Vapor Bo
P=1 bar

Best - Version. 11.0 Page:82/173

7-Operations Black Oil

7.26.2 Data

Calculated Steps Above Psat

Bo Psat

Given
P1
Pressures

P2

P3

P4

Steps below Psat

Pressure

Black Oil pressures setting

7.26.2.1 Data input by the user

The data provided for the calculation are represented in the diagrams above. They are:
A list of pressures (P1 to P4 on the diagram), the saturation pressure is automatically
calculated by the program
A list of increments above Psat that are calculated when the pressures > Psat are
provided
A list of increments below Psat for pressure provided below Psat if the user has defined
any.(these values are needed only for the Liquid Black Oil calculation)
The definition of the process Group
The name of the atmospheric Flash of the oil
The name of the gas drum flash

7.26.2.2 Automatic Liquid BO

When the user requests automatic generation of the calculation, the following options are used:
The step is calculated by taking one twentieth of the difference between the bubble
pressure of the initial flash and the pressure of the first element in the process group, i.e.:
Step = (Psat – (Pmax+10)) / 20.
20 pressure values (Pi) are generated using this step (including the saturation pressure
itself). They correspond to pressures named "Pressures provided" in the diagram that
defines the Data.

Best - Version. 11.0 Page:83/173

7-Operations Black Oil
Pressures above Psat are generated as 4 values following a 25 bars steps and being so,
25, 50, 75 and 100 bars
Pressures below Psat are generated as the following values: Pi+10, Pi+30, Pi+50, Pi+100
(for each of the 20 pressures Pi defined above).

7.26.2.3 Automatic Vapor BO

Calculated Steps Above Psat

Bo Psat

Given
P1
Pressures

P2

P3

P4

Dot lines repr esent the

automatically gener ated
pressures grid
Pressure

Vapor Black Oil pressures setting

When the user requests automatic generation of the calculation, the following options are used:
The CVD step is calculated by taking as one twentieth of the difference between the
bubble pressure of the initial flash and the pressure of the first element in the process
group, i.e.: Step = (Psat – (Pmax+10)) / 20.
20 pressure values (Pi) are generated using this step (including the saturation pressure
itself). They correspond to pressures named "Pressures provided" in the diagram that
defines the Data.
Pressures above Psat are generated as 4 values following a 25 bars steps and being so,
25, 50, 75 and 100 bars
Pressures below Psat are automatically generated as shown on the diagram above (the
green points). They are, the Pressure above Psat and, for each CVD step, the pressures of
the previous steps are added.

7.26.3 Results

7.26.3.1 Liquid BO
Rs, BO and viscosity are calculated at each pressure for the oil phase.
Bg and viscosity are calculated for the gas phase.

Best - Version. 11.0 Page:84/173

7-Operations Black Oil
Tbottom
Pbottom Tsurface
Psurface
Bottom Surface BOV
Bo=
Gas Gas SOV
Volume Volume
GasVol
from GVSO
Rs=
Bottom Surface SOV
Oil Oil
Volume BGV
Surface Bg=
Oil SGV
Volume

7.26.3.2 Vapor BO
Rs, viscosity and liquid deposit are calculated at each pressure for the oil phase.
Rv, B'g, Bg and viscosity are calculated for the gas phase.
Tbottom BOV
Surface Tsurface Bo=
Pbottom
Gas Psurface SOV
Bottom Volume
Gas produced OVSG
Rv=
Volume Oil Vol SGVp
from
GasVol BGV
Bottom Surface Bg=
Oil Gas from SGV °
Volume Surface
Oil BGV
B'g=
SGVp
Surface
Oil
Volume

SGV°= Surface Gas Volume calculated with Z=1 and so V=nRT/P

Remark:
It is very important to note that the values calculated for BlackOils cannot be retrieved in a BEST
Formula.
They can however be copied.

Best - Version. 11.0 Page:85/173

7-Operations Multi depth

7.27Multi depth

7.27.1 Introduction

This Operation produces a sequence of several Ger calculations.

It is accessible for any block, from the Block Properties window.
When used it opens of the Multi Depth window

7.27.2 Data

The fluid feeding the block in which the multi-depth is invoked is used as the feed in the
operation.
The reference Depth is that at which the feed is defined (depths are negative going down).
The minimum depth is the deepest depth (depths are negative going down).
The maximum depth is the shallowest depth (depths are negative going down).
The step defines the number of calculations that will be performed between the minimum and
the maximum depths.
The temperature gradient defines the temperature variation (in degrees C per 100 metres) to be
applied between the minimum and maximum depths.

7.27.3 Results

The following is calculated at each depth, at the defined step, between the minimum and maximum
depths:
Pressure
Bubble pressure
Temperature
Fluid composition.

Moreover, a graph representing the bubble pressure as a function of depth is output. It is used,
amongst other things, to easily determine the location of the one-two phase boundary.

Remark:
It is important to note that the values calculated by this operation cannot be retrieved in a BEST
Formula.
However, they can be copied.

Best - Version. 11.0 Page:86/173

7-Operations Phase envelope

7.28Phase envelope

7.28.1 Introduction

This Operation determines the curve defining the limit between the two-phase and single-phase
regions of a Fluid.

7.28.2 Data

This operation can be accessed from the Block Properties window and requires no particular data
input.
When used it opens the Phase Envelope window.

7.28.3 Results

The results are output as points on a curve and the temperature and pressure of the critical point if it
has been determined.

Remark:
It is important to note that the values calculated by this operation cannot be retrieved in a BEST
Formula.
However, they can be copied.

Best - Version. 11.0 Page:87/173

7-Operations Multi Case

7.29Multi Case

7.29.1 Introduction

This Operation processes the same flow sheet several times, changing a certain number of block
operating parameters at each run.
It is executed by opening the Multi Case submenu under the Calculations menu, which opens the
Multi Case window.

7.29.2 Data

For each run, the data are input through a specific, external Multi Case Excel data file.

7.29.3 Results

The results are output for each case run, in a specific window in the Display Area of the Main
Window.
Each window contains the same original flow sheet on which the multi-case was applied, but with
different calculation conditions.

Best - Version. 11.0 Page:88/173

7-Operations MMP

7.30MMP

7.30.1 Introduction

This Operation calculates minimum miscibility pressures.

It is executed by the MMP submenu of the Calculations menu, which opens an MMP window.
Gas injection is the technique most widely used today to improve the crude oil recovery ratio.
Three types of minimum miscibility pressures can be calculated:
Minimum First Contact Miscibility Pressure (FCMP) is the smallest direct miscibility pressure.
Its calculation corresponds to the maximum saturation pressure obtained, at a given
temperature, when oil and gas are mixed at any given proportion.
Contact MMP is calculated by a dynamic single-cell mechanism. For years, it was believed that
it was possible to calculate the MMP by putting oil and gas in contact successively in a single
cell, using a forward or backward mechanism. The value thus obtained was, in fact, valid only
for ternary mixtures. With real crudes, the MMP calculated by such a single cell algorithm is
always higher than that calculated using the multi-cell algorithm.
The MMP calculated from results produced by a multi-cell algorithm is comparable to that
obtained experimentally in a slim tube. It corresponds to a combined back and forth
mechanism, developed by A.Zick of Arco OilôGaz Co. and demonstrates that this is the
mechanism that develops preferentially in real crude oils.
Light

Dew Line
G

Diphasic
Domain
Critical equilibrium line

Critical Point

L
Heavy Medium
Bubble Line

If crude oil is represented by a set of three components (1 light, 1 intermediate and 1 heavy) this
rough approximation makes it possible to easily represent the different miscibility mechanisms.

Knowing that in such a representation, the envelope of the two-phase domain decreases as pressure
increases, the FCMP corresponds to the lowest pressure, at a set temperature, at which the segment
L°-G° (where L° represents the oil composition and G° represents the gas composition) is tangent to
the envelope of the two-phase domain.
The representation pressure is the FCMP.
The contact miscibility or contact MMP corresponds to the pressure at which the fluid is
transformed into a homogeneous phase following multiple successive compositional exchanges
between oil and gas.

Best - Version. 11.0 Page:89/173

7-Operations MMP
It must be considered in terms of forward miscibility (vaporizing gas drive) or backward miscibility
(condensing gas drive).
Forward contact MMP corresponds to the case where the L° oil is richer in intermediate
components than the oil which would
Light be at equilibrium with the gas G° gas.
The G° gas therefore becomes richer
in intermediate components.
Dew Line
Go If a tangent to the dewpoint curve can
be drawn passing through L°, total
miscibility is obtained. If not, it is
only partial insofar as an equilibrium
Diphasic line linking L° and the enriched gas
Domain will be reached and cannot be
crossed.
The backward contact MMP
Critical Point corresponds to the case where G° gas
Lo is rich in intermediate components
Heavy
Bubble Line
Medium and transfers them to the L° oil which
thereby becomes richer in these
components.
If a tangent to the dewpoint curve can be drawn passing through G°, total miscibility is obtained. If
not, it is only partial insofar as an equilibrium line linking G° and the enriched oil will be reached
and cannot be crossed.

In the case of total miscibility, contact MMP is by definition, the pressure at which the critical
equilibrium line passes through the point representing the L° oil for a forward mechanism
(vaporising gas drive) and passes through the point representing the G° gas for a backward
mechanism (condensing gas drive).
A. Zick’s hypothesis corresponds to case in a real reservoir with a forward-backward mechanism.
This is the mechanism that determines the True multi-contact multi-cell MMP.
It corresponds to a bi-lateral exchange between the oil and the injection gas.
The first contact between the oil and gas are backward type, but are then transformed into forward
type contacts when the oil is saturated in intermediate components. The fresh gas that is injected
will then take from the oil (oils, in fact, as the composition varies in the injection domain) the mean
intermediates and will ultimately become miscible with the oil.
This phenomenon is obviously cannot be represented on a ternary diagram.
The MMP Operation is used to determine these three types of miscibility pressures.

7.30.2 Data

The oil fluid

The gas fluid
The calculation temperature
The number of cells (only used for a “combined” MMP )
The types of MMP to calculate

7.30.3 Results

The MMP values requested

Best - Version. 11.0 Page:90/173
7-Operations MMP

Remark:
The MMP operation always calculates the FCMP.

Best - Version. 11.0 Page:91/173

7-Operations Versus Time

7.31Versus Time

7.31.1 Introduction

This Operation is executed using the Versus Time submenu under the Calculations menu, which
opens the Versus Time window.
It copies the group G1 and automatically calculated the copy n times (from G2 to Gn), preserving
the structure of the fluid links, explicitly defined once, between a reference group G and the group
G1.
The group G1 is usually a modified copy of the group G.
The maximum number of main copies (for which results are accessible) is set to 20. The number of
copies desired is entered in the Versus Time dialog box.
The parameters and variables that evolve with each copy of G1 are indicated in the Versus Time
calculation sheet whose name is entered in the Versus Time dialog box.
Intermediate calculation steps, which do not result in effective copies, can be performed between
two main steps. During the intermediate steps, variable properties in the external file are
extrapolated linearly between the two main steps encompassing them. The number of intermediate
steps desired is entered in the Versus Time dialog box.
If intermediate calculations are performed, it is not possible to recalculate the simulation sheet
without going back to the Versus Time option. The results of intermediate calculations are not
accessible.
All references to group G in group G1 (stream, parameters, variables, etc.) are automatically
incremented with respect to the rank of the group presently in the copy calculation. This can lead to
recursive references that are not correctly calculated in intermediate steps.
The external file can be omitted when the only changes that occur between copies are induced by
the structure of the links.

7.31.2 Data

The start group G,

The end group G1,
The number of main steps,
The number of intermediate steps,
The Versus Time calculation sheet

7.31.3 Results

All usual properties calculated in the blocks.

Best - Version. 11.0 Page:92/173

7-Operations Optimizer

7.32Optimizer

7.32.1 Introduction

This Operation is used to execute matches or optimizations.

It uses a set of Optimization parameters defined by the user and attempts to reproduce the selected
Specifications.

7.32.2 Data

The data are input in the Optimization parameters window and in the Specifications window.

7.32.3 Results

The results are clearly displayed in the Optimization echo window. The user must exercise caution
and method when analysing them.

Best - Version. 11.0 Page:93/173

8-Utilisation Introduction

8 Utilisation

8.1 Introduction
This chapter details the basic operations involved in using BEST.
It comprises the following sections:
Creating a new session
Creating a block
Definition of block properties
Definition of flow sheet topology
Initialization of a flow sheet
Calculation of a flow sheet
Creation of a group
Retrieving results in Excel
Definition of calculation parameters in Excel
Automating calculations using Excel

Best - Version. 11.0 Page:94/173

8-Utilisation Creating a new session

8.2 Creating a new session

8.2.1 Introduction

The creation of a new session is the first action performed when using BEST.
Note that this action is not mandatory when opening BEST insofar as a new session is created by
default.

8.2.2 Methodology

Two methods can be used to create a new session and therefore open a new window in the Display
area of the Main window:

Using the New submenu under the File Menu,

or
Using the New icon on the Toolbar in the Main window
When this window is created (or at least, when it is open) the task Create a block is the first step to
setting up a new flow sheet.

Best - Version. 11.0 Page:95/173

8-Utilisation Creating a block

8.3 Creating a block

8.3.1 Introduction

This is the first action to carry out once you have Created a new session or when a window is open
in the Display area of the Main window
For optimal results, you must remember that BEST uses several types of blocks:
Conventional Thermodynamic operations blocks.
Controller blocks

8.3.2 Thermodynamic operations

These blocks the ones used most often in BEST.

They are created using:
the rectangle tool on the Toolbar in the Main window
or
the Rectangle submenu under the Draw Menu
When this tool is selected, use the mouse (the mouse cursor turns into a cross-hair) to create a block
in the active window of the the Display area. Draw the block by clicking with the left mouse button
on one point (which will be the upper left-hand corner of the block) and dragging the mouse to
another point (which will be the lower right-hand corner of the block).
When this operation is terminated, a gray rectangle is displayed in the active window.
It is now necessary to change tools:
click the Select tool in the Toolbar in the Main window or
use the Select submenu under the Draw Menu
Once this tool is selected (the mouse cursor becomes an arrow), double click with the right mouse
button on the existing block to open the Block Properties window and move on to Define block
properties .

8.3.3 Controllers

These types of blocks are created the same way as Thermodynamic operations blocks, except that
the drawing tool selected in the first phase is:
the Diamond tool on the Toolbar in the Main window or
the Diamond submenu under the Draw Menu.

Best - Version. 11.0 Page:96/173

8-Utilisation Defining block properties

8.4 Defining block properties

8.4.1 Introduction

This action can be performed immediately following the Create block action or when a flow sheet
with at least one Block is open.
It involves:
Opening a window in the block properties
Defining block properties

8.4.2 Opening a window

A Block Properties window can be opened two ways:

by selecting a block with the left mouse click and then going to the Properties submenu of the
Edit Menu or
by double-clicking with the left mouse button on a Block.
Note that to carry out these operations the mouse cursor must be shaped as an arrow. If this is not
the case, you must perform the following steps:
click the Select tool in the Toolbar in the Main window or
use the Select submenu under the Draw Menu

8.4.3 Defining properties

Each type of block requires the definition of different properties that depend on the choice made in
the identification field of the Block Properties window:
There properties are:
The block operation parameters
The feeds that will allow to Define the flow sheet topology to which the blocks belong
The External streams that can complete the feeds from other blocks in the flow sheet.

Best - Version. 11.0 Page:97/173

8-Utilisation Defining flow sheet topology

8.5 Defining flow sheet topology

8.5.1 Presentation

This action is carried out explicitly and properly by the definition of block feeds, which can be:
feeds from other blocks in the flow sheet or
External streams available in external fluid files:

The topology is displayed in the

active window of the Display area.
of the BEST Main window in the
form illustrated on the left.
Note that in this representation, the
color and position of the inter-
block links are defined and
modifiable in the PLUG.XLS file.

Best - Version. 11.0 Page:98/173

8-Utilisation Initialization of a flow sheet

8.6 Initialization of a flow sheet

8.6.1 Presentation

This action is carried out using:

click the Initialize tool in the Toolbar in the Main window or
use the Initialize submenu under the Calculations menu
This submenu (or corresponding tool) can only be used if and when no prior calculation has been
performed.
However, it is important to note that using this submenu (or corresponding tool) resets the cuts
properties and erases all modifications that may have been applied to them, after matching or
manually (in the Cuts properties window) for example
Similarly, if a session has been previously saved and reloaded, it is not compulsory to use this
submenu (or corresponding tool) but if it is used it will reset all external streams to the default
values in the Fluids file.

Best - Version. 11.0 Page:99/173

8-Utilisation Calculating a flow sheet

8.7 Calculating a flow sheet

8.7.1 Presentation

This action is performed using:

click the Calculate tool in the Toolbar in the Main window or
use the Calculate submenu under the Calculations menu
It executes the calculation of the defined flow sheet.
When the calculation is performed, the Block colors change, indicating their status.

Best - Version. 11.0 Page:100/173

8-Utilisation Creating a group

8.8 Creating a group

8.8.1 Introduction

Groups can be created when there are several Blocks in the active flow sheet. It is also possible with
a single block, but this is of little interest.
Groups must be created if you want to perform certain Operations (such as a Black Oil) which
involve groups.
Groups are created by:
Selecting several blocks,
Creating the group.

8.8.2 Selecting

To select several blocks, the mouse pointer must be arrow-shaped. If this is not the case, you must
perform the following steps:
click the Select tool in the Toolbar in the Main window or
use the Select submenu under the Draw Menu
Multi-selection can then be carried out in two different ways:
By dragging a frame around the blocks: click with the left mouse button and keeping the
button down, drag the mouse around the blocks you wish to select.
Performing a multiple selection by clicking successively on each block with the left mouse
button while holding down the Shift key.
Once the blocks are selected, you can Create a Group.

Best - Version. 11.0 Page:101/173

8-Utilisation Creating a group

8.8.3 Creation

After Selecting several blocks, the group is created using the Group submenu under the Object
Menu.
This submenu displays a dialogue box to enter the name of the group to be created.
Click on OK once this is done; the window closes and the group is created.
The group is represented by a blue block positioned over the location of the blocks it comprises.

Best - Version. 11.0 Page:102/173

8-Utilisation Creating a group

It can be edited to check and examine its contents. To do this, double click with the left mouse
button.
A group can also be “ungrouped” using the by double clicking on the “Ungroup” button. The
blocks composing a group are then repositioned on the flow sheet.

Best - Version. 11.0 Page:103/173

8-Utilisation Retrieving data in Excel

8.9 Retrieving data in Excel

8.9.1 Introduction

Data retrieval from Excel is one of BEST’s powerful functions. It makes it possible to use the
output data for all types of post-processing as well as to draw graphs, etc.
To a greater degree, it is also possible to use these functions in conjunction with Definition of
calculation parameters in Excel to use Excel for both retrieval of results and to define calculation
parameters.

8.9.2 Implementation

Retrieving of results in Excel is carried out using Windows DDE functions.

These functions were designed to be easily accessible in BEST through the Properties listing
window.
This window supports Drag and Drop to any other Windows application, and therefore allows
results to be Dragged and Dropped into Excel.
To do this, just select the desired value using a left mouse click and, while holding the left mouse
button down, drag the mouse to the desired Excel cell. Releasing the mouse button “Drops” the
selected value into the active Excel cell.

Note that the values are automatically updated when calculations are performed by BEST.
However, it is necessary to check that updating of values referenced outside the program is
activated.
In Microsoft Excel, this option is activated as follows:
Tools Menu
Options Menu
Calculations tab
Tick the “Update references outside of program” box

Best - Version. 11.0 Page:104/173

8-Utilisation Defining calculation parameters in Excel

8.10Defining calculation parameters in Excel

8.10.1 Introduction

The possibility of defining parameters in Excel is one of BEST’s powerful functions. It makes it
possible to perform all types of post-processing.
To a greater degree, it is also possible to use these functions in conjunction with Retrieve
Calculation Parameters in Excel for both retrieval of results and to define calculation parameters.

8.10.2 Implementation

Parameters are defined in Excel is using Windows DDE functions.

The syntax to use is in the section on defining Block calculation parameters, in the chapter on
BEST Data.

Best - Version. 11.0 Page:105/173

8-Utilisation Automating calculations using Excel

8.11Automating calculations using Excel

8.11.1 Introduction

The automation of calculations with Excel allows us to consider BEST as a calculation engine and
to define all calculation parameters, including the flow sheet, by DDE calls from Excel.

8.11.2 Implementation

The implementation of these functions is described below but it can also be found in the file
ModuleMacroBest.Xls and related macro commands, delivered with the software.
Two types of functions are to be taken into account:
Standard DDE Functions
Specific Functions

8.11.2.1 Standard DDE Functions

These functions are described in the MicroSoft product documentation and are discussed briefly
below.
8.11.2.1.1 DDEInitiate

This function opens a DDE channel to an application

Its syntax is:
ChannelNumber = Application.DDEInitiate (app:= software,topic:= subject)
In our case, this gives:
Software="Thermo"
Subject = Name of target window in BEST.
8.11.2.1.2 DDETerminate

A channel, open by DDEInitiate is closed by DDETerminate.

Its syntax is:
Application.DDETerminate ChannelNumber
8.11.2.1.3 DDEPoke

DDEPoke performs an assignment.

Its syntax is:
Application.DDEPoke ChannelNumber, String, Value
In which:
String is a character string that can be interpreted by BEST
Value is a value to assign to a variable defined by the string
It is therefore important to note that the contents of the String corresponds to all formulas that can
be generated by Dragging and Dropping from a Properties listing window as well as:
Alpha(Target , Phase , Source) to represent a quantity of the Phase issued from the Source and
going to the Target
Kij(comp1 , comp2) to represent the binary interaction parameter between comp1 and comp2.
8.11.2.1.4 DDERequest

Best - Version. 11.0 Page:106/173

8-Utilisation Automating calculations using Excel
DDERequest makes it possible to assign a request.
Its syntax is:
Application.DDERequest (ChannelNumber, String)
In which:
String is a character string that can be interpreted by BEST

8.11.2.2 Specific functions

Six functions are currently available:
CreateObject
DeleteObject
CreateLink
DeleteLink
Initialize
Run
New
Set Value
8.11.2.2.1 CreateObject

This function is used to create a block and uses the following syntax:
Application.DDEExecute ChannelNumber, String
where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate
String: a string of characters of the form:
"[CreateObject,Name= toto ,Type= Flash,Ext= c:\Best\Blackoil.xls, Left=- 380, Right=- 280,
Top=480, Bottom= 380, Pressure= 10,Temperature= 100 ]"
in which the bold characters are keywords and the italic characters are values input by the user.
In the case below:
Name is the block to create (see identification)
Type is the type of block to create. It must correspond to an existing type (see identification)
Ext is used to define the external feed(s) of the block (see external stream (for several feeds, Ext
must be cited several times)
Left, Right, Top and Bottom define the position of the block in the BEST Display area.
Pressure and Temperature are the names of the parameters used by the type of block selected
(Flash in this case)
Other keywords that can be used in this chain are:
Keywords for defining operating parameters that are dependent on the type of block and
the names of which are available in the Input* sheets of the PLUG.XLS file.
Int that is used to define feed blocks (see feeds). The exact syntax is: Int= toto;
Liquid;0.5 to indicate that the feed block is a block named toto, in Liquid phase with a
multiplying coefficient of 0.5 (for several feeds, Int must be cited several times).
For example, the following string:
"[CreateObject,Name= tutu, Type=Flash, Int=toto;Liquid;0.5, Left=–380, Right=–280,
Top=480, Bottom= 380, Pressure= 1, Temperature= 100]"
defines a block named tutu connected to a block named toto by liquid output from toto, with a
multiplying coefficient equal to 0.5
8.11.2.2.2 DeleteObject

Best - Version. 11.0 Page:107/173

8-Utilisation Automating calculations using Excel
This function is used to delete a block and is executed with the following syntax:
Application.DDEExecute ChannelNumber, String
where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate
String: a string of characters of the form:
"[DeleteObject,Name= toto ]"
in which the bold characters are keywords and the italic characters are values input by the user.
In the case below:
Name is the name of the block to delete (see identification)
For example, the following string:
"[DeleteObject,Name= tutu ]"
deletes the block named tutu.
8.11.2.2.3 CreateLink

This function is used to create a link (through a stream) between two existing blocks. It is executed
with the syntax below:

Application.DDEExecute ChannelNumber, String

where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate
String: a string of characters of the form:
"[CreateLink,Source= toto ,Target= Flash ,Phase= Liquid ,Factor= value ]"
in which the bold characters are keywords and the italic characters are values input by the user.
In the case above:
Source is the name of the block from which the link (or stream) starts (see identification)
Target is the name of the block where the link (or stream) ends (see identification)
Phase is the name of the phase leaving Source that feeds the Target
Factor is the numerical value that multiplies the real quantity of matter transferred from Source
to Target.
For example, the string below:
"[CreateLink,Source= tutu ,Target= toto ,Phase= Liquide ,Factor =2.0 ]"
Defines a link going out of tutu into toto, composed of a Liquid phase leaving tutu, and whose
quantity of matter is equal to 2.0 times that in the liquid phase.
8.11.2.2.4 DeleteLink

This function is used to delete a link between two existing blocks. It is executed with the syntax
below:
Application.DDEExecute ChannelNumber, String
where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate
String: a string of characters of the form:
"[DeleteLink,Source= toto ,Target= Flash ,Phase= Liquid]"
in which the bold characters are keywords and the italic characters are values input by the user.

Best - Version. 11.0 Page:108/173

8-Utilisation Automating calculations using Excel
In the case below:
Source is the name of the starting block of the link (or stream) (see identification)
Target is the name of the target block of the link (or stream) (see identification)
Phase is the name of the phase going out of the Source that feeds the Target
For example, the following string:
"[DeleteLink,Source= tutu ,Target= toto ,Phase= Liquid]"
Deletes the link going out of tutu and into toto, composed of the liquid phase leaving tutu.
8.11.2.2.5 Initialize

This DDE function is used to initialize BEST. It corresponds precisely to the execution of the
Initialize button on the Toolbar (or to the Initialize submenu in the Calculations menu).
It is executed with the following syntax:
Application.DDEExecute ChannelNumber, "Initialize"
where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate.
8.11.2.2.6 Run

Corresponds exactly to the execution of the Calculate button on the Toolbar (or to the Calculate
submenu in the Calculations menu)
It is executed with the following syntax:
This DDE function executes BEST calculations.
Application.DDEExecute ChannelNumber, "Run"
where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate
8.11.2.2.7 New

Corresponds exactly to the execution of the New menu of the File Menu
It is executed with the following syntax:
This DDE function Creates a New best window within the currently running Best application..
Application.DDEExecute ChannelNumber, "New"
where:
ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate
8.11.2.2.8 SetValue

Corresponds exactly to the execution of a DDEPoke with the String and Value argument of the
DDEPoke defined as:
Application.DDEExecute ChannelNumber, "SetValue, String=Value"
In which:
String is a character string that can be interpreted by BEST
Value is a value to assign to a variable defined by the string
It is therefore important to note that the contents of the String corresponds to all formulas that can
be generated by Dragging and Dropping from a Properties listing window as well as:
Alpha(Target , Phase , Source) to represent a quantity of the Phase issued from the Source and
going to the Target
Kij(comp1 , comp2) to represent the binary interaction parameter between comp1 and comp2.
Best - Version. 11.0 Page:109/173
8-Utilisation Automating calculations using Excel

ChannelNumber: Number of the channel of the connection with BEST returned by the standard
DDE function DDEInitiate

Best - Version. 11.0 Page:110/173

9-Windows Introduction

9 Windows

9.1 Introduction
This chapter described each BEST window.
BEST contains the following windows:
Main window
Properties listing window
Block Properties
Multi Depth
Group
Controller
Cuts properties
Copy-Backup Utility
GLobal Parameters
Optimization parameters
Specifications
Optimization Echo
Black Oil
Multi Case
Mmp
Versus Time
and the Help Window

Best - Version. 11.0 Page:111/173

9-Windows Main window

9.2 Main window

9.2.1 Introduction

This window is the one lauched when BEST is launched.

It is illustrated below:

It contains the followin elements

1. Title bar
2. Menu bar
3. Toolbar
4. Display area
5. Status bar

9.2.2 Title bar

The title bar in the Main window contains:

the name of the software
the name of the Active window

9.2.3 Menu bar

The Menu bar of the Main window contains the following menus:

Best - Version. 11.0 Page:112/173

9-Windows Main window
File Menu
Edit Menu
View window
Draw Menu
Object Menu
Window menu
Data menu
Optimization menu
Calculations menu
Menu Help

9.2.4 Toolbar

The tool bar of the Main window contains the following tools:
New Cut
Open Copy
Save Paste
Select Print
Rectangle Initialize
Diamond Calculate (Run)
Help

9.2.4.1 New

This tool in the Toolbar is used to open a new, empty window. It equates to using the New submenu
under the File Menu

9.2.4.2 Open

This tool in the Toolbar is used to open an existing file. It equates to using the Open submenu under
the File Menu.

9.2.4.3 Save

This tool in the Toolbar is used to save any modifications made. It equates to using the Save
submenu under the File Menu.

9.2.4.4 Select

Best - Version. 11.0 Page:113/173

9-Windows Main window
This tool in the Toolbar is used to select and object in the drawing window. It equates to using the
Select submenu under the Draw Menu.

9.2.4.5 Rectangle

This tool in the Toolbar is used to draw a rectangular Block. It equates to using the Rectangle
submenu of the Draw Menu.

9.2.4.6 Diamond

This tool in the Toolbar is used to draw a Controller . It equates to using the Diamond submenu of
the Draw Menu.

9.2.4.7 Cut

This tool in the Toolbar is used to perform a Cut operation on one or more previously selected
objects. It equates to using the Cut submenu of the Edit Menu.

9.2.4.8 Copy

This tool in the Toolbar is used to perform a Copy operation on one or more previously selected
objects. It equates to using the Copy submenu of the Edit Menu.

9.2.4.9 Paste

This tool in the Toolbar is used to perform a Copy operation on one or more previously cut or
copied objects. It is the same as using the Paste submenu of the Edit Menu.

9.2.4.10 Print

This tool in the Toolbar is used to print the contents in the current sheet. It equates to using the Print
submenu of the File Menu.

9.2.4.11 Initialize

This tool in the Toolbar is used to initialize the calculations to be run. It equates to using the
Initialize submenu of the Calculations menu.

Best - Version. 11.0 Page:114/173

9-Windows Main window
9.2.4.12 Calculate

This tool in the Toolbar is used to execute the calculations. It is the same as using the Calculate
submenu of the Calculations menu.

9.2.4.13 Help

This tool in the Toolbar is used to call up the help file. It equates to using the Menu Help.

9.2.5 Display area

The display area in the Main window contains open windows, in particular the Active window.

9.2.5.1 Active window

Any window clicked using the left mouse button becomes the Active Window. Any operation
executed in BEST is implemented in the Active Window and only in that window.

9.2.5.2 Block colors

The blocks displayed in the Active Window may have different colors:
Light grey: the block has never been calculated.
Light green: the last calculation on the block was successful.
Dark green: the block was calculated successfully, the result is a single-phase fluid but the

Best - Version. 11.0 Page:115/173

9-Windows Main window
procedures for determining the phase type were unsuccessful. Liquid and vapor compositions were
set as equal and the vapor fraction is set to 0.5.
Red: the calculation of the operation executed by the block was unsuccessful.
The block is a Group.
Dark yellow: the block is Variable.
Blue: the block is a Split.

Finally, a block with a thick blue border indicates that it is fed by at least one external stream (see
Fluids file)

9.2.6 Status bar

The status bar of the Main window provides information on the state of the software, the actions
expected or performed, etc.

It also informs the user on the status of the keyboard switches: Scroll Lock, Num Lock, Caps Lock.

Best - Version. 11.0 Page:116/173

9-Windows Properties listing window

9.3 Properties listing window

9.3.1 Introduction

This window opens when launching BEST.

It contains all the properties accessible from BEST
windows, except:
Points of the Phase Envelope
Values calculated by a Multi Depth
Values calculated by a Black Oil
MMP values

9.3.2 Utilisation

This window makes it possible to easily initialize Drag

and Drop operations.
Any property selected in this window by clicking with
the left mouse button can, by sliding the mouse while
keeping the left mouse button pressed, be dragged to
another application window (Excel in particular, but also
any application that supports Drag and Drop) before
releasing the mouse button, which then renders the data
accessible by a DDE reference whose syntax is defined
in the chapter on Results.
In order to simplify its utilisation, this window contains a
certain number of boxes to tick which display only
certain types of properties:
Cut properties
Calculation parameters
Phase properties
Compositions
Calculated variables

Best - Version. 11.0 Page:117/173

9-Windows Block properties

9.4 Block properties

9.4.1 Introduction

This window is displayed when:

A Block is selected by double clicking with the left mouse button.
A Block is selected and then the Properties submenu of the Edit Menu is used.
It is illustrated below:

Whatever the block, it contains several zones:

1. The OK and Cancel buttons for validation/cancellation of actions performed.
2. Block identification
3. Block parameters
4. Block feeds
5. External Streams that feed the block
6. Results of calculations performed on the block
7. Specific Operations associated with the block
8. Graphic characteristics of the Block

9.4.2 OK and Cancel buttons

In the Block Properties window, these buttons are used to validate

(OK) or cancel actions performed in the window.
They are present whatever the Block type.
Best - Version. 11.0 Page:118/173
9-Windows Block properties
9.4.3 identification

This frame in the Block Properties window is used to identify a block on the basis of two items:

its name
its type

The block can obviously have any name, even if it is memo-

technical to provide information on what the block is used for, when only its name appears.
There are various types of blocks:
1. Flash,
2. Bubble pressure,
3. Retrograde and Normal dewpoint pressure,
4. Ger,
5. Three-phase water-oil-gas flash,
6. Split,
7. CVD,
8. Isochor,
9. Set Flash,
10. Variable,
each type of block requires different definition parameters.

9.4.4 parameters

Depending on the type of Block, as defined in the identification frame of the Block Properties
window:
Flash,
Bubble pressure, Dewpoint pressure,
Ger,
Three-phase water-oil-gas flash,
Split, Set Flash
CVD (Constant Volume Depletion), Isochor,
Variable,
The parameters required for
calculations implemented are
different.

Note that the Paste_a_list

button is used to directly paste a list
of parameter values.

The relations between the

parameters and the types of blocks are explicitly defined in the Inputxx sheets of the
PLUG.XLS file.

9.4.4.1 Flash
The parameters required for calculating the Flash are:
Best - Version. 11.0 Page:119/173
9-Windows Block properties
The calculation temperature
The calculation pressure

9.4.4.2 Bubble pressure

The parameters required for calculating the Bubble pressure are:
The calculation temperature
An estimation of the pressure to be found which can be entered optionally.

9.4.4.3 Dewpoint pressure

The parameters required for calculating the Retrograde and Normal Dewpoint pressure are:
The calculation temperature
An estimation of the pressure to be found can be entered optionally.

9.4.4.4 Ger
The parameters required for calculating the Ger are:
The calculation temperature
The calculation pressure
The difference in depth between the source and the target
ATTENTION: only one single phase feed must be input in the GER block

9.4.4.5 Three-phase water-oil-gas flash

The parameters required for calculating the Three-phase water-oil-gas flash are:
The calculation temperature
The calculation pressure
ATTENTION: Consult the Remarks on required data: prior to implementing this operation.

9.4.4.6 Split
The parameters required for calculating the Split are:
The calculation temperature
The calculation pressure
The separation coefficients provided for each of the components as a percentage of the
load to assign to the output vapor.
Also consult the Remark on the generation of fluid compositions: in the chapter Operation

9.4.4.7 Set flash

The parameters required for calculating the Set Flash are:
The calculation temperature
The calculation pressure
The vapor fraction
The vapor fraction provided (must be 1.0 or 0.0) makes it possible to define the state of the fluid
and to apply property calculations relative to the phase thus defined.

9.4.4.8 CVD (Constant Volume Depletion)

The parameters required for calculating the CVD are:
Best - Version. 11.0 Page:120/173
9-Windows Block properties
The calculation temperature
The calculation pressure
ATTENTION: a single block must feed a CVD block

9.4.4.9 Isochor
The parameters required for calculating the Isochor are:
The temperature: T
The specified volume: Vs
The initial pressure: Pini
The pressure coefficient: α

9.4.4.10 Variable
The parameters required for calculating the Variable are:
The value of the variable or the formula which allows it to be determined

9.4.5 Feeds

1 2 3 3 bis 4 bis 4

This frame of the Block Properties window helps define the feeds of the block in progress using
blocks already defined.
The list of Blocks available (1) is used to select the feeds in the block in progress (2).
These feeds must then be assigned types (3) for the liquid phase (default value), vapor, water
etc. and be defined in terms of quantity (4). The value of 1 is taken by default.
A feed can be edited (modified) once it is selected in (2) by modifying the characteristics in (3bis)
and (4bis).
Note that a block can also be fed by external streams (see below).

9.4.6 External streams

Best - Version. 11.0 Page:121/173

9-Windows Block properties
Besides the feeds output by other blocks, blocks can also be fed by external Fluids. They are
defined in this context in the Block Properties window.
They are defined by an Excel Fluids file (*.xls).
Once selected in (2) the name of the external feed file can be:
Edited (modified) in (1)
Deleted from the list (2) using the Delete button in (3).
The button Add in (3) makes it possible to add a filename in (2) using the standard file selection
window.
This window can also be filled by using Drag and Drop operations in the file manager or Windows
explorer. Any file selected in these tools by clicking with the left mouse button can be dragged into
zone 2 while keeping the button pressed.

Remark: Note that when editing the names of the fluids file in zone (1), the name of the file
can be suffixed with a string (n) where n is the number of the Excel sheet of the file from
which the data will be read.
C:\MyData\Data.xls indicates that the first sheet in the file Data.xls will be read (this is the
same with C:\MyData\Data.xls(1) ) whereas C:\MyData\Data.xls(4) indicates that
it is the fourth sheet in the Data.xls which will be read.

9.4.7 results

This frame of the Block Properties window presents the results of the calculations performed. It is
therefore accessible once the Block calculation is performed.
It is defined explicitly by the name of the resultxxx type sheet assigned to this type of block in
the PLUG.XLS file.

9.4.8 Specific operations

Specific operations are available for each type of block except the variable one:
Copy
Best - Version. 11.0 Page:122/173
9-Windows Block properties
Multi depth

9.4.8.1 Copy
This button of the Block Properties window is used to copy results (only for cells selected in the
Results frame) of the block to paste them in another application.

9.4.8.2 Multi depth

This button in the Block Properties window allows to perform a Multi Depth calculation in a
specific window called Multi Depth.

9.4.9 Graphic characteristics

This frame of the Block Properties window is used to define the graphic
specifications of the current block:
its background color or its transparency
the thickness of the line delimiting its border
Remember that the background color of the Display area windows are defined
by the Paper Color submenu of the View window

Remark: Consult the section on Block colors to know which colors and lines are specific to
which states.

Best - Version. 11.0 Page:123/173

9-Windows Multi Depth

9.5 Multi Depth

9.5.1 Description

This window is used to calculate a Multi Depth and to view the curve of pressure variation and
saturation pressure variation as a function of depth.
It is accessed using the Multi Depth button of the block properties window.
1
2 3

4 5 6

It is composed of the following objects:

1. Definition of calculation parameters
2. Calculate Button
3. Ok and Cancel buttons
4. Results Grid
5. Copy Button
6. Curve plotting area

9.5.2 Definition of calculation parameters

This zone is used to define the calculation parameters.

Best - Version. 11.0 Page:124/173

9-Windows Multi Depth

The reference depth

The minimum depth corresponding to the greatest depth. Depths are measured negatively
going downward.
The maximum depth corresponding to the shallowest depth. Depths are measured
negatively going downward.
The calculation step and the temperature gradient to be applied.

9.5.3 Calculate button

This button is used to launch the calculation once all the necessary data have been entered in the
Definition of calculation parameters zone.

9.5.4 Ok and Cancel buttons

These buttons are used to validate (OK) or cancel actions performed in the window.

9.5.5 Results grid

For each depth between the minimum and maximum depth and for the step and temperature
gradient defined, the results grid shows:
The pressure and temperature at that depth
The saturation pressure at the given temperature
The fluid composition

9.5.6 Copy button

This button is used to copy the values in the results grid for pasting in another application.

9.5.7 Curve plotting area

This area displays the following curves:

Pressure = F(depth)
Saturation pressure = F(depth)
Moreover, it is important to note that the contact between these two curves corresponds to a GOC
(Gas Oil Contact).

Best - Version. 11.0 Page:125/173

9-Windows Phase Envelope

9.6 Phase Envelope

9.6.1 Description

This window is used to view a phase envelope calculated using the Phase Envelope button of the
Block Properties window.
Only one other function is available. Using the Copy (1) button, it copies to the clipboard, the point
coordinates of the calculated envelope.
If they have been calculated, the values of the critical temperature and critical pressure of the Fluid
are input in the frame (2).

Best - Version. 11.0 Page:126/173

9-Windows Group

9.7 Group

9.7.1 Introduction

This window is displayed when a Group is selected by double clicking with the left mouse button. It
has the following appearance:

and is composed of the following items:

1. OK and Cancel Buttons
4
2. Lists of component blocks
3. Ungroup Button
4. Display zone

9.7.2 OK and Cancel Buttons

These buttons are used to validate (OK) or Cancel actions performed in the window.

9.7.3 List of component blocks

It lists the blocks of which the group is composed.

It is important to note that double-clicking with the left mouse button on one of the items in this list
opens the Block Properties window for the selected block.

9.7.4 Ungroup button

This button is used to ungroup the group and to regenerate the component blocks in the Display
area of the Main window.

Best - Version. 11.0 Page:127/173

9-Windows Group
9.7.5 Display area

It is used to examine the structure of the group but is assigned no action except that of scrolling.

Best - Version. 11.0 Page:128/173

9-Windows Controller

9.8 Controller

9.8.1 Introduction

This window is displayed when

A controller is selected by double clicking with the left mouse button
A controller is selected and the Properties submenu of the Edit Menu is used.
It has the following appearance:
1
3 4

A controller is created using the Diamond tool of the Toolbar

The controller window contains several zones:
1. the OK and Cancel Buttons for validating and canceling actions performed.
2. The Parameters and objective function buttons of the controller
3. The identification of the controller
4. The controller operating Conditions
5. The Results for parameters and functions defined

9.8.2 OK and Cancel Buttons

These buttons in the Controller window are used to validate (OK) or (Cancel) actions performed in
the window.

9.8.3 Parameters and objective function

These buttons in the Controller window are used to access:

The Optimization parameters window where the control parameters to be used are defined
The Specifications window where the objective functions to use for the control are defined

Best - Version. 11.0 Page:129/173

9-Windows Controller
9.8.4 Identification

This frame of the Controller window is used to define the controller name.

9.8.5 Conditions

This frame of the Controller window is used to define the operating conditions of the controller:
Acceptable tolerance on the objective function
Maximum number of iterations to perform

9.8.6 Results for parameters and functions

This frame of the Controller window is used to view results of calculations performed, in terms of
final value of the Optimization parameters and Specifications reached.

Best - Version. 11.0 Page:130/173

9-Windows Components properties

9.9 Components properties

9.9.1 Introduction

This window is displayed when the Components submenu of the Data menu is used.
It has the following appearance and it contains:

1. The OK and Cancel Buttons

2. The zone for editing unary properties of cuts
3. The zone displaying unary properties of cuts
4. The zone for editing binary properties of cuts (kij)
5. The zone displaying binary properties of cuts (kij)

Best - Version. 11.0 Page:131/173

9-Windows Components properties
9.9.2 OK and Cancel Buttons

These buttons of the Components properties window are used to validate (OK) or cancel actions
performed in the window.

9.9.3 Editing unary properties

The Components properties editing field is used to modify the value of the property of a Cut. This
value must have been previously chosen by clicking in the show unary properties zone.

9.9.4 Displaying unary properties

This display area in the Components properties window is used to view the value of Cuts
Properties. These values can be modified in the Edit Unary Properties zone, after they are selected
by clicking.

9.9.5 editing binary properties

The Components properties editing field is used to modify the value of the binary inter-cut property,
in this case the binary interaction coefficients. This value must have been previously selected by
clicking in the show binary properties zone.

9.9.6 displaying binary properties

This display area in the Components properties window is used to view the value of binary
properties of, in this case the binary interaction coefficients. These values can be modified in the
Edit Binary Properties zone, after they are selected by clicking.

Best - Version. 11.0 Page:132/173

9-Windows Copy-Backup Utility

9.10Copy-Backup Utility

9.10.1 Introduction

This window appears when the Save menu of the Data menu is used. 1
It contains:

1. Buttons
2. The zone for editing unary properties of cuts
3. The zone displaying unary properties of cuts
4. The zone for editing binary properties of cuts (kij)
5. The zone displaying binary properties of Cuts (kij)
6. The zone for Selecting a fluid

9.10.2 Buttons

These execute the following actions:

OK: validate actions (in particular editing) successfully completed in the window
Save: saves the properties displayed in the proposed file formats
Cancel: cancels actions (except for file saving) successfully completed in the window
Best - Version. 11.0 Page:133/173
9-Windows Copy-Backup Utility
Copy: copies all the properties displayed for pasting in a text or Excel file.
Copy E300 copies all the properties displayed for pasting in a text or Excel file in an
Eclipse 300 compliant format.

9.10.3 editing unary properties

This area behaves exactly in the same way as the Edit unary properties zone of the Components
properties window.

9.10.4 displaying unary properties

This area behaves exactly in the same way as the display unary properties zone of the Components
properties window.

9.10.5 editing binary properties

This area behaves exactly in the same way as the edit binary properties zone of the Components
properties window.

9.10.6 displaying binary properties

This area behaves exactly in the same way as the display binary properties zone of the Components
properties window.

9.10.7 Selecting a fluid

This zone in the Copy-Backup Utility is used to select a Fluid for display in other zones.

The fluid is chosen from a tree structure of fluids.

The branches of level 1 are the fluid types (feeds and
all the available phases in quantities or compositions.)
and those in level 2 are the names of the Blocks.
A mouse click is used to select a fluid for display (in
the example opposite, the vapor output in the TestPE
block is selected).

Best - Version. 11.0 Page:134/173

9-Windows Global Parameters Window

9.11Global Parameters Window

9.11.1 Introduction

This window appears when the Parameters menu of the Data menu is used. 1
It contains:
2

1. The OK and Cancel Buttons

2. The zone for editing parameters of cuts 4
3. The zone displaying parameters of cuts
4. The zone allowing to choose and displaying the used Equation of State

9.11.2 Buttons

These execute the following actions:

OK: validate actions (in particular editing) successfully completed in the window
Cancel: cancels actions (except for file saving) successfully completed in the window

9.11.3 Editing parameters

This area behaves exactly in the same way as the edit unary properties zone of the Components
properties window.

9.11.4 Displaying parameters

This area behaves exactly in the same way as the display unary properties zone of the Components
properties window.

Best - Version. 11.0 Page:135/173

9-Windows Global Parameters Window
9.11.5 Equation of state

This list box displays the available Equations of state and allows to choose the one to use for
standard calculations. (Remember that specific calculations use specific equations, see Three-phase
water-oil-gas flash for example)

Best - Version. 11.0 Page:136/173

9-Windows Optimization parameters

9.12Optimization parameters

9.12.1 Introduction

This window is displayed when the Parameters submenu of the Optimization menu is used or when
the Controller parameter button is clicked.
1
3 4

8
7

It contains:
1. the OK and cancel Buttons
6
2. The Global Parameters zone
3. The Block parameters zone
4. The Feed proportions zone
5. The Unary Properties zone
6. The Binary Properties zone
7. The Selection Buttons
8. The list of Selections Performed

Best - Version. 11.0 Page:137/173

9-Windows Optimization parameters
9.12.2 Ok and Cancel Buttons

These buttons in the Optimization parameters window have the following functions:
OK: validate actions successfully performed in the window
Cancel: cancel functions performed in the window

9.12.3 Global Parameters

This zone in the Optimization parameters window is used to select one (or more) global parameters
as optimization parameters.
The selection is performed simply by clicking on the desired parameter and using one of the
selection buttons (the one opposite the zone) to add the selected parameter to the list of the
selections performed.
The variation conditions of the selected parameters, in particular their limits (by defaut set to 0.8
and 1.2 times the current value) , are then defined in the selections performed zone.

9.12.4 block parameters

This zone in the Optimization parameters window is used to select one (or more) block operation
parameters as optimization parameters.
The selection is performed simply by clicking on the desired parameter and using one of the
selection buttons (the one opposite the zone) to add the selected parameter to the list of the
selections performed.
The variation conditions of the selected parameters, in particular their limits (by defaut set to 0.8
and 1.2 times the current value) , are then defined in the selections performed zone.

9.12.5 feed proportions

This zone of the Optimization parameters window is used to select one (or several) block feeds as
as optimization parameters.
The parameter is in fact, not the feed itself, but the proportion that is used (as defined in the feeds
frame Block Properties window.
The selection is performed simply by clicking on the desired feed and using one of the selection
buttons (the one opposite the zone) to add the selection to the list of the selections performed.
The variation conditions of the selected feed, in particular their limits (by defaut set to 0.8 and 1.2
times the current value) , are then defined in the selections performed zone.

9.12.6 unary properties

This zone in the Optimization parameters window is used to

select one (or more) unary properties of the cuts as optimization
parameters.
The selection is performed simply by clicking on the desired
property and cut and using one of the selection buttons (the one
opposite the zone) to add the selection to the list of the
selections performed.
Best - Version. 11.0 Page:138/173
9-Windows Optimization parameters

The variation conditions of the cuts properties, in particular their limits (by defaut set to 0.8 and 1.2
times the current value) , are then defined in the selections performed zone.

9.12.7 binary properties

This zone in the Optimization parameters window is used to select one cuts (or more) binary
properties (binary interaction coefficients in this case) as optimization parameters.
The selection is performed simply by clicking on the two relevant two cuts and using one of the
selection buttons (the one opposite the zone) to add the selection to the list of the selections
performed.
The variation conditions of the cuts binary properties, in particular their limitslimits (by defaut set
to 0.8 and 1.2 times the current value) , are then defined in the selections performed zone.

9.12.8 selection buttons

These buttons in the Optimization parameters window are used to transfer the selected parameters
between selection zones and the list of selections performed.

9.12.9 selections performed

This zone in the Optimization parameters

window is used to view the selection
Optimization parameters.
Clicking on a line with the left mouse button
selects the corresponding parameter.
Using the button Delete deletes the
parameter from the list.
The bounds of the selected parameter are
available for edition and must be defined
before calculation (by default they are set to
the current parameter value)..

Best - Version. 11.0 Page:139/173

9-Windows Specifications

9.13Specifications

9.13.1 Introduction

This window opens when the Specifications submenu of the Optimization menu is used or when the
specifications button of the Controller are used.
1
2

It contains:
1. OK and Cancel Buttons
2. The Specification definition zone 3
3. The specification editing buttons.

9.13.2 Ok and Cancel Buttons

These buttons of the Specifications window have the following functions:

OK: validate actions performed in the window
Cancel: cancel actions performed in the window

Best - Version. 11.0 Page:140/173

9-Windows Specifications
9.13.3 Definition of specifications

2.2

2.1

2.1
This zone of the Specifications window is used to define the values set for the properties used in the
Specification definition to be implemented.
2.2
This zone of the Specification window is used to list one (or more) properties whose calculated
values are used to build the specification to implement.

9.13.3.1 Definition of the Specification

The overall objective function to minimize is the sum of the squares of the differences between the
calculated values of the properties listed in (2.2) and the values they have been set in (2.1) when
they were selected.

9.13.3.2 Properties
All properties are accessible in the Properties listing window from where they can and must be
transferred by Drag and Drop in (2.1), then transferred to the zone (2.2) using the Specifications
Management Buttons.

9.13.4 Specifications editing buttons

These buttons in the Specifications window are used to edit the specifications:

1. Add adds the property defined in (2.1) to (2.2)

2. Modify modifies a property selected in (2.1) is placed in (2.2) and modified.
3. Delete deletes the property selected (by clicking) in (2.2).

Best - Version. 11.0 Page:141/173

9-Windows Optimization Echo

9.14Optimization Echo
This window is not detailed in this document. It displays an echo of the optimization and control
processes while they are running.

Best - Version. 11.0 Page:142/173

9-Windows Black Oil

9.15Black Oil

9.15.1 Introduction

This window opens when the Black Oil submenu of the Calculations menu is used.
It is used to calculate a Black Oil and contains:
2 6 3 7 1

1. the OK and Cancel Buttons

2. the Black Oil type selection zone 4
3. Composite Definition zone 5
4. pressures zone
5. the Results zone
6. Management buttons
7. Export Buttons

9.15.2 OK and Cancel Buttons

These buttons in the Black Oil window are used:

Best - Version. 11.0 Page:143/173
9-Windows Black Oil
OK: to validate actions successfully performed in the window
Cancel: to cancel actions successfully performed in the window

9.15.3 Black Oil type

This block is used to define what type of Black-Oil will be used:

1. Oil: Liquid BO
2. Gas: Vapor BO

9.15.4 Composite definition

The composite is defined by:

1. The Initial Flash, which must be selected from a list of existing flashes
2. The Process Group , which is selected from a list of existing groups (at least one group
must have been built by grouping blocks, see Group submenu under Object Menu)
3. The le Oil Atmospheric flash, which must be selected from a list of existing flashes
4. The Gas collector flash, which may be selected from a list of existing flashes or
left blank, in which case all of the gases are combined and set to standard conditions.
Once this information is entered, the composite is fully defined after setting the list of pressures to
apply.

Best - Version. 11.0 Page:144/173

9-Windows Black Oil
9.15.5 pressures

If box (1) is ticked, the pressures (2) are determined and steps in (3) and (4) are defined
automatically as detailed in the section on Black Oil.
Once the determination and the calculations are performed, the pressure values and calculation steps
are entered in the lists (2), (3) and (4).
Utilisation of other buttons is explained in the section on buttons.

Best - Version. 11.0 Page:145/173

9-Windows Black Oil
9.15.6 Results

Results are presented as two tables that differ depending on whether the user performed a Liquid
BO or Vapor BO

9.15.7 buttons

The buttons in the Black Oil window are used for:

More Significant Digits : display more
significant digits in the results of the calculations
performed.
Automatic : automatic determination of pressures and
steps as detailed in the Black Oil section
Round off : rounds the determined pressures and steps
up or down automatically for easier handling.
Calculate : implementing the Black Oil type
calculation corresponding to the definition of the
composite and pressures provided.
Insert : inserting a line below the selected line in a list of pressures and steps
Delete : deleting the currently selected line in a list of pressures and steps.

9.15.8 Export buttons

The buttons in the Black Oil window are used to:

1. Copy E100 : copy output data to the clipboard, in Eclipse 100
format

Best - Version. 11.0 Page:146/173

9-Windows Black Oil
2. Copy : copy output data to the clipboard.

Best - Version. 11.0 Page:147/173

9-Windows Multi Case

9.16Multi Case

9.16.1 Description

This window is displayed when the Multi Case menu of the Calculations menu is used to perform a
Multi Case calculation.
It has the following aspect:

and can be used only to request loading of the Multi Case data file.
Once the file is loaded, click on OK to launch the requested multi-case calculation.
The calculation results in the creation of as many windows in the Display area as there are
calculated cases.

Best - Version. 11.0 Page:148/173

9-Windows MMP

9.17MMP

9.17.1 Introduction

This window is displayed when the MMP sub-menu of the Calculations menu is used.
It has the following aspect:
2 5 1

3 4

and allows calculation of MMPs.

It contains:
1. the OK and Cancel Buttons
2. The oils and gases used selection field
3. The fields for defining the calculation parameters
4. The calculation type selection zone
5. The launch calculation button

9.17.2 OK and Cancel Buttons

In the MMP window, these buttons are used to:

OK: validate successful actions in the window
Cancel: cancel successful actions in the window

9.17.3 Oils and gases used

All the blocks presented in the flow sheet are displayed in this area to select the liquid and vapor to
be placed in contact with each other for the MMP calculation.

Best - Version. 11.0 Page:149/173

9-Windows MMP
A block must be selected for the liquid phase and another for the vapor phase.

9.17.4 Calculation parameters

The calculation temperature and number of cells are entered in these fields.

9.17.5 calculation type

This zone is used to select the MMP types to calculate and will display the calculated MMPs.
Whatever the options selected, the FCMP will always be calculated.

9.17.6 Calculation

This button launches the MMP calculation.

Best - Version. 11.0 Page:150/173

9-Windows Versus Time

9.18Versus Time

9.18.1 Introduction

This window is displayed when the Versus Time submenu of the Calculations menu is used.
It has the following look, and is used to perform a Versus Time calculation. It contains:
1
2

4
5

1. OK and Cancel Buttons

2. The time groups selection area
3. The time step definition area
4. The Excel worksheet selection zone for the calculation to be used
5. The launch calculation button

9.18.2 OK and Cancel Buttons

In the Versus Time window, these buttons are used to:

OK: validate successful actions in the window
Cancel: cancel successful actions in the window

Best - Version. 11.0 Page:151/173

9-Windows Versus Time
9.18.3 Time groups

The initial and final time groups define the calculation sequence that is reiterated at each time step,
and used for the calculation.

9.18.4 Time step

The number of main time steps is limited to 20 at most.

9.18.5 Excel worksheet

The worksheet described the variations in calculation parameters in the main time steps.

9.18.6 calculation

This button launches the Versus Time calculation

Best - Version. 11.0 Page:152/173

9-Windows Help

9.19Help
This window is displayed when the About submenu of the Help menu is used.
It gives all the necessary information about Best version and the localization of the DLL and
configuration files.

Best - Version. 11.0 Page:153/173

10-Menus Introduction

10 Menus

10.1Introduction
This chapter presents the BEST menus:
File Menu
Edit Menu
View Menu
Draw Menu
Object Menu
Window menu
Data menu
Optimization menu
Calculations menu
Help menu

Best - Version. 11.0 Page:154/173

10-Menus File Menu

10.2File Menu

10.2.1 Introduction

This is the first menu on the Menu bar. It contains the following sub-menus:
New
Open
Close
Save
Save As
Export To Text
Print
Print Preview
Print SetUp
Recently used files list
Exit

10.2.2 New

This sub-menu of the File Menu is used to open a new work session.
A new session opens in the new window and does not require saving current data or closing the
current session.
Do not confuse this sub-menu with the New Window submenu in the Window menu

10.2.3 Open

This submenu in the File Menu is used to open a work session previously saved under the Save or
Save As menus.
When used, this submenu opens a standard Open File window, in which it is possible to browse
through the hard disks and their file structure and select a file for opening.
BEST files have an .eqf extension by default.

10.2.4 Close

This submenu in the File Menu opens the Active window.

If the content of this window is modified after it is opened and the data have not been saved, a
message is displayed asking the user to confirm that he wishes to close the window without saving
the data.

10.2.5 Save

This submenu in the File Menu is used to save the contents of the current window to BEST file
format.
If the active window has never been saved, this window behaves like the Save As menu, i.e. a name
is requested before saving the file.

Best - Version. 11.0 Page:155/173

10-Menus File Menu
If the Active window has previously been saved, this menu directly saves the contents of the
window to the related file.
BEST files have an .eqf extension by default.

10.2.6 Save As

This submenu in the File Menu is used to save the contents of the current window in BEST file
format.

When used, this submenu opens a standard Save File window, in which it is possible to browse
through the disks and their file structure and select a file for saving or to enter a new file name for
creation.

BEST files have an .eqf extension by default.

10.2.7 Export to Text

This submenu in the File Menu is used to save the contents of the current window in a text format.

When used, this submenu opens a standard Save File window, in which it is possible to browse
through the disks and their file structure and select a file for saving or to enter a new file name for
creation of the text file
This text file contains the worksheet boxes defined in the BEST Macro language. (see 8.11)

10.2.8 Print

This submenu in the File Menu is used to print the graph displayed in the Active window.
No other information than the graph displayed in the Active window is printed.

10.2.9 Print Preview

This submenu in the File Menu is used to preview the printout of the graph in the Active window.
No other information than the graph displayed in the Active window is previewed.

10.2.10 Print Setup

This submenu in the File Menu is used to select the printer and define the print options for printing
(see Print menu)
The print options are defined through standard Windows menus.

10.2.11 Recently used file list

This submenu in the File Menu lists the last two files used in the software.
If the files have been deleted or moved since the last time BEST was used, they obviously will not
be able to be opened or loaded.
Best - Version. 11.0 Page:156/173
10-Menus File Menu
10.2.12 Exit

This submenu in the File Menu is used to exit the application.

If any modifications have been made but not saved in windows that are open, the application will
display a confirmation dialog box for each window modified but not yet saved.

Best - Version. 11.0 Page:157/173

10-Menus Edit Menu

10.3Edit Menu

10.3.1 Introduction

This is the second menu in the Menu bar. It contains the following submenus:
Undo
Redo
Cut
Copy
Paste
Delete
select All
Properties
Insert New Object
Links
Object

10.3.2 Undo

This submenu in the Edit Menu is used to cancel the last action performed in the Active window.
There are currently four (4) levels of Undo/Redo

10.3.3 Redo

This submenu in the Edit Menu is used to redo the last cancelled action performed in the Active
window.
There are currently four (4) levels of Undo/Redo

10.3.4 Cut

This submenu in the Edit Menu is used to Cut the currently selected object in the Active window.

10.3.5 Copy

This submenu in the Edit Menu is used to copy the currently selected object in the Active window.

10.3.6 Paste

This submenu in the Edit Menu is used to copy the contents of the clipboard to the Active window.

10.3.7 Delete

This submenu in the Edit Menu is used to delete the currently selected object in the Active window.

Best - Version. 11.0 Page:158/173

10-Menus Edit Menu
10.3.8 Select All

This submenu in the Edit Menu is used to select all objects in the Active window.

10.3.9 Properties

This submenu in the Edit Menu is used to view the Properties of the currently selected object in the
Active window.

10.3.10 Insert New Object

This submenu in the Edit Menu is used to insert a new object in the Active window.
It is particularly useful for inserting objects such as Word or Excel files which can then be filled in
using Formulas that activate DDE links.

10.3.11 Links

This submenu in the Edit Menu is not operational.

10.3.12 Object

This submenu in the Edit Menu is not operational.

Best - Version. 11.0 Page:159/173

10-Menus View Menu

10.4View Menu

10.4.1 Introduction

This is the third menu in the Menu bar.

It contains the following submenus:
Grid lines
Paper Color
Show Objects
ToolBar
Status Bar

10.4.2 Grid lines

This submenu in the View Menu is used to show or hide the grid used for easy moving of objects..
When used, it applies only to the Active window.

10.4.3 Paper Color

This submenu in the View Menu is used to select the background color.
When used, it applies only to the Active window.

10.4.4 Show Objects

This submenu in the View Menu applies only to the Active window.

10.4.5 ToolBar

This submenu in the View window is used to show or hide the Toolbar.

10.4.6 Status Bar

This submenu in the View Menu is used to show or hide the Status bar.

Best - Version. 11.0 Page:160/173

10-Menus Draw Menu

10.5Draw Menu

10.5.1 Introduction

This is the fourth menu in the Menus bar. It contains the following submenus:
Select
Line
Rectangle
Diamond
Polygon
Which are used to apply the function using the mouse.

10.5.2 Select

This submenu in the Draw Menu changes the mouse cursor into a selection tool.
It is used to select:
A single object, when the mouse is used alone, by clicking the object,
Several objects when the mouse button is used to click consecutive objects while holding down
the Shift key on the keyboard,
Several objects when the mouse is used alone, by drawing a rectangle that encompasses the
objects to select.

10.5.3 Line

This submenu in the Draw Menu changes the mouse cursor into a line-drawing tool.

10.5.4 Rectangle

This submenu in the Draw Menu changes the mouse cursor into a rectangle drawing tool.
The rectangle blocks can be of the following type:
Flash,
Bubble Pressure , Retrograde and Normal Dew-Point Pressure
Ger, GerP, GerDiff
Water-Oil-Gas Three-phase Flash,Wax Flash, Wax TCC
Split, Set Flash,Stream generator
CVD (Constant Volume Depletion), Isochor,
Variable,
MMP, Phase Envelope

10.5.5 Diamond

This submenu in the Draw Menu turns the pointer into a diamond-drawing tool.
Diamond blocks are Controller

Best - Version. 11.0 Page:161/173

10-Menus Draw Menu
10.5.6 Polygon

This submenu in the Draw Menu changes the mouse cursor into a polygon drawing tool.

Best - Version. 11.0 Page:162/173

10-Menus Object Menu

10.6Object Menu

10.6.1 Introduction

This is the fifth menu on the Menu bar. It contains the following submenus:
Line Color
Fill Color
Move to Front
Move to Back
Move Forward
Move Back
Group
These are commands used to handle objects.

10.6.2 Line Color

This submenu in the Object Menu defines the color used for the line surrounding the selected
blocks.

10.6.3 Fill Color

This submenu in the Object Menu defines the color used for filling (background color) selected
blocks.

10.6.4 Move to Front

This submenu in the Object Menu sends the selected blocks to the front.

10.6.5 Move to Back

This submenu in the Object Menu sends the selected blocks to the back.

10.6.6 Move Forward

This submenu in the Object Menu moves the selected blocks forward.

10.6.7 Move Back

This submenu in the Object Menu moves the selected blocks backward.

10.6.8 Group

This submenu in the Object Menu groups several blocks together.

Best - Version. 11.0 Page:163/173

10-Menus Object Menu
This type of grouping simplifies diagrams by graphically transforming a complex set of blocks into
a unique block called a Group.
The contents of the group are indirectly accessible, particularly to define block entries.
If block bi is part of group gj (therefore no longer appearing in the Active window), it appears as
gj_bi, particularly in the definition of other blocks.
A group of blocks is ungrouped in the group Properties window.

Best - Version. 11.0 Page:164/173

10-Menus Window Menu

10.7Window Menu

10.7.1 Introduction

This is the sixth menu in the Menu bar. It contains the following submenus:
New Window
Cascade
Tile
Arrange icons
Opened windows
It is used to manage windows.

10.7.2 New Window

This submenu in the Window menu is used to create a new window.

When this menu is used the new window is created as a copy of the Active window.
This menu does not have the same functions as the New submenu under the File Menu.

10.7.3 Cascade

This submenu of the Window menu is used to re-organise the windows so that they can cascade
over one another from the upper left-hand corner to the lower right-hand corner of the Display area
in the Main window.

10.7.4 Tile

This submenu in the Window menu is used to re-organise the windows so that they can tile over one
another without overlapping in the Display area in the Main window

10.7.5 Arrange icons

This submenu in the Window menu is used to reorganise icons for minimised windows, by lining
them up at the bottom of the Display area in the Main window

10.7.6 Opened windows

This last part of the Window menu shows the names of the open windows and is used to switch
from one window to another.

Best - Version. 11.0 Page:165/173

10-Menus Data menu

10.8Data menu

10.8.1 Introduction

This is the seventh menu in the Menu bar. It contains the following submenus:
Components
Save
Parameters
This menu is used to manage Cuts Properties and compositions of all Fluids used in the defined
flow sheet.
It also allows to edit global parameters.

10.8.2 Components

This submenu in the Data menu is used to access the Components properties window and to edit the
values of the Components properties.

10.8.3 Save

This submenu in the Data menu is used to open the Copy-Backup Utility window in which any
Fluid in the flow sheet can be saved.

10.8.4 Parameters

This submenu in the Data menu is used to edit the values of the global parameters attached to the
documentin the Global Parameters Window.

Best - Version. 11.0 Page:166/173

10-Menus Optimization menu

10.9Optimization menu

10.9.1 Introduction

This is the eighth menu in the Menu bar. It contains the following submenus:
Optimization is active
Parameters
Specifications
It is used to define the parameters and specifications to be used in a matching or optimization
operation.

10.9.2 Optimzation is active

This submenu in the Optimization menu is not yet active.

Its aim will be toindicate that there is an active optimzation function and optimization parameters
whiche will be tahen into account when running calculations.

10.9.3 Parameters

This submenu in the Optimization menu is used to open the Optimization parameters window and
to define the parameters used for the next match to be processed.

10.9.4 Specifications

This submenu in the Optimization menu is used to open the Specifications window in which the
specifications of the next match to be run can be defined.

Best - Version. 11.0 Page:167/173

10-Menus Calculations menu

10.10 Calculations menu

10.10.1 Introduction

This is the ninth menu in the Menu bar. It contains the following submenus:
Calculate
Black Oil
Multi Case
MMP
Versus Time
Initialize

This menu is used to calculate the Blocks defined and to implement certain other specific
calculations.

10.10.2 Calculate

This submenu in the Calculations menu is used to apply the calculations defined by the Blocks in
the Active window.
Once the calculations are performed, the Results can be consulted in the Windows relevant to each
block (double clicking on a block opens the Block Properties window).
It is important to note that it is necessary to Initialize the flow sheet before being able to calculate.

10.10.3 Black Oil

This submenu of the Calculations menu opens the Black Oil window used to enter the specifications
for a generalized Black Oil calculation.
These specifications use Blocks and Process-Groups defined in the Active Window and require the
definition of the following:
Initial flash initial
Process group (defined as a group using the command Group)
The atmospheric flash of the oil
The gas manifold flash
Differential pressures.

10.10.4 Multi Case

This submenu in the Calculations menu is used to open the Multi Case window in which the name
of the multi-case definition file to use must be entered.

10.10.5 MMP

This submenu in the Calculations menu is used to open the MMP window in which the
characteristics of the MMP to be calculated are provided.
The characteristics are as follows:

Best - Version. 11.0 Page:168/173

10-Menus Calculations menu
The liquid phase to take into account is defined as one of the liquid phases output by the one of
blocks defined in the Active Window
The vapor phase to take into account is defined as one of the vapor phases output by the one of
blocks defined in the Active Window
The calculation temperature,
The number of cells
The types of MMP to calculate (several choices are possible)

10.10.6 Versus Time

This submenu in the Calculations menu is used to open the Versus Time window in which the
characteristics of a Versus Time calculation can be provided.
These specifications use blocks and groups defined in the Active Window and require the definition
of:
the initial time group and the final time group (defined as groups by the command
Group)
The number of primary and secondary time intervals
The related calculation sheet

10.10.7 Initialize

This submenu in the Calculations menu is used to initialize the Active window, taking into account
external streams that feed the blocks.
This sub-menu must be used if and when no calculation has yet been performed.
However, it is important to note that using this sub-menu resets the Cuts properties and therefore
clears any modifications they may have undergone, especially after matching.

Best - Version. 11.0 Page:169/173

10-Menus Help Menu

10.11 Help Menu

10.11.1 Introduction

This menu is the last menu in the Menus bar. It contains the following submenus:
"About, which indicates the version of BEST installed and gives information about the
other files involved in the calculations.
"Help", which opens this on-line help file.

Best - Version. 11.0 Page:170/173

Index

11 Index
B Group · 14
Behaviour · 27 Creation · 101
Black Oil · 81 I
Block · 13 IniBest · 42
Creation · 96 Initialization · 99
Properties · 97 Input parameters · 25
Block colors · 115 Internal data
Bubble pressure · 47 Parameters · 21
C Internal Data · 19
Calculation · 100 Formulas · 19
Colors of blocks · 115 Modification · 21
Controller · 78, 79, 80 Results · 21
Cut · 13 Topology · 20
Cuts · 27 Isochor · 65
CVD · 63 L
D Look · 25
Data · 12 M
Block · 13 Menus · 154
Cut · 13 Calculation · 168
DDE · 15 Data · 166
Definitions · 13 Draw · 161
External · 16 Edit · 158
Fluid · 14 File · 155
Group · 14 Help · 170
Internal · 19 Object · 163
DDE · 15 Optimization · 167
DDE Functions · 106 View · 160
Description · 11 Window · 165
E MMP · 89
Excel Multi Case · 88
Atomating calculation with · 106 Multi Case data file · 17
DDE · 106 Multi depth · 86
Defining parameters in · 105 Multiple calculations · Versus Time
Retrieving data in · 104 N
External data · 16 new session · 95
External Data O
Black parameters · 17 Operations · 27, 43
Blocks definition · 17 Black Oil · 81
F Bubble pressure · 47
File CVD · 63
Fluid · 16 Flash · 44, 46
Multi Case · 17 Ger · 51
PLUG.XLS · 28 Isochor · 65
Versus Time · 18 Liste des operations · 43
Fitting MMP · 89
Controller · 78, 79, 80 Multi depth · 86
Optimizer · 93 Normal dewpoint pressures · 49
Flash · 44, 46 Set Flash · 67
Fluid · 14 Split · 60
Fluids file · 16 Stream Generator · 62
Formulas · 19 Three-phase water-oil-gas flash · 54, 56
Expressions · 20 Variable · 77
Operators · 19 Wax Oil Gas Flash · 56
Variables · 20 Wax Tcc · 58
G Optimizer · 93
Ger · 51
Best - Version. 11.0 Page:171/173
Index

P V
Parameters · 24 Variable · 77
Input · 25 Versus Time · 92
Results formats · 25 Versus Time calculation sheet · 18
Parametres (Global) · 27 W
PLUG.XLS file · 28 Wax Tcc · 58
Presentation · 10 Windows · 111
Properties · 27 Black Oil · 143
Properties listing window · 117 Blocks · 118
R Components Properties · 131
Results · 22 Controller · 129
DDERequest · 23 Copy BackUp · 133
Results output formats · 25 Global Parameters · 135
Retrograde and Normal dewpoint pressures · 49 Group · 127
S Main · 112
Set Flash · 67 MMP · 149
Software behaviour · 27 Multi Case · 148
Split · 60 Multi Depth · 124, 126
Stream Generator · 62 Optimization parameters · 137
T Parameters (Global) · 135
Three-phase water-oil-gas flash · 54, 56 Properties · 117
Toolbar · 113 Specifications · 140
Topology · 20 the best small window · 117
Definition · 98 Versus Time · 151, 153
U
Utilisation · 94

Best - Version. 11.0 Page:172/173