Aspen pETSup

Aspen PetroleumSupply Chain V7.2

Release Notes

Version Number: V7.2July 2010

Copyright (c) 2010 by Aspen Technology, Inc. All rights reserved.

Aspen PIMS, Aspen Petroleum Scheduler, Aspen Refinery Multi-Blend Optimizer, Aspen Olefins Scheduler, AspenReport Writer, Aspen Refinery Report and the Aspen leaf logo are trademarks or registered trademarks of AspenTechnology, Inc., Burlington, MA.

All other brand and product names are trademarks or registered trademarks of their respective companies.

This document is a guide for using AspenTech's software. This documentation contains AspenTech proprietary andconfidential information and may not be disclosed, used, or copied without the prior consent of AspenTech or as setforth in the applicable license agreement. Users are solely responsible for the proper use of the software and theapplication of the results obtained.

Although AspenTech has tested the software and reviewed the documentation, the sole warranty for the softwaremay be found in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES NOWARRANTY OR REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THISDOCUMENTATION, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULARPURPOSE.

Aspen Technology, Inc.200 Wheeler RoadBurlington, MA 01803-5501USAPhone: (1) (781) 221-6400Toll Free: (1) (888) 996-7100URL: http://www.aspentech.com

http://www.aspentech.com/

Aspen Petroleum Supply Chain 7.2 Release Notes iii

Contents

About These Release Notes .....................................................................................6

Related Documentation.....................................................................................6

New Features ..........................................................................................................7

Aspen PIMS .....................................................................................................7New Matrix Generator.............................................................................7Multi-Start.............................................................................................7Adapter Interfaces..................................................................................7XNLP Solver...........................................................................................7Extended Tags .......................................................................................8Matrix Comparison .................................................................................8Penalty Structures..................................................................................8New Correlations....................................................................................8Warning Messages..................................................................................8Dialog Box Modifications .........................................................................8

Aspen Petroleum Scheduler, Aspen Olefins Scheduler and Aspen Refinery Multi-BlendOptimizer ...................................................................................................... 10

Interface Changes ................................................................................ 10Keywords ............................................................................................ 10Dialog Box Modifications ....................................................................... 11

Aspen Petroleum Scheduler and Aspen Refinery Multi-Blend Optimizer.................. 12Interface Changes ................................................................................ 12Keywords ............................................................................................ 12

Aspen Petroleum Scheduler ............................................................................. 13Keywords ............................................................................................ 13Dialog Box Modifications ....................................................................... 13Data Tables ......................................................................................... 13ABML Correlations ................................................................................ 13New Automation Object ........................................................................ 14

Aspen Olefins Scheduler.................................................................................. 15New Automation Object ........................................................................ 15

Aspen Refinery Multi-Blend Optimizer ............................................................... 16Trends ................................................................................................ 16New Automation Object ........................................................................ 16Dialog Box Modifications ....................................................................... 16

Aspen Refinery Report .................................................................................... 17Aspen Report Writer ....................................................................................... 17

Software Fixes ......................................................................................................19

Fixed Defects................................................................................................. 19Aspen PIMS V7.2............................................................................................ 19Aspen Petroleum Scheduler V7.2...................................................................... 22

iv Aspen Petroleum Supply Chain V7.2 Release Notes

Aspen Refinery Multi-Blend Optimizer V7.2........................................................ 23Aspen Olefins Scheduler V7.2 .......................................................................... 23

Known Issues........................................................................................................25

Aspen PIMS ................................................................................................... 25Aspen Petroleum Scheduler ............................................................................. 25

Aspen Petroleum Supply Chain 7.2 Release Notes v

6 Aspen Petroleum Supply Chain V7.2 Release Notes

About These Release Notes

These Release Notes describe the Aspen Petroleum Supply Chain (PSC) V7.2family of products which includes Aspen PIMS, Aspen Petroleum Scheduler,Aspen Olefins Scheduler, Aspen Refinery Multi-Blend Optimizer and AspenReport Writer. This document includes:

New features

Software fixes

Known Issues

Related DocumentationIn addition to these Release Notes, AspenTech provides the followingdocumentation for the Aspen Petroleum Supply Chain V7.2 family of products.These documents are available from the aspenONE Documentation Disc:

Aspen Petroleum Supply Chain Installation Guide

Aspen Petroleum Supply Chain Integration – User Guide

Aspen PIMS Help

Aspen Petroleum Scheduler Help

Aspen Refinery Multi-Blend Optimizer Help

