HYSYS - Excel Link Manipulate Oil Manager

James Martin, Aspentech, Technical Support

(AspenTech Support Knowledgebase Solution

Saved with a HYSYS 3.2 Type Library reference - For troubleshooting advice on common HYSYS / OLE Automatio
Instructions
Start HYSYS, and press Go
Code then creates a new Case, Sets Oil Manager Info and Reports Results
Case File name

d:\test.hsc

Fluid Package Name to Create PengRob

[Choose from PengRob, SRK, ... See Techtip #109180 for a full list of possible Types]
Fluid Package Name
Assay Name
Assay Type
Blend Name
Stream Name

New FP
My Assay
TBP
My Blend
Oil Stream

Light End components and Compositions

[Must be HYSYS full names - leave % empty to not include LE's]

Distillation Data

Type

Liquid Volume %

Type

Component
Methane
Ethane
Propane
i-Butane
n-Butane
i-Pentane
n-Pentane

%
0
0
0
0.19
0.11
0.37
0.46

Bulk Properties
Bulk MW
Bulk Standard Density

300
48.75 API_60

Assay Flow Rate

Flow units
Flow rate

Mass
100 kg/h
m3/h
kgmole/h

Mole

0
10
20
30
40
50
60
70
80
90
98

Temperature
80
255
349
430
527
635
751
915
1095
1277
1410

Blend Cut Ranges

Cutting Option

Auto Cut

User Points

30

User Ranges
Temp Units
Initial Cut Point

F
100

Cut Point T

No of cuts
800
1200
1400

28
8
2

t Knowledgebase Solution #110053)

HYSYS / OLE Automation errors see Knowledgebase Solution #112361.

MW

Density

Viscosity

Here MW is dependent (ie same dist. %'s

as dist. Data) the rest are independent. It
is possible to make any of these props.
dependent or independent
F

MW

%
68
119
150
182
225
282
350
456
585
713
838

13
33
57
74
91

Density
API
63.28
54.86
45.91
38.21
26.01

Type
Dynamic
Units
cP
cSt
Temperature 1
100 F
Temperature 2
210 F
%
10
30
50
70
90

Viscosity
0.2
4.2
39
75
600

10
30
50
70
90

Viscosity
0.1
0.3
0.8
7.5
122.3

User Property
Name
Sulphur
Basis
Mass Fraction
Bulk Value
2.8

%
0.9
7.38
11.48
16.42
22.4
26.68
31.78
36.95
42.04
47.14
48.84
50.52
52.22
54.08
55.85
57.17
60
64.47
68.4
72.09

Value
3.20E-02
2.60E-02
2.00E-02
8.30E-02
9.40E-02
0.212
0.616
1.122
1.693
2.354
2.629
2.786
2.796
2.733
2.691
2.669
2.67
2.806
3.085
3.481

75.66
78.99
82.05
84.85
87.38
90.33

3.912
4.3
4.656
4.984
5.286
5.646

Working Curve Output for Assay My Assay

Moles
0
0.01
0.01
0.01
0.01
0.01
0.01
0.01
0.01
0.01
0.01
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.025
0.015
0.015
0.015
0.015
0.015
0.015

Cum MolesNBP
C
0 67.05382
0.01 77.11263
0.02 86.1879
0.03 94.91851
0.04 103.093
0.05 110.7551
0.06 117.9825
0.07 123.8551
0.08 128.2642
0.09 132.3145
0.1 137.8631
0.125 151.4868
0.15 163.1357
0.175 173.8331
0.2 184.4817
0.225 195.2452
0.25 205.8978
0.275 216.7746
0.3 228.4968
0.325 241.0872
0.35 254.0748
0.375 267.4784
0.4 281.2324
0.425 295.3046
0.45 309.6943
0.475 324.4562
0.5 339.0625
0.525 353.4786
0.55 368.4734
0.575 384.3417
0.6 402.0415
0.625 422.1399
0.65
443.8
0.675 466.4046
0.7 489.684
0.725 513.2669
0.75 537.1418
0.775
561.34
0.8 585.752
0.825 609.8243
0.85 637.0254
0.865 654.9248
0.88 669.1047
0.895 683.391
0.91 697.1833
0.925 710.5422
0.94 723.8657

MW
77.96701
82.22688
86.24314
90.03228
93.6108
96.99521
100.202
103.2477
106.1488
108.9213
111.5722
117.919
124.0395
129.9734
135.9088
142.1262
148.981
156.259
164.0449
172.4351
181.7436
191.6735
202.202
213.3181
224.4784
236.2578
248.9091
262.5771
277.5935
293.9844
311.7803
331.0167
352.5926
376.2172
400.9523
426.6186
452.4019
477.9387
503.985
530.589
557.3413
573.2092
589.4732
606.2101
623.5234
641.5106
660.3089

Mass Density
Viscosity1
kg/m3
cP
671.2832 0.182856
672.8066 0.185451
674.3282 0.188083
675.848 0.190752
677.366 0.193459
678.8822 0.196205
680.3966 0.198989
681.9093 0.219648
683.4202 0.254254
684.9292 0.294312
686.4365 0.340682
690.1969 0.491135
693.9461 0.707703
697.6842 1.023111
701.4111 1.488653
705.1268 2.155205
708.8313 3.096276
712.529 4.393547
716.1943 6.107659
719.6557 8.362356
723.0688 11.26235
726.4955 14.90476
729.953 19.4926
733.4595 24.94771
737.033 31.12601
740.6915 37.77585
744.4531 43.33643
748.34 48.05208
752.3248 52.20357
756.2423 55.89815
760.2907 59.01599
764.6365 62.09378
769.3131 65.94503
774.3695 71.17712
779.8443 80.32251
785.8655 95.22811
792.6211 116.031
800.0656 145.3194
808.0293 186.7301
816.5284 245.7232
825.5628 330.5365
831.2404 398.7775
837.1108 484.4477
843.1739 592.0459
849.4297 727.1157
855.8782 898.6918
862.5195 1118.818

Viscosity2
cP
0.06982
0.073932
0.078264
0.082828
0.087634
0.092693
0.098018
0.103621
0.109514
0.115711
0.122226
0.139995
0.160055
0.182844
0.208896
0.237925
0.270013
0.304442
0.338189
0.374906
0.415796
0.462693
0.513099
0.575912
0.658884
0.770728
0.992442
1.26545
1.653458
2.214065
2.905272
3.772659
4.929212
6.483477
8.657781
11.7543
16.11884
22.32727
31.22225
44.05356
62.68274
77.75014
96.7031
120.571
150.6514
188.7194
237.0754

0.015
0.015
0.015
0.015

0.955 736.8488 680.2158 869.3532 1403.301 298.6847

0.97 750.1376 701.1068 876.2579 1773.659 377.4201
0.985 773.9442 721.132 883.9864 2258.686 478.3058
1 819.707 740.2791 900.5744 2886.081 606.954

Component Properties for Blend My Blend

ComponentNBP
Name
C
NBP_76
76.20306
NBP_88
87.79989
NBP_102 101.8601
NBP_116 116.0547
NBP_129 129.1934
NBP_143
142.723
NBP_158 158.0003
NBP_171 170.9286
NBP_185
184.693
NBP_199 198.5876
NBP_212 212.2891
NBP_226 226.1072
NBP_240
240.059
NBP_254 253.8894
NBP_268 267.7491
NBP_282
281.599
NBP_295 295.4452
NBP_309 309.2666
NBP_323 323.1955
NBP_337 337.0537
NBP_351 350.7955
NBP_365 364.6237
NBP_378 378.4006
NBP_392 392.2262
NBP_406 406.0881
NBP_420 420.0084
NBP_441 440.6802
NBP_468
468.489
NBP_496 496.3007
NBP_524 524.0296
NBP_552 551.7703
NBP_580 579.6706
NBP_606 606.4891
NBP_636 636.2347
NBP_682
681.748
NBP_739 738.8155
NBP_811 810.6328

MW
79.91214
85.02328
91.32811
97.75605
105.4478
112.0216
117.9675
125.4338
133.096
140.9924
149.7071
158.619
167.5477
176.9367
186.9091
197.2242
207.9183
218.6221
229.3703
240.8277
253.2002
266.2864
279.8557
293.43
306.5992
319.352
338.6566
366.5097
395.6377
425.567
455.295
484.6171
513.8914
543.394
596.0903
673.8333
727.5036

Mass Density
Viscosity 1
kg/m3
cP
672.0716 0.183997
673.959 0.187239
676.4883 0.191682
679.3323 0.196814
683.1429 0.24424
686.787 0.348458
690.3151
0.4911
694.9058 0.768434
699.7428 1.243161
704.5583 2.012975
709.3008 3.201629
713.77 4.862373
717.7875 6.982652
721.4407 9.684604
724.9724 13.05255
728.4357 17.20192
731.8597 22.17114
735.2585 27.77735
738.666 33.89723
742.167 39.91211
745.7949 44.90699
749.4545 49.13191
752.986 52.73488
756.2156 55.76156
759.2235 58.14187
762.1149 60.20469
766.408 63.36002
772.3835 68.72633
778.7419 77.91665
785.6989 94.38448
793.5159 118.6774
802.149 154.377
811.2162 205.9095
820.8436 281.6762
839.5609 522.8974
867.2396 1301.38
889.3117 2437.671

Viscosity 1
cP
0.183997
0.187239
0.191682
0.196814
0.24424
0.348458
0.4911
0.768434
1.243161
2.012975
3.201629
4.862373
6.982652
9.684604
13.05255
17.20192
22.17114
27.77735
33.89723
39.91211
44.90699
49.13191
52.73488
55.76156
58.14187
60.20469
63.36002
68.72633
77.91665
94.38448
118.6774
154.377
205.9095
281.6762
522.8974
1301.38
2437.671

Tc
C
242.6825
254.0013
267.2097
280.2596
292.3568
304.518
317.8418
329.3634
341.4649
353.5172
365.271
376.9106
388.3935
399.5613
410.6064
421.5245
432.3369
443.0406
453.7438
464.3612
474.8825
485.4157
495.8144
506.0811
516.2374
526.338
541.2531
561.2551
581.2755
601.3787
621.7649
642.5368
662.8002
685.0581
720.8943
767.885
821.1531

Pc
bar
28.6209
26.86494
24.89403
23.09063
21.65365
20.25943
18.76161
17.71371
16.67223
15.69101
14.79073
13.92495
13.08028
12.2808
11.52662
10.82008
10.15878
9.541206
8.958749
8.421855
7.93011
7.46668
7.0292
6.605587
6.199122
5.812153
5.281867
4.649756
4.102979
3.636342
3.241341
2.903225
2.626339
2.343833
2.028179
1.74854
1.321561

Af
0.300878
0.321188
0.349874
0.380143
0.408836
0.439449
0.475372
0.505924
0.53922
0.573608
0.60822
0.643986
0.681081
0.718737
0.757224
0.79638
0.844649
0.88742
0.930116
0.972045
1.013006
1.053741
1.093969
1.134209
1.174342
1.214322
1.272817
1.349596
1.423964
1.495354
1.563642
1.629221
1.689215
1.754177
1.843006
1.939571
2.071434

Component Breakdown for Blend My Blend

WatsonK
12.74765
12.85108
12.96716
13.07378
13.14553
13.22074
13.3123
13.35524
13.39855
13.44025
13.47841
13.51992
13.56833
13.61982
13.67125
13.7214
13.7699
13.81642
13.86145
13.90211
13.93757
13.97122
14.00511
14.04325
14.08408
14.12585
14.18499
14.25571
14.31389
14.35556
14.37714
14.38098
14.36776
14.35753
14.26782
14.0823
14.05026

Components
Liq Vol % Cum Liq VolVol
% Flow
m3/h
Methane
0
0
0
Ethane
0
0
0
Propane
0
0
0
i-Butane
0.19
0.19 0.000243
n-Butane
0.11
0.3 0.00014
i-Pentane
0.37
0.67 0.000472
n-Pentane
0.46
1.13 0.000587
NBP_76
0.263471 1.393471 0.000336
NBP_88
0.505478 1.898949 0.000645
NBP_102 0.586717 2.485666 0.000749
NBP_116 0.728974 3.21464 0.00093
NBP_129 1.169698 4.384338 0.001493
NBP_143 0.741901 5.126239 0.000947
NBP_158 1.234611 6.36085 0.001576
NBP_171 1.470091 7.830941 0.001876
NBP_185 1.542643 9.373584 0.001969
NBP_199 1.627885 11.00147 0.002078
NBP_212
1.67249 12.67396 0.002135
NBP_226 1.608613 14.28257 0.002053
NBP_240 1.585479 15.86805 0.002024
NBP_254 1.615004 17.48306 0.002061
NBP_268 1.647749 19.1308 0.002103
NBP_282
1.68921 20.82002 0.002156
NBP_295 1.734207 22.55422 0.002214
NBP_309
1.77001 24.32423 0.002259
NBP_323 1.830472 26.1547 0.002336
NBP_337 1.943867 28.09857 0.002481
NBP_351 2.029061 30.12763 0.00259
NBP_365 2.035238 32.16287 0.002598
NBP_378 2.011995 34.17486 0.002568
NBP_392 1.914233 36.0891 0.002443
NBP_406 1.806714 37.89581 0.002306
NBP_420 1.745158 39.64097 0.002228
NBP_441 3.489192 43.13016 0.004454
NBP_468 3.585138 46.7153 0.004576
NBP_496 3.757501 50.4728 0.004796
NBP_524 3.950685 54.42349 0.005043
NBP_552 4.120497 58.54398 0.005259
NBP_580 4.339813 62.8838 0.005539
NBP_606 4.316713 67.20051 0.00551
NBP_636 4.657051 71.85756 0.005944
NBP_682 12.47868 84.33624 0.015928
NBP_739 11.42459 95.76083 0.014583
NBP_811 4.239166
100 0.005411

Mass Flow Mole Flow

kg/h
kgmole/h
0
0
0
0
0
0
0.136288 0.002345
0.081888 0.001409
0.294436 0.004081
0.369747 0.005125
0.226017 0.002828
0.43484 0.005114
0.50662 0.005547
0.632103 0.006466
1.01995 0.009673
0.650372 0.005806
1.087855 0.009222
1.303958 0.010396
1.377836 0.010352
1.463977 0.010383
1.514215 0.010115
1.465559 0.009239
1.452613 0.00867
1.487194 0.008405
1.524776 0.008158
1.57061 0.007964
1.620027 0.007792
1.661152 0.007598
1.725857 0.007524
1.841458 0.007646
1.931559 0.007629
1.946947 0.007311
1.933781 0.00691
1.847711 0.006297
1.750864 0.005711
1.697653 0.005316
3.413332 0.010079
3.534536 0.009644
3.734963 0.00944
3.96207 0.00931
4.173485 0.009167
4.443443 0.009169
4.469751 0.008698
4.879384 0.008979
13.37256 0.022434
12.64659 0.018768
4.812026 0.006614

Oil Properties for Blend My Blend

Liq Vol % TBP
C
0 19.93042
1 48.12076
2 97.19111
3.5 125.4909
5 146.5954
7.5 174.6821
10 196.9791
12.5 217.8253
15 239.3994
17.5 260.9284
20 281.8004
25 321.3732
30 356.8452
35 391.2749
40 429.7256
45 469.0863
50 506.5752
55 541.7111
60 575.0662
65 606.225
70 639.0648
75 666.5025
80 689.5818
85 710.8991
90 738.4953
92.5 760.2918
95 783.4965
96.5 797.6584
98 811.7487
99 821.0009
100 830.0691

ASTM D86 D86 Crack Reduced

ASTM D1160
ASTM
(Vac)
D1160
Tc (Atm)
C
C
C
C
C
72.82694 72.82694 -62.7831 19.93042 126.0622
89.69478 89.69478 -41.3882 48.17223 208.7801
121.7364 121.7364 -3.75458 97.1907 262.8782
142.1216 142.1216 18.26373 125.4875 288.9622
158.0972 158.0972 34.83236 146.5976 307.9126
180.2039 180.2039 57.06617 174.6821 332.6802
198.4025 198.4025 74.87566 196.9791 352.1294
215.8707 215.8707 91.65378 217.8252 369.9638
234.3563 234.3563 109.1495 239.3995 387.8558
253.1592 253.1592 126.7431 260.9284 405.1874
267.7324 271.6757 143.9299 281.8004 421.6825
300.0002 307.4364 176.8721 321.3732 452.3465
327.0919 339.7631 206.8043 356.8451 479.4998
350.6583 370.7949 236.2294 391.2747 505.3795
373.7285 405.426 269.5335 429.7258 533.3588
393.9206 441.0857 304.1188 469.0863 561.6845
410.1881 475.1199 337.5334 506.5748 588.7014
423.1667 506.9935 369.2798 541.7108 614.3411
433.8566 537.2949 399.8093 575.0664 639.0887
442.6538 565.599 428.679 606.2249 662.6008
451.0942 596.0469 459.4782 639.0622 687.2195
457.7924 622.6409 485.4989 666.4858 708.6313
463.1371 645.5386 507.5598 689.5107 727.4998
467.5487 665.985 528.0865 710.7513 745.4705
471.8911 689.0184 555.153 738.4931 767.6356
474.4806 706.3346 576.668 760.332 781.5913
476.4185 723.189 599.7271 783.5318 798.1559
477.338 732.5136 613.8891 797.6755 809.5632
478.1322 740.9139 628.0583 811.7475 821.9664
478.5974 745.8658 637.4123 820.9946 828.7679
479.0068 750.2048 646.6255 830.0691 835.5693

Pc
bar
35.59156
31.84371
25.5296
22.04454
19.86375
17.42246
15.80103
14.43988
13.11936
11.89183
10.81014
9.03252
7.724011
6.6342
5.556244
4.637127
3.921271
3.377189
2.955291
2.628945
2.320593
2.121492
1.977813
1.856675
1.75059
1.587951
1.495462
1.406129
1.316652
1.276984
1.239637

Acentric Factor
0.173356
0.267073
0.339955
0.400627
0.448476
0.514925
0.569589
0.622438
0.679307
0.738193
0.79705
0.924557
1.03088
1.131446
1.241956
1.351219
1.450758
1.539241
1.618615
1.688634
1.760107
1.814861
1.856601
1.892128
1.939012
1.971294
2.011912
2.041047
2.073447
2.090284
2.107121

Distribution Curves for Blend My Blend (Mass

MW
58.124
74.5828
89.22289
103.1841
113.5592
127.5363
140.0469
153.2741
167.1182
181.9439
197.3779
227.9401
258.8518
292.5062
328.3371
367.1232
406.6753
444.5607
479.7511
513.61
546.3771
577.2582
608.137
640.3856
673.5075
690.3985
707.5111
717.8854
728.3231
735.1759
742.0287

Mass Density
Viscosity 1
kg/m3
cP
550.0469 0.116885
641.4344 0.194719
675.6166 0.190105
681.9696 0.223948
687.6801 0.380088
696.2305 0.876013
704.0025 1.904533
711.1403 3.810501
717.6061 6.870433
723.2467 11.30608
728.4858 17.26853
738.217 33.08483
747.4021 46.84965
756.0018 55.57404
764.1271 61.64869
772.5153 68.87517
781.2358 83.11707
790.5869 108.7777
800.6699 147.4643
811.1268 205.3171
821.8585 291.2137
832.7219 416.7899
843.7118 602.3256
854.9635 879.3429
867.1156 1296.424
873.6862 1579.873
880.6704 1929.933
885.0854 2178.677
889.6487 2461.143
892.467 2666.488
895.2852 2888.965

Viscosity 2
cP
0.059
0.101432
0.081699
0.103405
0.12731
0.172911
0.227832
0.289926
0.351355
0.416716
0.489042
0.684967
1.184946
2.154466
3.637344
5.828966
9.24414
14.59654
22.78551
35.24872
54.03
81.76
122.9161
184.426
275.6553
336.5071
410.3771
462.0433
520.0606
563.0062
609.4983

Sulphur User
Density
Prop User Prop
kg/m3
0.025324 703.3106
0.022957 709.1561
0.020537 714.2622
0.020279 720.9787
0.042989 727.0158
0.069944 736.0553
0.118958 744.2718
0.30555 751.8179
0.597201 758.6536
0.902184 764.6168
1.213561 770.1556
1.882005 780.4435
2.08377 790.154
2.030834 799.2455
2.11297 807.8356
2.309385 816.7037
2.611348 825.9229
2.933245 835.809
3.229217 846.4687
3.503621 857.5237
3.766004 868.8694
4.018303 880.3543
4.26603 892.1292
4.513083 904.2878
4.757499 916.7163
4.878599 923.0137
4.998898 929.3568
5.070672 933.1817
5.142196 937.016
5.19028 939.5537
5.238364 942.0913

Straight Run
Name

Begin T
C
Lt St Run 67.87392
Naphtha
70
Kerosene
180
Light Diesel
240
Heavy Diesel
290
Atm Gas Oil
340
Residue
370

n Curves for Blend My Blend (Mass Basis)

Cycle Oil
End T
C
70
180
240
290
340
370
830.4275

Fraction
0.001326
0.068356
0.063176
0.05492
0.061481
0.041883
0.708858

Name

Begin T
End T
C
C
LCN Gasoline
67.87392
150
HCN Naphtha
150
230
LCGO
230
300
ICGO
300
340
HCGO
340
380
Residue Oil
380
430
Residue Oil
430 830.4275

Vacuum Oil
Fraction
0.044093
0.078323
0.07705
0.049792
0.055913
0.064265
0.630564

Name
Off Gas
LVGO
HVGO
Vac Residue
Vac Residue
Vac Residue

Vacuum Oil
Begin T
End T
C
C
67.87392
370
370
430
430
560
560
650
650
750
750 830.4275

Fraction
0.291142
0.078294
0.175888
0.147494
0.212453
0.09473