22
i | Page Models Maintenance Application

Models Maintenance Application - PHDWin · 2 | P a g e PHDWin Level 1 – User Certification Manual REGISTERING THE MODELS MAINTENANCE APPLICATION Once you have installed the software,

  • Upload
    hakhanh

  • View
    214

  • Download
    0

Embed Size (px)

Citation preview

i | P a g e

Models Maintenance Application

1 | P a g e

THE MODELS MAINTENANCE APPLICATION

The Models Maintenance Application is a companion application to PHDWin that is available for free. It is designed

to allow users to better create, manage and edit their Models, Scenarios, Cash Templates, and Authenticated

Users.

INSTALLING THE APPLICATION

You can download the Models Maintenance Application from www.phdwin.com/updates.php.

If given the option to Save or Open the file, choose Save. Select any desired folder on the computer to place the

install file, and click the Save button. Once the file download is complete, browse to the downloaded zip file

(PHDModels_2.9_Setup.zip) and then extract the msi file from the zip file. Then double click the msi file to begin

the installation. Follow the instructions in the installation wizard to complete the installation of the Models

Maintenance Application.

Once installed, the Models Maintenance Application does not require PHDWin to be open, or even installed, on

your computer to fully utilize the program. The Models Maintenance Application does require its own license to

use permanently.

2 | P a g e

PHDWin Level 1 – User Certification Manual

REGISTERING THE MODELS MAINTENANCE APPLICATION

Once you have installed the software, the program will operate for a 10 day trial period. During that 10 day period,

users must register the software to get a free permanent license or the trial license will expire, and users will not

be able to continue working in the program.

To register the product:

1. Click Help – Registration from the main menu bar at the top of the window or click the Register button on

the initial splash screen:

2. Fill in the information form.

3. Verify that the System ID Field is populated (this field is grayed out, but should have an alpha-numeric ID

visible inside). If not, contact Technical Support.

4. If the System ID is present, click . This should open an email, ready to send to

[email protected].

Verify that the information from the form, including the system ID, is present in the email, and click Send.

If the data is missing or the email window does not open, copy the information into an email (including the system

ID) and send it to [email protected].

MODELS MAINTENANCE MENUS

FILE MENU

This File menu option in the top left of the application window has the following options:

Open Existing – Allows the user to select a models file to be opened. Multiple models files may be opened

at the same time.

Authenticate – Allows the user to enter the correct User Name and Password to access password

protected Cash Templates. This option does nothing if the models file is not password protected.

3 | P a g e

New – Allows the user to create a new models file. The new models file will automatically be created as a

copy of your default models file, as defined in your System Preferences in PHDWin. You get to choose

where the models file is saved and what it will be named.

Delete – Allows the user to delete a models file.

Exit – Exits the Models Maintenance Editor window and closes all models files.

Note: Unless you request a license with PSC Admin Security enabled there will not be an

Authenticate option under the file menu nor will you be able to access security features in the

program.

WINDOW MENU

The Window menu option in the top left of the application window has the following options:

Tile – This will give all of the open windows an equal share of the application window. It makes it easy to see all of the open models files, and drag and drop from one to another because they are all visible.

Cascade – This option will cascade the open windows from the top left corner so that the title bar of all open windows are visible. This option can be useful when you are looking to find a particular models file window.

VIEW OPTIONS

The Models Maintenance Application has four view options located at the top of the application window on the

View Toolbar:

Models – Switches to the Models View which allows the user to edit, create and delete models.

Scenarios – Switches to the Scenarios View which allows the user to create, edit, share and delete scenarios.

Cash Formula – Switches to the Cash Formula View which allows the user to share Cash Formula Templates between models files.

Users – Switches to Authenticated Users View for use with password-protected Production Sharing Contracts (PSC) (also known as Cash Templates) within PHDWin. This view is described in detail in the PSC (Cash Templates) Admin Security Manual and is not covered in this manual.

Note: Unless you request a license with PSC Admin Security enabled there will not be a

Users button on your toolbar nor will you be able to access security features in the program.

5 | P a g e

MODELS VIEW

The models view of the Models Maintenance Application looks, and functions very similarly to the models window in PHDWin. It is

used to create, edit, delete and share individual models.

MODELS VIEW TOOLBAR

Save – This icon will save any changes that you have made to the models file.

Save As - This icon will allow you to create a new models file by saving the current file under a new name and/or

location on your computer.