Aspen Olefins Scheduler Help

Aspen Report Writer Help

Aspen Petroleum Supply Chain V7.2 Release Notes 7

New Features

This section describes the new features in the Aspen Petroleum Supply Chainfamily of products.

Note: The V7.2 release of PSC products is primarily a defect fix release.Resolution of many of these defects added new functionality. New featuresassociated with these changes are highlighted here as well as in the SoftwareFixes chapter.

Aspen PIMSThe new features and enhancements listed below apply to Aspen PIMS.

New Matrix GeneratorThe New Matrix Generator released in V7.1 was made more robust and is nowcapable of running more types of models.

ABML CARB correlations have been expanded and enhanced for working withthe new XLP matrix generator.

Multi-StartThis feature has been enhanced and now allows selection of starting points.In addition, improvements have been made to work more effectively for moretypes of models.

Adapter InterfacesWorked was performed to improve interfaces for blend events andSupplyItems.

XNLP SolverEnhancements were made to reduce execution time and to increase thelikelihood of finding global optimum.


Extended TagsConverting to and working with extended tags has been made easier byallowing users the option to run existing short tag model in extended tagmode without changing the tag internally using the Preserve Original Tagsoption.

Matrix ComparisonMatrix Comparison reports can now be viewed directly from within PIMS.

Penalty StructuresPenalty structures for specifications that span plants and periods have beenimplemented.

New CorrelationsAmended CARB3 correlations have been implemented in Advanced Optimization (AO).

Warning MessagesThe following Warning Message has been added to the system:

Global BLNSPEC Entry at XXX and YYY Ignored due to the local settingSMALL

Row XXX in Table ROWS has Non-Empty Entries in Conflicting Columns

Unsupported input database table XXX skipped

TABLE XXX does not exist in the model. The updates will be ignored for CASE YYY

In addition, numerous warning and error message details have been added tothe online help documentation. Refer to the warning and error messageoverview pages in the online help for specifics.

Dialog Box ModificationsThe following dialog boxes have been changed:

General Model Settings Miscellaneous Tab

The Preserve Original Tags option has been added which allows youto retain the original tags even though you have indicated to use ExtendedTags.

General Program Options Execution Tab

The New Close Model upon PIMS Exit option has been added whichallows you to close your model prior to exiting PIMS. This prevents themodel from automatically loading when you relaunch the application.

XNLP Settings Advanced Tab


The Calculate Holding Costs based on Closing Inventory optionallows you to include holding costs associated with target inventory levelsinto your calculation, thus reflecting the actual or full costs of holding theinventory. This option is only available for XLP.

Reporting Dialog Box – Outputs TabA new tab, Outputs, has been added to the Reporting dialog box thatallows you to indicate how output files are handled.

In addition to two new output options, the Save Case MPS Files andCreate MPSBCD File options, from the Execution dialog boxes, havebeen re-located to this new tab.

XSLP Settings Advanced 2 Tab

The Relax Quality Bounds option has been added and is used torelax bounds on quality variables, from their upper and lower bounds,during optimization.


Aspen Petroleum Scheduler,Aspen Olefins Scheduler andAspen Refinery Multi-BlendOptimizerThe new features listed below apply to Petroleum Scheduler, OlefinsScheduler and Refinery Multi-Blend Optimizer.

Interface ChangesStatus BarThe status bar display has been enhanced to display optimizer and simulatorstatus, as applicable.

New Zoom FeaturesThe following zoom buttons have been added to the Event interface:

Undo last horizontal zoom. Only available if horizontal zoom wasapplied to the Gantt or trend screen.

Undo last vertical zoom. Only available if vertical zoom was applied tothe Gantt screen.

Reset Horizontal Zoom. Returns Gantt and trend screens to originalhorizontal positions.

Reset Vertical Zoom. Returns Gantt screen to original vertical position.

Returns to 100%. Returns the Gantt and trend screens to their originaldisplay sizes. Only available if zoom was applied.

KeywordsThe following keywords have been added to the CONFIG table. Refer to theonline help for details associated with each of the keywords.

AUDITINV_UPDATE_VALUE_ON_POP_SIM_VALUES allows you tocopy SIM values into the VALUE fields each time Populate Sim Values,found on the Audit Inventories dialog box, is clicked.

CLIP_CRUDE_RUN_EVENT indicates overlapping crude run eventsassociated with the same unit will be clipped based on presence of unitparameters; those with unit parameters will be clipped and those withoutwill not. If set to ‘N’, crude run events will never be clipped.

