Upload
hakhanh
View
214
Download
0
Embed Size (px)
Citation preview
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
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:
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.