Print – This icon will send the Models to the report window, which will allow you to print out the models that are

listed in the file. When you click the button the program asks if you want to print “All” or “Current”. If you select

“All” it will output a printout of every model in that file. If you select “Current” it will output a printout with just

what you currently have selected (category, product group, or individual model).

Insert – The Insert icon works like the button in PHDWin Models Editor. Clicking this icon has a

different effect depending on what you have selected in the models window.

If you have a Category selected it will ask you to create a new Product Group name for the Category.

If you have a Product Group selected it will ask you to create a new model name.

If you have a model selected or a segment of a model selected it will insert a new segment into the

selected model below what you have selected.

Delete – This icon allows the user to delete the selected item(s) in the models file. This is a permanent delete, and

cannot be undone.

Select – This option will open the Mass Select window, allowing you to select (highlight) models based on a given

criteria.

Deselect – This will deselect all models in the file that are currently selected (highlighted).

Expand – This option works like the individual plus signs located next to the models, but will expand out all levels

under what you have selected on the tree.

Contract - This option works like the individual minus signs located next to the models, but will contract all levels

under what you have selected on the tree.

6 | P a g e

Manual

CREATING AND EDITING MODELS

Creating models in the Models Maintenance Application is very similar to creating them in PHDWin.

The models in the file are broken down into major Categories, such as Price Models, Fixed Costs, Well Costs, Depreciation, Taxes etc.

Categories may not be created, deleted or edited.

In the individual categories there are Product Groups under which are the individual models. You can create new Product Groups by

selecting the appropriate Category in the models window tree then hitting the insert button. Please note that Product Groups must

be named the exact same thing as a product in the PHDWin Products Tree in order for the models in that Product Group to be

applicable to that product in PHDWin.

For instance, models in the Product Group LIQUIDS cannot be applied to an NGL product in PHDWin even though NGLs are a liquid.

Only models built under the NGL Product Group can be applied to the NGL product.

EXAMPLE: CREATING A NEW PRICE MODEL

1. Expand the “Price Models” Category under which the model is to be created.

2. Highlight the Product Group for the type of model that you want to create. For example, to create a pricing model

for GAS; highlight the GAS Product Group under the Price Model Category and press the button.

3. Name the model, then hit OK. Expand the new model.

4. Double-click on the grey line labeled “$0.00/unknown” to begin the first segment.

5. Select the beginning date of the model. You can chose to have the model beginning tied to a hard coded date or a

linked date. Each pricing segment can last for a specific number of months or continued until the ECL. To insert

more than one segment, un-check the Until ECL box and enter the number of months that you want this segment

to last. Then hit the save button to save the model or the model segment.

6. To insert additional segments, select a segment in a model and hit the button. When you insert another

pricing segment, the starting date will be calculated for you given the beginning date and the number of months of

the previous segment.

7. Continue inserting segments until all the desired segments have been entered. The final segment should have the

Until ECL box checked.

7 | P a g e

SHARING MODELS BETWEEN MODELS FILES

Sharing models between two models files is as easy as drag-and-drop. Open the models files you wish to share (copy) models

between.

Position the windows side by side, and drag the desired model from the source models file to the destination models file.

You can drag entire Product Groups and whole Categories between the open models files as well. Doing so will append new models

into the existing files, and update any models that the two files have in common. It will NOT delete or change any models that

existed in the destination file, but not in the source file.

ADD DEFAULTS

Clicking the button at the bottom of the Models File window will open the window pictured to the right. This

window allows the user to load in the default models that come with PHDWin.

The user has the option of loading in all of the default models, or to load just those models from the selected model categories.

Loading the defaults will not delete, or change any custom models that have been created in

the file, unless those custom models are using identical names to the default models that are

being loaded in.

8 | P a g e

Manual

DEFAULT MODELS TABLE

Here is a listing of the default models that will be loaded into the models file by the button:

Model Category Product Name Model Name

Price Models OIL WTI Crude

Price Models OIL $24 then $26

Price Models OIL $15 constant

Price Models GAS Spot

Price Models GAS Onshore Gulf Coast

Price Models GAS Offshore Gulf Coast

Price Models GAS $2.00/24 mon, then $2.50

Price Models GAS HENRY HUB

Price Models LIQUIDS $1.00/gal constant

Price Models SALES GAS $2.50/mmbtu constant

Scheduled Well Expense WELL COST Shallow, Dry Gas

Scheduled Well Expense WELL COST Platform ($15,000/well)