EXCEL_IGNORE_REMOTE_REQ when opening other Excel workbooks,prevents these workbooks from attaching to the Excel session that isalready opened by PS, MBO or Olefins. Eliminates problems where add-ins in the workbook you are trying to launch won’t load or preventing theAspenTech application from accessing the correct workbook in the sharedExcel session.


PUBZEROVOLTANK allows you to publish zero volume properties.

USEADAPTER allows you to indicate use of ODM adapters for integration.

USE_LOG_UTC allows you to use UTC timestamp on events, schedule,model log and crudes to allow users to spread across multiple time zones.


Trend List Dialog BoxYou can now reorder trend list charts, designate the location of Y-axisvalues and display multiple trends on the same chart using the Trend Listdialog box.

Settings Dialog BoxBlending TabThe Exclude Heels option has been added that allows you to indicate ifheels are to be excluded from all new blend events.Model Settings TabSeveral Audit Inventory Options, which impact the Audit Inventoriesdialog box, have been added that affect how simulation information isdisplayed and where property values will come from when populating filterfields.


Aspen Petroleum Scheduler andAspen Refinery Multi-BlendOptimizerThe new features listed below apply to both Petroleum Scheduler and RefineryMulti-Blend Optimizer.

Interface ChangesEvent Toolbar

Memory Cache On and Off buttons have been added to the Eventtoolbar to assist with memory and simulation performance issues.Refinery Report button has been added to the toolbar to enable accessto the new Excel add-in reporting wizard.

Trend List button has been added that allows you to access the TrendList dialog box from the toolbar.

KeywordsThe following keywords have been added to the CONFIG table:

OMITHEELPUBLISH indicates if heels are excluded, what product tankproperties are set to in the AB_TANK_QUALITIES table during publishing.


Aspen Petroleum SchedulerThe new features listed below apply to Petroleum Scheduler.

KeywordsThe following keywords have been added to the CONFIG table:

PUB_BIAS_RESULTS has been added that allows bias results to bepublished to the _BIASRESULTS table.

MINCRDPCTPUBLISH; if crude composition is less than this value, thecrude composition will not be published and the other compositions are re-normalized.


Audit Inventories Dialog Box Tank TabThe Hide Crude Composition option has been added to the Tanks tabthat allows you to view or hide tank composition information.

Data TablesThe following data tables have been added or modified:

_BIASRESULTS – stores bias and unbias values.

ORION_MGR_EVENT_IMPORT– new field SECPIPELINE_ID has beenadded that allows you to indicate a second pipeline for material to flowthrough before arriving at the destination tank with importing crudereceipt and pipeline shipments.

ABML CorrelationsThe following correlations have been added:

Nitrogen Oxides (Amended CARB3)

Nitrogen Oxides with non-Ethanol as Oxygenate (Amended CARB3)

Nitrogen Oxides without Ethanol as the Oxygenate (Amended CARB3)Slack

Potency-Weighted Toxics (CARB3)

Potency-Weighted Toxics without Ethanol as Oxygenate (AmendedCARB3)

Potency-weighted Toxics without Ethanol as the Oxygenate (AmendedCARB3) Slack

Total Hydrocarbon (CARB3)

Total Hydrocarbon without Ethanol as Oxygenate (Amended CARB3)

Total Hydrocarbon without Ethanol as the Oxygenate (Amended CARB3)Slack


New Automation ObjectA new automation object, Orion.OrionAutoUDT, has been added andincludes the following methods:

AddStrmsToMix

ClearPipelineBatchVars

GetNrPipelineBatches

GetPipelineBatchBySeq

InitMixStrms

InitPropList

MixStrms

MixStrmsRFG

ModificationsThe following automation changes were made for V7.2.

Properties (Orion.EventItem)Rate when associated with EventUDT is represented as quantity per Day.Rate associated with EventsColl can be represented as quantity per Dayor per Hour as specified by the Options property.


Aspen Olefins SchedulerThe new features listed below apply to Olefins Scheduler.

New Automation ObjectA new automation object, Olefins.OlefinsAutoUDT, has been added andincludes the following methods:

AddStrmsToMix

InitMixStrms

InitPropList

MixStrms

MixStrmsRFG


Aspen Refinery Multi-BlendOptimizerThe new features listed below apply to MBO.

TrendsYou can now trend component run downs.

New Automation ObjectA new automation object, OrionMBO.OrionAutoUDT, has been added. Thisobject has the following methods:

