SIS Education: Building Financial Models For Merak Petroleum Financials
SIS Education: Building Financial Models For Merak Petroleum Financials
SIS Education: Building Financial Models For Merak Petroleum Financials
September 2007
COPYRIGHT
The information in this document is subject to change without notice. The software described in this document is
furnished under a license agreement. This software may be used or copied only in accordance with the terms of such
agreement. It is against the law to copy the software on any medium except as specifically allowed in the license
agreement. No part of this document may be reproduced or transmitted in any form, or by any means, electronic or
mechanical, including photocopying and recording, for any purpose without the express written permission of
Schlumberger.
Merak PetroDesk™, Merak Portfolio™, Merak Decision Tool Kit™, Merak VOLTS™, Merak Budget™, Merak
Capital Planning™, and FieldView™ are trademarks of Schlumberger.
BackOffice®, Internet Explorer®, Windows®, Windows 98®, Windows NT®, Windows 2000®, MS-DOS®,
Word®, Excel®, ActiveX®, ODBC®, OLE®, COM®, Terminal Server®, Microsoft Access®, Visual C++®, and
Microsoft SQL Server® are registered trademarks of Microsoft Corporation.
All other names and trademarks are the property of their respective owners.
Assign user access using the Merak Administration Console (MAC) ....................2
www.merak.com 1
Building Financial Models for Petroleum Financials
In this case, the Administrator is preparing to assign permissions for the result
request object type.
3. Click the Users tab, then click the New button to open the User Details dialog
box. You must create users before anyone can log onto any Merak application
administered by the MAC. Fill in the information required to add a user, then
click Save. Repeat this step to add any other new users.
Tip: If creating many users that share the same database settings, select a user
and click the Copy User button, then use those settings as a base to create each
new user.
4. Click the Groups tab if you want to create groups of users, and apply
permissions to those groups instead of to individual users.
5. Click the New button to create a new group, then select that group and click the
Members button the Group Members dialog box. To add a member to the
www.merak.com 2
Building Financial Models for Petroleum Financials
current group, select the member from the Non-Member list and click the Add
button. Click Save to save the contents of the current group.
In this case, after adding the “Merak” user to the “ResBroUsers” group, the
Administrator can assign permissions to all group members in one step.
6. Click the Object Types tab to assign permissions for individual users or groups
to manipulate different types of objects. If you do not assign permissions for a
particular object type (e.g. Financial Hierarchies), application users will not be
able to manipulate (or even view) that type of object.
7. To assign permission for a particular type of object (e.g. Financial Hierarchies,
Peep cases), select an application from the Application Filter drop-down list to
view all the object types available for that application. Then select an object type,
and click the Permissions button to open the Permissions dialog box.
8. Add a user or group to the Grantees list, then click on that user or group in the
list, and select or clear the check boxes next to the permissions you want to grant
or deny the user or group for that object type.
www.merak.com 3
Building Financial Models for Petroleum Financials
Tip: You must set permissions for all the Peep, Results Broker and Petroleum
Financials object types.
9. Click the Programs tab to assign permissions for individual users or groups to
access Merak applications.
10. To assign permissions for an application, select it from the Program list, and
then click the Permissions button. Add a user or group to the Grantees list, then
click on that user or group in the list, and select or clear the check boxes next to
the permission you want to grant or deny the user (in this case, granting the
Execute permission allows the selected user to launch the application.
www.merak.com 4
Building Financial Models for Petroleum Financials
3. Type a name and select a month-to-year conversion type for your variable, and
then click OK to create it.
4. Click the Save button in the Time Series pane to save your variable (you can
skip this step and map your variable, then save later if desired).
Note: If you need to create many variables, you can save time by creating multiple
variables at once, based on the Peep model variables within a given model. See
www.merak.com 5
Building Financial Models for Petroleum Financials
“Creating multiple variables based on Peep model variables” in Results Broker Help
for more information.
After selecting the cell that corresponds to the Canadian Model, the user has
navigated to the Revenue group in the Current Model Variables list, and will
map to the Gas1 Revenue model variable by double-clicking it.
Tip: After mapping a variable to one model, you can copy that mapping to all the
other models if desired (e.g. in the illustration above, after mapping the Gas Revenue
variable to the Canadian Model, you could copy that mapping to all the other
models). See “About copying variable mappings between Peep models” in Results
Broker Help for more information.
www.merak.com 6
Building Financial Models for Petroleum Financials
In this case, the Administrator has selected two evaluations, and will add them to
the result request by clicking the Add button (above).
4. If creating a deterministic result request, click the Global Outcomes node and
select the desired project-outcome scenarios and price scenarios for your request.
5. If creating a simple stochastic result request, click the Global Price Outcome
Set node and add any desired outcomes to the Global Price Outcome Set,
assigning a probability to that outcome and selecting the desired price scenarios
for each product.
6. Open the Outcomes Validation pane:
For a deterministic request, use this pane to review the scenario selections
from the Global Outcomes pane before you generate request data, and to see
if each of the Peep cases included in the request contains data for the selected
scenarios;
For a simple stochastic request, use this pane to create or edit evaluation
outcomes, and to validate each evaluation against the global price outcome
set. The scenario choices in the outcomes of the evaluation outcome set do
not require validation, since the scenario names that appear in the drop-down
lists for each data type are only the scenarios that actually exist in the Peep
case. Each case included in the request should contain outcome and price
data for the selected scenarios before you generate the request results.
7. Generate the result request by right-clicking it and choosing Generate Results
Data.
www.merak.com 7
Building Financial Models for Petroleum Financials
www.merak.com 8
Building Financial Models for Petroleum Financials
www.merak.com 9
Building Financial Models for Petroleum Financials
the main working area, which includes a tab for each model or calculator that
is currently open. When a model is opened it is displayed in the Model
Syntax Editor, where you can manually input or edit the model text. When
you open a Calculator for a model, it also opens inside the working area);
the Properties pane, which displays details about items selected in the
Model Syntax Editor, and allows you to modify the properties of those items.
You can also create or edit content using the Properties pane, without having
to manually type the model syntax;
the Hints window, which displays information about the currently selected
component. All windows have “pinning” and “docking” capabilities.
www.merak.com 10
Building Financial Models for Petroleum Financials
2. Set user Preferences for the Model Builder. These settings apply to both the
Model Syntax Editor and the Calculator.
Using the Model Explorer, you can create multiple folders and sub-folders to
quickly organize and categorize models.
3. Select the level at which a new folder should be added, then right-click and
choose New Folder. The folder is added and can be renamed as needed. Folder
names must not include spaces or other special characters.
www.merak.com 11
Building Financial Models for Petroleum Financials
4. Click New in the Model Explorer to open the New Model dialog box. Type a
name and click OK. The Model Syntax Editor opens.
The Model Syntax Editor displays the variable hierarchy on the left, which allows
you to organize your variables. The right side of the Editor contains the actual
model text, beginning with the model’s name and opening/closing curly braces,
and the yellow syntax error pane, which displays any errors generated by the
syntax.
Note: to be valid, all variables in the model must be contained within these curly
braces, with each line of the model ending in a semi-colon.
5. Select the Constants, Inputs, or Results folder in the variable hierarchy, right-
click and choose Add Variable. A new variable definition is added to the syntax
pane, with a default variable type, shape, name, and value (constant or result
variables), all of which can be edited as required.
You can edit the inserted text to change a variable’s type, shape, attributes,
iteration settings, conversion strategy, and periodicity.
www.merak.com 12
Building Financial Models for Petroleum Financials
Defining variables
There are two methods of defining the model variables:
Modeling using properties
Modeling using syntax
www.merak.com 13
Building Financial Models for Petroleum Financials
After you have declared the external variable type and the shape, press
<Ctrl>+<Space> to open the Autolist, and choose “attribKey: “attribValue””.
Replace the “attribKey” text with “name”, and the “attribValue” text with the name
of the variable as it appears in Results Broker. This must be done for every external
variable referenced in the model.
If Results Broker time-series variables are to be rolled up in an aggregate or asset
model, the type must be specified as ‘External’, with the variable type defined as
“collection” to indicate a rollup of time-series data and the name attribute being used
to defined the Results Broker variable display name.
Revenue collection name:"Total Revenue" total_revenue;
Revenue series SumOftotal_revenue = Sum(total_revenue);
This rollup or aggregate model can then be inherited in financial models at higher
corporate levels to ensure that the Results Broker variables are rolled up at each
hierarchy level. This will avoid having to redefine rollups of Results Broker variables
in financial models at higher corporate levels.
Note: a model can inherit no more than one other model.
DemoCountry inherits DemoRollup
www.merak.com 14
Building Financial Models for Petroleum Financials
Reusable models
Several common operations can be saved as independent models and referenced by a
larger model through the reusable model functionality. There is no restriction on the
number of reusable models that can be referenced by another financial model.
An example of a reusable model is the basic Account concept, with an opening
balance, some movements in the account, followed by a closing balance for the
account. In the Model Builder this can be created as:
Account
{
Cashflow scalar OpeningBal;
Cashflow series Movements;
Cashflow series OpeningBals = SpecifyFirstValue(OpeningBal, ClosingBals[-1]);
Cashflow series ClosingBals = OpeningBals + Movements;
}
This Account reusable model can then be referenced in another model by giving it a
set of required inputs so that it will return the necessary results. In this case, the
Account reusable model must be given two inputs (an opening balance and a
movement of the account) in order to return two results (an opening and a closing
balance).
www.merak.com 15
Building Financial Models for Petroleum Financials
// Accounts
Cashflow series Cash_At_Bank_Account_OB_S;
Cashflow scalar Cash_At_Bank_Account_OB = ValueAt(Cash_At_Bank_Account_OB_S);
Cashflow series Cash_At_Bank_Account_MVT = Net_Cash_From_Operations +
Net_Cash_From_Financing + Net_Cash_From_Investments;
Cashflow series Cash_At_Bank_Account_OBS =
Account.OpeningBals(Cash_At_Bank_Account_OB, Cash_At_Bank_Account_MVT);
Cashflow series Cash_At_Bank_Account_CBS =
Account.ClosingBals(Cash_At_Bank_Account_OB, Cash_At_Bank_Account_MVT);
www.merak.com 16
Building Financial Models for Petroleum Financials
www.merak.com 17
Building Financial Models for Petroleum Financials
You can then drag result variables from each model into the Calculator, where
the dependent variables are displayed with associated input grids (multiple time
periods for a series input, single time periods for a scalar).
www.merak.com 18
Building Financial Models for Petroleum Financials
4. Use the options on the right side of the Choose Result Request dialog box to
define how you want to retrieve data from the selected result request (note that
you can change only the Start Date year and number of years of data. All the
other fields in this dialog box are for information purposes only and cannot be
changed).
5. Click OK when finished making your selections:
If you selected a simple stochastic result request, the Select Price Outcome
dialog box opens (go to step 6);
If you selected a deterministic request, the Select Model dialog box opens
(go to step 7).
6. If you selected a simple stochastic result request for the new hierarchy, select one
of the available price scenarios from the list in the Select Price Outcome dialog
box and click OK.
www.merak.com 19
Building Financial Models for Petroleum Financials
The Select Model dialog box opens. This dialog box is populated with all the
global price outcomes that were created in Merak Results Broker for the selected
simple stochastic result request.
7. From the Select Model list of available financial models (which includes models
at the asset, regional, and global levels), select a financial model to attach to the
top-level node in the new hierarchy (usually the global or corporate model), and
click OK.
The Financial Hierarchy window opens, displaying the new hierarchy on its
own tab.
To add an evaluation node, select a node from the Dynamic Result Request
pane and drag it onto a node in the Financial Hierarchy pane. Then attach a
model to the node and click OK.
www.merak.com 20
Building Financial Models for Petroleum Financials
In this example, the Hierarchy Manager was used to organize the contents
of the Dynamic Result Request pane. See “Using the Hierarchy Manager”
in Merak Petroleum Financials Help for more information.
www.merak.com 21
Building Financial Models for Petroleum Financials
www.merak.com 22
Building Financial Models for Petroleum Financials
4. Right-click anywhere on the User Reports tab and choose Template ⇒ New,
then one of the following:
Single-Period Chart;
Time-Series Chart;
Time-Series Report.
5. If creating a chart, drag a variable from the bottom-left pane onto the report, as
shown below.
In this example, the user is adding a new series based on the Other Revenue
variable to a time-series report, by dragging the variable onto the report.
6. If creating a time-series report, add any desired blank lines or text lines to the
report, or add data lines by dragging variables from the bottom-left pane onto the
report grid. You can define how the report will look, insert text or blank lines
into a report, or move lines. See “Creating user reports or charts” in Merak
Petroleum Financials Help for more information on adding lines, formatting, etc.
7. If creating a chart, you can manipulate it in various ways, such as adding a title or
point labels, changing the display type, etc. See “Manipulating user charts” in
Petroleum Financials Help for more information. For single-period charts, you
can define what period to show in the chart, or how information is presented on
the chart.
8. Copy the chart or report to the Windows Clipboard if you want to paste it into
another Windows document:
For charts, right-click and choose Copy to Clipboard, and then the desired
format;
For reports, right-click and choose Report ⇒ Copy.
Open a Windows document and paste the graphic or text from the Clipboard into
the document.
9. Print a report if desired by right-clicking it and choosing Report ⇒ Print; to
print a chart, right-click it and choose Print.
www.merak.com 23
Building Financial Models for Petroleum Financials
10. Link one or more additional models to the template (page 25) if desired.
Afterwards, if you select a node in the hierarchy, any report or chart templates
linked to the model attached to that node will be used to generate a chart or report
based on the node's data.
Note: When you create a report or chart, the model that was attached to the
currently selected hierarchy node is automatically linked to that report or chart.
11. Create a template (below) based on the report or chart you just created (optional)
if you want to use this chart or report for other nodes in the hierarchy.
In this example, the user has added the Pecos Area 1 Acquisition node to a hierarchy,
attaching it to Gas Model 1. He then creates the Revenue Chart and Revenue Report
templates, linking both of them to Gas Model 1. When he selects the Pecos Area 1
Acquisition node in the hierarchy, a chart and a report based on his templates are
displayed for that node.
www.merak.com 24
Building Financial Models for Petroleum Financials
4. To link a model to the current template, navigate to it in the Available box, then
drag and drop it onto the Selected box (above). Repeat this step to link any other
models to the current template.
Tip: To break the link between a given model and the current template, drag the
model from the Selected box onto the Available box.
www.merak.com 25
Building Financial Models for Petroleum Financials
5. Click OK to close the dialog box and link the model(s) to the template. Or, click
Cancel to close the Template Model Links dialog box without saving any
changes.
6. Right-click the chart or report and choose Template ⇒ Save to save the
template, preserving any newly created model-template links (since you
previously saved the template, you will not be prompted to provide a name.
7. If you try to select another user report or chart sub-tab (or create another report or
chart) without saving the changes, Petroleum Financials prompts you to do so.
Once you link a model to a template and save the changes, the next time you select a
hierarchy node attached to that model, the template will be used to generate a chart or
report based on the node's data. Each chart or report appears on its own tab inside the
User Reports tab.
www.merak.com 26