Scheduled Well Expense WELL COST Gulfcoast ($1500)

Scheduled Monthly Expense FIXED COST Low Overhead ($250)

Scheduled Monthly Expense FIXED COST High Overhead ($1500)

Scheduled Monthly Expense FIXED COST Fixed Plant Overhead

Scheduled Monthly Expense FIXED COST Fixed Platform Costs

Op Cost Models GAS $.07 Gas Lift

Op Cost Models GAS Plant Process Fee

Op Cost Models WATER $1.25 Salt Water Dsp

Tran Cost Models GAS $.15 Line Charge

State Tax Models All Products All States Severance Taxes

Local Tax Models COMBINED All Ad Valorem Taxes

Escalations Any Product SEC Case (flat)

Escalations Any Product Constant 2%

Escalations Any Product Flat/12 mon, then 3%

Escalations Any Product Increase $.50 per year

Escalations Any Product Flat/48 mon, then 1.5%

Depreciation Investment Categories Equipment 7-yr(US)

Depreciation Investment Categories Equipment 5-yr (US)

Depreciation Investment Categories Class 1

Depreciation Investment Categories Class 2

Depreciation Investment Categories Class 10

Depreciation Investment Categories Class 29

Depreciation Investment Categories Class 39

Depreciation Investment Categories Class 41

Depreciation Investment Categories CDE

Depreciation Investment Categories CEE

Depreciation Investment Categories COGPE

If the Models Maintenance Application determines that there is a model with the same name as one of the default models, it will prompt the user to “Replace” or “Skip” the model. Choosing “Replace” will overwrite the model in the file with the values in the default model. “Skip” will keep the previous model intact as it was.

9 | P a g e

GLOBAL MODIFY

The Models Maintenance Application has its own version of the PHDWin Global Editor that is opened by pressing the

button. This editor window allows the user to quickly make changes to a model, or a group of models.

Before hitting the button the user must select the models they wish to edit. Multiple models may be selected by

holding the Ctrl key and clicking on the desired models. Selecting any branch of the models tree will automatically include all of the

sub branches beneath.

The Fields to Change section located in the upper left corner allows the user to specify what changes are to be made to the models.

Each option that is selected will activate its corresponding section on the Global Editor window.

10 | P a g e

Manual

Adjusting Values – The Values section of the Global Editor allows the user to adjust the amounts found in the models. The user first

specifies which value they are going to change:, the Value, the Percent or the Cap. Depending on the model type some options may

not be relevant. For instance, Price models do not have a Percent field, whereas Escalations and Taxes do.

Secondly the user selects what type of change is to be made. A Percent Difference will multiply the existing values by the Amount To

Change, whereas an Absolute Difference will add or subtract the Amount to Change from the existing values.

Beginning Date – The beginning dates of models may be edited globally through this option. The user may specify that the model’s

first segment is tied to either a hard coded date or a linked date. This option will ONLY affect the first segment’s start date. All other

segments will adjust accordingly.

# of Months – This option will adjust the duration of the segment to a specified number of months.

Misc. – The miscellaneous section offers options that are specific to certain model categories not covered in other sections

Currency and Units – Allows the user to change the currency and or units that the models are using.

Escalations – Gives the user access to options that are specific to escalation models (such as escalating by a percent or escalating by

a specific value).

EDITING MODELS IN EXCEL

Perhaps one of the most beneficial tools in the Models Maintenance Application is the External Editor in Excel. It works just like the

Edit Data in Excel in PHDWin, but it allows you to edit your economic models.

It is recommended that you make a copy of your existing models file before loading data back into the Models Maintenance

Application in case you change something that you were not intending to change.

TO TAKE YOUR MODELS TO EXCEL:

1. Click the button at the bottom of the models window. 2. Select the Category you wish to take out to Excel. 3. Click Edit.

This will open all the models in that Category in Excel allowing you to edit, delete and add new models using the functionality of

Excel. The data that was exported is on the sheet labeled "ExtEdit". Make modifications to this sheet taking into account the color

coding format for different columns as explained below.

11 | P a g e

Users can save the exported data to a different worksheet, manipulate the data, and then copy modified data to existing "ExtEdit"

spreadsheet. Columns cannot be deleted or inserted within the "ExtEdit" spreadsheet. Create a copy of the existing sheet if it is

necessary to insert/delete columns.

COLOR CODES IN EXCEL

The color codes found in each Excel column are used to specify what the user can and cannot do with the data. The External Edit