AddStrmsToMix

InitMixStrms

InitPropList

MixStrms

MixStrmsRFG


Blend Details Dialog BoxColors have been added that visually indicate min and max values.


Aspen Refinery ReportAspen Refinery Report is a new Excel add-in which allows you to use a wizardinterface to quickly create report templates, generate custom reports orexport table data. This new feature is the first version and will continue to beenhanced in future releases.

Aspen Report WriterThis section describes the new features available in Aspen Report Writer.

CQ00328219

Function Wizard for ATDSSort() has been created to sort arrays from 3different fields.

CQ00328221

Function Wizard for ATDSSubTotal() has been created to SubTotal Sort Arraysfrom 3 different fields


Software Fixes

Aspen Petroleum Supply Chain V7.2 includes a significant number of softwarefixes that further improve the product.

Because of the number of defects fixed is large, the sections below contain aselect subset of all defect fixes. If you are interested in a particular defectthat you do not see listed here or want to see a more comprehensive list,contact your Support representative.

The sections below summarize the fixed defects, highlighting particular areasof interest.

Fixed Defects

Aspen PIMS V7.2This section describes the most significant software fixes to Aspen PIMS.

CQ Number Description Resolution

CQ00379467 Model that runs with XNLPfails when loading with newmatrix generator on tableABML

New matrix generator was mademuch more robust and capableof running more types ofmodels.

CQ00385549 Significant unexplainabledifferences between XLP andXNLP

CQ00365423 PIMS-AO model with externalfurnace model attached doesnot function correctly in thenew MG

CQ00360534 PIMS Multi-Start Multi-Start feature wasenhanced to improve itsselection of starting points andmade more robust to workeffectively for more types ofmodels.



CQ00318719 Model that runs in PIMS doesnot run when converted toPIMS-EE

Conversions of Excel-basedmodels to PIMS-EE wereimproved to remove problems.

CQ00382154 PIMS Adapter - Blend EventActivities missing in thepublished message

PIMS Adapter interfacesimproved for blend events andSupplyItems

CQ00379173 PIMS Adapter - SupplyItemsis not published

CQ00368332 XNLP Solver gets lower OBJFNand takes more time than DRwith specific PPIMS model

XNLP solver improvementsimplemented to reduceexecution time and to improvelikelihood of finding globaloptimum.

CQ00391781 Case Comparison Problems Problems with Case Comparisonreport have been resolved

CQ00388203 Not all cases submitted tooptimizer on case stack usingmultiple cores with newmatrix generator.

Issues when using >4 processorcores have been resolved.System now properly uses allallowable processor cores.

CQ00388067 ABML Correlation CARB3Mdoes not work with newmatrix generator

ABML CARB correlations havebeen expanded and enhancedfor working with the new XLPmatrix generator.

CQ00350031 Error in validation. Fixed many discrepanciesbetween the old matrixgenerator and the new XLPmatrix generator.

CQ00335574 Model is unbounded withPresolve on and takes 2 hourswith presolve off

Presolve problems with XPresssolver have been reduced.

CQ00356645 GUI issue with overlappingwindows

Occasional erratic performanceof V7.1 GUI has been reduced.

CQ00365052 GOMS Chart Minimum Y-AxisMinimum Setting

Global Optimization-Multi-Startchart has resolved issues withaxis scaling

CQ00317131 No penalty structures forplant/period spanningspecifications.

Penalty structures forspecifications that span plantsand periods have beenimplemented.

CQ00309310 VPRICE XPIMS has PeriodLength multiplied two timesinto Objective Function

Objective function errors whenusing VPRICE in XPIMS modelshave been resolved.

CQ00334538 Local Optima plus notreasonable infeas soln plusnot solv with xnlp

XNLP model issues for somemodels have been resolved.

CQ00368737 Tables Case/Expert notConverted to Extended TAGsby: Save Model to ExtendedTag Format Menu Item

Problems when convertingtables to Extended Tags forCASE and EXPERT have beenresolved.



CQ00369571 Preserve Orig Tag (Do NotAlias) if using Extended TagsOn

Made converting to and workingwith extended tags easier byallowing users the option to runexisting short tag models inextended tag mode withoutchanging the tag internally byselecting the "Preserve OriginalTag" option.

CQ00371778 PIMS EE Desc Column forMaterial Transfers View IsBlank

Loss of descriptions for materialtransfers when converting toPIMS-EE has been fixed.

CQ00364250 Performance of ExcelWorksheet I/O unacceptablein new XLP PIMS MatrixGenerator

Spreadsheet Gear has beenincorporated into PIMS to speedup input of Excel data. This isespecially noticeable when usingthe new XLP matrix generator.

CQ00399903 Eliminate (or make optional)the very large files generatedat run time (.xlr & .fil)

Generation of .xlr files andretention of .fil files have beenmade optional.

CQ00383699 Expose amended CARB3 Amended CARB3 correlationshave been implemented in AO

CQ00401541 T50 slack in PIMS T50 slack property variableshave been implemented.

CQ00388428 Check for open files whenstarting PIMS execution

PIMS now checks for open filesand warns the user whenstarting execution.

CQ00366268 Compare Model dialog cannotshow the full path in thecombo Box

The Compare Model dialog nowshows full paths in the combobox.

CQ00364747 Add a Program Option toClose Model upon exitingPIMS

A Program Option has beenadded to Close the Model uponexiting PIMS.


Aspen Petroleum SchedulerV7.2This section describes the most significant software fixes to Aspen PetroleumScheduler.


CQ00368342 Events read too slow Added option to use temp tablesto speed up event read

CQ00368343 PublishFromSets shouldperform immediately

Modified PublishFromSets tofinish before returning

CQ00395621 Usability Defects in the AuditInventory Dialog

Added additional propertyfiltering options. Prior settingsare remembered. Speedimprovement on populate simvalue. Flag differences in thesim and plant values

CQ00400226 Uniquely identify each openinstance of PetroleumScheduler in Running ObjectTable to choose which one toaccess through Automation

Register PS/MBO automationinterface to the running objecttable allowing you to select theparticular instance of Orion/MBOto attach to.

CQ00401258 Gantt Label unreadable andlink gantt bars aren't off set

Improve the look of Event view

CQ00391366 Add automation function tosimplify the audit inventorydialog

Added additional automationfunction to automate auditinventory dialog

CQ00400053 Allow Event Import to supportmultiple pipelines

Can now import SecondaryPipeline

CQ00392358 Archive model utility cannotbe automated.

Automation functions for theArchive model

CQ00358967 Trends default to 1000, don’tshow up

Multiple trends can now appearon same plot

CQ00362669 Log tables and events tabledoesn't support time zone

Added Config setting to use UTCtimestamp on events, schedule,model log and crudes to allowusers to spread across multipletime zones


Aspen Refinery Multi-BlendOptimizer V7.2This section describes the most significant software fixes to Aspen RefineryMulti-Blend Optimizer.


CQ00287659 MBO v5.2.29 - Model >Beginning Inventories - DialogDifficult to Use

Enhancement to the Beginninginventory dialog

Aspen Olefins Scheduler V7.2This section describes the most significant software fixes to Aspen OlefinsScheduler.


CQ00396001 Multiple Event Editor isincorrect for Furnace BankRun events.

Multi-Event Editor dialog boxhas been enhanced to handleFurnace Bank run events.


Known Issues

Below are the known issues associated with Petroleum Supply Chain V7.2products.

Aspen PIMS

Below are issues specific to V7.2

PIMS AO on a 64-bit operating systemAfter installation, for PIMS AO, utilizing parallel processing, to runcorrectly under a 64-bit operating system, you will need to modify thePATH environment variable from:

<drive>:\Program Files\MPICH2\bin

to the following:

<drive>:\Program Files (x86)\MPICH2\bin

Aspen Petroleum Scheduler

Below are issues specific to V7.2

Character tags sent to unit.xls and automation functions will no longerbe padded to four (4) characters with spaces. This is in preparation forlong tag support in V7.3. The consequence is that Excel lookups usingVLOOKUP/HLOOKUP/MATCH, where strings are matched, should now betrimmed. Also please check your orinvb.dll for similar string matchingissues.

Crude run events associated with a crude unit that has parameterswill be clipped so that no two (2) events will overlap. This is necessarybecause only one set of parameters can be active at any given time. Ifthe crude unit does not have parameters, these events will not be clipped.Set the CONFIG setting CLIP_CRUDE_RUN_EVENT to ‘N’ to suppressclipping regardless of whether the unit has parameters. The default is ‘Y’.


Aspen pETSup

Documents

aspen technology

aspen pims

aspen petroleum scheduler

aspen olefins scheduler

aspen refinery report

aspen leaf logo

aspen petroleumsupply

prior consent of aspentech