through Excel option is a powerful tool but there are some rules that must be followed for the editor to function properly. Those

rules are color coded on the Excel spreadsheet to make it easier for users to follow them:

Brown – Model Segment Field- NO CHANGES will be reflected when data is loaded back into PHDWin. Model segments are automatically determined by the timing specified in the Date column. The Model Segment Field is just there for reference.

Red - Model ID Key Field - Leave blank when adding a new model, but make sure it matches a model you are editing if you are adding in new segments to an existing model with new rows.

Blue – Major Fields - Must be populated with proper data in order to load data into the Models Maintenance Application. Please note for the Date Key field that models cannot have gaps in their timings and if you have a timing gap the changes might not be accepted when you pull back in the data from Excel.

Black - Any data represented here will be loaded into the Models Maintenance Application as is.

Note: The Date (Key) Field can either be populated by hard coded dates or linked dates.

LINKED DATES

Linked dates can be entered where allowed in following format:

LinkType+Segment Length

LinkType Can be one of the following: AsOf, MajSeg1, MinSeg1, MajDecl1, ProdSeg1, FirstProd, StartHist, EndHist Segment Length Must be positive integer for the number of months. Will determine the length of the segment prior to this

linked date segment

Examples:

- This project's As Of date, plus 24 months in the previous segment

- Start date of 1st segment of Major Phase projection

- This product’s 1st segment of Major Phase projection, plus 12 months in the previous segment:

12 | P a g e

Manual

13 | P a g e

EXAMPLE: CREATING A NEW PRICE MODEL IN EXCEL

To create a new price model, you would need to start by entering a new row in the spreadsheet. All of those columns that are blue,

such as Product, Model Name, and Date are required. To create a price model with the new row in Excel:

1. Enter the name of the Product Group that this price model will be applied to in column A.

2. Enter the name of the model itself in column B.

3. The red Model Key in column C MUST BE LEFT BLANK in the newly created row.

4. Enter the date which this price segment is to begin in column D.

5. Enter the currency (i.e. $, $C, Yen) in column F.

6. Enter the product units for this price in column G.

7. Enter the Cap Price in column H.

8. Enter the Gravity Link (i.e. the Search BTU or Search Gravity value) in column I.

9. Enter the Price in column J.

10. Repeat for additional segments in the price.

Note: PHDWin will automatically set the last segment of any new price model to last until the ECL.

BRINGING BACK CHANGED DATA

To bring your changes back to the models file, close Excel by either clicking the X in the upper right corner, or by selecting Files | Exit

from the menu at the top.

When you return to the Models Maintenance Application you will be prompted with a window that asks you to confirm that you

wish to bring the changes into the Models Maintenance Application. Answering NO will cancel all changes made in Excel and those

changes will be lost. YES will bring the changes into the Models Maintenance Application and update the information in the project

file.

When data is loaded back into the Models Maintenance Application, if coding is not correct it may cause data to be erased. For

example, if you export Pricing models and change the Product Groups on a number of models but misspell the product (ie. GSA

instead of GAS) the External Editor will create a new Product Group and the models will no longer be in the correct product group:

14 | P a g e

Manual

COMPARING MODELS

Clicking the button at the bottom of two Models File windows will allow you to compare the models in those files

directly in the Models Comparison window:

This window is color-coded to provide visual cues to users regarding the differences in the two model trees:

In the Models comparison window you can drag and drop whole Categories, entire Product Groups, or just individual models

between the two trees. Doing so will append new models into the existing tree, and update any models that the two files have in

common. It will NOT delete or change any models that existed in the destination file but not in the source file.

15 | P a g e

Any changes that occur in the Model Comparison window are not saved until the changes are accepted. Clicking the

button at the bottom of the Models Comparison window will save any drag and drop changes and reload the

models files in the Models Maintenance Application.

SCENARIOS VIEW

Scenarios View allows you to create, delete, and share economic scenarios. This window functions almost identically to the scenarios

window found in the main PHDWin application.

CREATING A SCENARIO

To create a Scenario:

1. Click the Insert button located at the top of the window. 2. Give the scenario a name. 3. Drag the desired models from the tabs on the right to the new scenario on the left.

ADDING DEFAULTS

The Add Defaults button allows the user to lad in the default scenarios that come with PHDWin.

The Structure Only option will load in the default scenario names, but create them as empty scenarios to be populated by the user.

The Include Models option will load in the default scenarios, as well as any models that those scenarios require.

17 | P a g e

CASH FORMULAS VIEW

This view of the Models Maintenance Application is used to share Cash Templates between models files. Cash

Templates are a collection of equations, called cash formulas, and variables created by the users in PHDWin. Cash

Formulas are used for a number of complex modeling situations, including the modeling of international contracts.

Directions to create and edit cash formulas can be found in the Basic Cash Formulas Manual.

Cash Formulas may not be edited or created in this application, but they may be shared between models files

through drag and drop. Cash Templates that are protected by the PSC Admin Security feature cannot be viewed or

dragged and dropped into a different models file unless a proper User name and password is given when you first

open the models file or by selecting the option Authenticate underneath the file menu:

If a protected models file cannot be authenicated then you will be able to see what Cash Templates are in a models

file but not the components of those templates such as its cash formulas or static variables. If you try to drag and

drop from a non-authenicated models file the program will prevent you from doing so:

ADDING DEFAULTS

Clicking the button at the bottom of the Cash Templates window will add the pre-defined

templates to the Cash Template Regimes of TRC Default Elements and TRC Sample Contracts:

18 | P a g e

PHDWin Level User Certification Manual

Here is a listing of the default Cash Templates that will be loaded into the models file by the button:

Regime Template Name

TRC Default Elements CapitalTax

TRC Default Elements COPAS Paid

TRC Default Elements COPAS Received

TRC Default Elements Cost Recovery Pool

TRC Default Elements Cum Tranche

TRC Default Elements Custom Depreciation

TRC Default Elements Date Tranche

TRC Default Elements Economic Indicators

TRC Default Elements Income Tax

TRC Default Elements Investment Factor

TRC Default Elements Net Multipliers

TRC Default Elements Net Profits IRR Reversion

TRC Default Elements Payout Tranche

TRC Default Elements Pie Chart Display

TRC Default Elements Prod Payment Fixed/Unit

TRC Default Elements Prod Payment Percent Diff

TRC Default Elements Production Tranche

TRC Default Elements Profit Oil

TRC Default Elements R Factor

TRC Default Elements ROR Tranche

TRC Default Elements Royalty

TRC Default Elements Severance Tax Holiday

TRC Default Elements Tax Over Price Cap

TRC Default Elements Uplift On Investment

TRC Sample Contracts Angola 1989 Model PSC

TRC Sample Contracts Denmark

TRC Sample Contracts Indonesia "The First PSC"

TRC Sample Contracts Netherlands

TRC Sample Contracts Norway

TRC Sample Contracts Russia Sakhalin II

TRC Sample Contracts United Kingdom

If the Models Maintenance Application determines that there is a template with the same name as one of the default templates, it will prompt the user to “Replace” or “Skip” the template. Choosing “Replace” will overwrite the template in the file with the values in the default template. “Skip” will keep the previous template intact as it was.

19 | P a g e

CASH FORMULA MEMOS

Clicking the button at the bottom of the Cash Templates window will allow you to view the memos

entered for a Cash Template.

There is no way in the Models Maintenance Application to edit these memos.

COMPARING TEMPLATES

Clicking the button at the bottom of two of the Cash Templates windows will allow you to compare

the Cash Templates in those files directly in the Cash Templates Comparison window:

This window is color-coded to provide visual cues to users regarding the differences in the two Cash Template

trees:

20 | P a g e

PHDWin Level User Certification Manual

In the Cash Templates comparison window you can drag and drop whole Regimes or just individual Cash Templates

between the two trees. Doing so will append new Cash Templates into the existing Regimes, and update any Cash

Templates that the two Regimes have in common. It will NOT delete or change any Cash Templates that existed in

the destination file but not in the source file.

Any changes that occur in the Cash Templates Comparison window are not saved until the changes are accepted.

Clicking the button at the bottom of the Cash Templates Comparison window will save any drag

and drop changes and reload the models files in the Models Maintenance Application.

EVALUATION ORDER

Clicking the button at the bottom of the Cash Templates window will allow you to view the

Evaluation Order for individual Cash Templates.:

The Evaluation Order may not be edited in this application. In order to edit the Cash Formula Evaluation rules, you

must use PHDWin.

AUTHENTICATED PSC USERS

Clicking the button at the bottom of the Cash Templates window will allow you to view which users

have what level of access with each cash template:

This feature is described in detail in the PSC (Cash Templates) Admin Security Manual and is not covered in this

manual.