home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / oilfield / spe-34.lzh / MANUAL.DOC < prev    next >
Text File  |  1989-07-12  |  17KB  |  343 lines
  1. ************************************************************************
  2. SOCIETY OF PETROLEUM ENGINEERS MICROCOMPUTER USERS GROUP  DISK # 33
  3.          PC/MS-DOS 3.0 & UP       FORMAT: DOUBLE SIDED           
  4. ------------------------------------------------------------------------
  5. NOTICE  TO  USERS:  Neither the contributor nor the Society of Petroleum
  6. Engineers  makes any express or implied warranty of any kind with regard
  7. to  these program materials, including, but not limited to warranties of
  8. of  merchantability  and  fitness  for a particular purpose. Neither the
  9. contributor  nor the SPE shall be liable for incidental or consequential
  10. damages  in  connection  with  or  arising out of the furnishing, use or
  11. performance  of  these program materials. SPE EXCHANGE PROGRAMS (LEVEL 1
  12. public  domain,  and  user  supported)  may  be  copied  and used freely
  13. provided credit is given to SPE, author, or source. 
  14. ------------------------------------------------------------------------
  15.                                                       October 1, 1988   
  16.    
  17.                           DECLINE CURVE PROGRAM   
  18.                    Copyright 1988 Dale C. Cheesman III   
  19.                                 Version 2   
  20.    
  21.     The Decline Curve Program is a menu-driven graphics program that   
  22. automatically plots graphs on your PC illustrating the rate of decline of   
  23. your oil and gas wells.  With this program you can 1) create a well file,   
  24. 2) update its daily or monthly flow rates, (automatically calculating   
  25. ratios, cumulatives and averages), 3) retrieve back all specific   
  26. information saved on disk and get a permanent printed detail, 4) plot a   
  27. graph of the decline curve in either linear or semi-logarithmic style, and 5) 
  28. print a hard copy of you graph on to your IBM or Epson compatible printer.   
  29.    
  30.     The program can be configured for either a VGA, EGA or CGA monitors,  
  31. although the VGA and EGA modes obviously look the best.  Also it helps a great
  32. deal to have a color monitor.  YOU MUST HAVE A GRAPHICS CARD TO DISPLAY THE  
  33. GRAPHS.     
  34.    
  35.     This program is ideal for engineers, geologists, landmen, investors   
  36. or anyone who is interested in keeping track of various wells.  Although   
  37. it was written to be used for oil and gas wells, it could be used to track   
  38. just about anything you want (i.e. stocks and other markets...).  It is   
  39. a heck of an alternative to the $2,000+ programs that do the same thing.    
  40.    
  41.                        THIS IS A SHAREWARE PROGRAM   
  42.    
  43.     If you find that you can use the program and that it is helpful to   
  44. you, please register by sending a check for $50 (plus $4 tax if in Texas)   
  45. to:   
  46.                   Dale Cheesman III   
  47.                   Decline Curve Program
  48.                         750 Bering, Suite 100   
  49.                   Houston, Texas 77057   
  50.    
  51.     ALL PEOPLE WHO REGISTER WILL RECEIVE A VERSION OF THE PROGRAM THAT CAN 
  52. AUTOMATICALLY CONVERT WELL FILES FROM PETROLEUM INFORMATION AND DWIGHTS DATA 
  53. BASE FILES!!!!!!!     The registered version has other great enhancements 
  54. including automatically converting daily well files to monthly well files. 
  55.  
  56.     Please feel free to distribute a copy of this program to as many people
  57. as you wish.  All people who register will get the special version of the 
  58. program described above as well as notice of all updates and personal back-up
  59. support through the mail.   I can also customize the program for anyone who
  60. has specific needs (i.e. Hercules, MCGA or Black & White compatible programs
  61. or special data formats...).  Like I said, it is a heck of an alternative to
  62. the $2,000+ programs that do the same thing. 
  63.    
  64.  
  65.  
  66.     THE DECLINE CURVE PROGRAM MAY NOT BE DISTRIBUTED WITHOUT THIS   
  67. "MANUAL.DOC" FILE.   
  68.    
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                     1
  78.  
  79.  
  80.  
  81.  
  82.                   LIST OF FILE INCLUDED IN THIS PACKAGE   
  83.    
  84.     DECLINE.EXE       THE DECLINE CURVE PROGRAM   
  85.     DECLINE.CNF       CONFIGURATION FILE   
  86.     MANUAL.DOC        INSTRUCTION MANUAL   
  87.     NEW-VER2.DOC      LISTS VERSION 2 IMPROVEMENTS  
  88.     EXAMPLE1.TXT      1ST EXAMPLE WELL FILE (DAILY)   
  89.     EXAMPLE2.TXT      2ND EXAMPLE WELL FILE (MONTHLY)   
  90.     EGAEPSON.COM      EPSON EGA SCREEN DUMP DRIVER   
  91.     NOLF.COM          EPSON DRIVER TO DELETE EXTRA LINE FEEDS   
  92.    
  93.    
  94.                               INSTRUCTIONS       
  95.    
  96.     To start the program, just type the word DECLINE and then press   
  97. <ENTER>.  You will get the opening configuration menu.  The first thing   
  98. to do is configure the program for your needs.  To do this enter (6) on   
  99. the main menu (only if you are not already in the configuration menu) and   
  100. then enter (Y) to proceed with the configuration.  Enter your name or the   
  101. name of your company, then enter the correct path to your well files.  If   
  102. you plan to keep all your well files on a floppy disk in drive A then   
  103. enter A:\.  IT DOES NOT MATTER WHERE THE PROGRAM IS, JUST THE WELL FILES.    
  104. If you want to put the system on your hard drive, I suggest putting the   
  105. program and its configuration file (DECLINE.EXE and DECLINE.CNF   
  106. respectively) in one directory and all the well files in a sub-directory.    
  107. Just be sure to enter the correct path to that sub-directory in the   
  108. configuration program (i.e. C:\DECLINE\WELLS\).     
  109.    
  110.     Next enter (1) for CGA, (2) for EGA, or (3) for VGA monitors.  When   
  111. you are finished enter (S) to save the new configuration and return to the   
  112. menu.   You may re-configure the program as many times as you wish.   
  113. REMEMBER TO ALWAYS KEEP THE CONFIGURATION FILE "DECLINE.CNF" IN THE SAME   
  114. DIRECTORY AS THE MAIN PROGRAM "DECLINE.EXE".   You may keep the well files   
  115. in another directory as long as you enter its path in the configuration   
  116. program.   
  117.    
  118.     You are now ready to use the Decline Curve Program.   
  119.    
  120.                                WELL FILES   
  121.    
  122.     The idea of the program is to have a group of files on disk that   
  123. contain daily or monthly flow rates for your wells.  Each file represents   
  124. a well.  The well file is a list of records containing the rate of Pressure,
  125. Gas, Oil, and Water for a certain point on the graph.  Each point can be a
  126. day, week, month or year.  The program can handle a total of 2,000 points,
  127. (meaning 2,000 days, weeks, months or years.)  I recommend that you start off
  128. your new wells on daily rates, then in your fifth year of production convert
  129. the numbers to weekly or monthly rates.  When you are installing older wells
  130. (i.e. 5 years) start off using monthly dates.  Wells producing over 120 years
  131. should use yearly points (sure).     
  132.  
  133.                                DATA ENTRY   
  134.    
  135.     The program has its own data base manager to input and update the   
  136. well file data.  To create a well file just select 5 from the Main Menu   
  137. and follow the prompts.     
  138.    
  139.     The well file name is just like any other file name that it must   
  140. contain 8 characters or less.  DO NOT PUT AN EXTENSION ON THE FILE NAME.    
  141.  
  142.                                    2
  143.  
  144.  
  145.  
  146.  
  147.  
  148. The program automatically puts a ".txt" extension on all file names so it   
  149. can recognize them.  After entering the file name, enter the starting date   
  150. of the well in the form of the example on the screen.  BE SURE THE DATE   
  151. LOOKS LIKE THE FORMAT BELOW.  Now enter your first set of points at the   
  152. prompts.  At that point you can start over (M), exit to the menu (E), or   
  153. Continue (C).  If your first set of points look right enter (C) to save   
  154. them and continue.     
  155.    
  156.                                ADDING DATA   
  157.    
  158.     The next prompt is asking you if you want the computer to   
  159. automatically fill in the date for you when you enter your well data in   
  160. order to save you time and keystrokes.  Enter (A).  Then it asks you   
  161. whether you want to use Daily or Monthly points in your graph.  Enter (D)   
  162. or (M).  Then just follow the prompts.  If you make a mistake, just hit   
  163. the <Enter> key until you get the Mistake message and then enter (M).    
  164. When you are finished entering or up-dating the data, select (E) to exit   
  165. then (Y) to save it.  You may then choose to use the new points you have   
  166. just entered or disregard them for your current graph.  Select (Y) to use   
  167. them.   
  168.    
  169.                                  EDITING DATA
  170.  
  171.     To edit existing data, simply use your favorite text editor or word
  172. processor.
  173.  
  174.                         OTHER DATA BASE PROGRAMS   
  175.    
  176.     If you prefer, you may create, update and edit your well files using   
  177. any other data base program such as Paradox, Dbase or Lotus (and PI or Dwight's
  178. if you are a registered user of Decline Curve).  You can even use a text editor
  179. or a word processing program.  All you have to do is export the files from these
  180. programs in ASCII (text) format in the form illustrated below:   
  181.    
  182. "Date",Pressure,Gas,Oil,Water   
  183.    
  184. Filename:    EXAMPLE1.TXT   
  185.    
  186. "1/01/1988",1555,230,2.3,43.4   
  187. "1/02/1988",1575,229,2,39.2   
  188. "1/03/1988",1555,227,2.6,11.5   
  189. ......   
  190.  
  191.     This is an example of the daily well file EXAMPLE1.TXT, if it were   
  192. monthly it would have dates like "1/1988", "2/1988"... as in well file   
  193. EXAMPLE2.TXT.   
  194.    
  195.     IMPORTANT!    All date formats must be done in this style:     
  196.    
  197.             MONTH/DAY/YEAR   or     MONTH/YEAR   
  198.               1/04/1988               1/1988   
  199.    
  200.     Separate the numbers with slashes (/) and if the DAY is a single   
  201. digit (4), it must have a zero before it (04).   
  202.    
  203.     But you don't have to worry about any of this if you use the Decline   
  204. Curve Program's data base manager.   
  205.    
  206.  
  207.                                    3
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.                            LISTING WELL FILES   
  215.    
  216.     YOU CAN NOT LIST, PRINT OR GRAPH A WELL FILE UNTIL YOU FIRST SELECT   
  217. A WELL FILE (menu selection 1).             
  218.    
  219.     If you haven't already done so, enter (1) on the menu to select a   
  220. well file.   You will get a listing of all the wells you have on file
  221. including the two example well files EXAMPLE1.TXT and EXAMPLE2.TXT.  Move the
  222. cursor to the first letter of the file you want and  press <ENTER>.  Back at
  223. the main menu you will notice that the selected well is now listed on the
  224. right.   
  225.    
  226.     Enter (2) to list the data.   As you can see it moves pretty fast   
  227. so you will have to pause the screen to read a certain date.  At the end   
  228. of the list the program will give you total cumulative and average figures   
  229. for the well, (very useful!)  After it lists the data on the screen you   
  230. can Enter (P) to get a hard copy.  This comes in very handy for your   
  231. office files.      
  232.    
  233.     Please notice that the program automatically calculates the Gas -   
  234. Oil Ratio (GOR) in the far right column.   
  235.    
  236.                              PLOTTING GRAPHS   
  237.    
  238.     YOU CAN NOT LIST, PRINT OR GRAPH A WELL FILE UNTIL YOU FIRST SELECT   
  239. A WELL FILE (menu selection 1).             
  240.    
  241.     If you haven't already done so, enter (1) on the menu to select a   
  242. well file.  At the main menu select (3) to draw a graph.  At this point   
  243. you may select (1) for Linear format or (2) Logarithmic format.  Press (1)   
  244. for Linear style.     
  245.  
  246.        Now the program asks you if you want to change the way the graphs   
  247. appear on the screen (and on the printer).  If you just want to plot the   
  248. graphs on the screen AT THIS TIME, select (N) or <ENTER> to leave it   
  249. unchanged and the program will proceed plot the graph.  Please notice that in
  250. the Linear format, the program automatically sets the scale to the highest  
  251. value in order to use all of the screen.  To erase the graph just press any  
  252. key and you will return to the main menu.  Enter (3) again at the main menu  
  253. but this time select (2) for Logarithmic style.  After a brief wait the new  
  254. graph will appear.   
  255.   
  256.     Use the Linear format to study high values like the Pressure and   
  257. Gas rate and use the Logarithmic format to study lower values like Oil   
  258. and Water.   
  259.   
  260.                            CHANGING GRAPH APPEARANCE  
  261.   
  262.     Since everyone wants something different than everyone else, this  
  263. program allows you to change the appearance of the graphs to suit your needs.
  264. After pressing (3) at the main menu and selecting which kind of graph you want
  265. (linear or logarithmic),  the program will ask you if you want to change the 
  266. graphs.  Enter (Y).  
  267.   
  268.     First the program will ask you if you want to print all the lines (I.E.
  269. pressure, gas, oil, water and GOR).  If  you only want to print certain lines
  270. on your graph (temporarily) enter (Y).   At this point just press (Y) or (N)
  271. by each line description or <Enter> to leave unchanged.  (Y) = print the line,
  272. (N) = don't print the line, or (ENTER) to leave as is.  
  273.  
  274.  
  275.                                   4     
  276.  
  277.  
  278.  
  279.   
  280.      Next it will ask you about the graphs themselves.  In EGA and VGA mode,
  281. all graphs have an attractive blue background and solid lines for scale  
  282. markers.  I believe this looks best on the screen but causes problems when you
  283. decide to print the graphs.  I recommend that you use the default settings  
  284. (BLUE <1> and LINES <1>) when working on your wells and are just using the  
  285. screen.   When you are ready to print a hard copy of your graph, select BLACK
  286. background <0> and DOTS <0> for scales.    
  287.    
  288.     On large well files that are on monthly or yearly points, choose NO   
  289. (N) on printing Monthly Dates so the date labels won't run together.  If the 
  290. Month lines are too close together, enter No (N) to suppress them also.   
  291. Choose YES (Y) in both cases for almost all other graphs.   
  292.   
  293.     Now the program asks you if you want to print a certain time period of 
  294. the well.  The default settings show the well from beginning to end but if you
  295. want to just study a certain time period enter Yes (Y).  Using the correct
  296. date format, described above, enter the date you want to start at and then the
  297. ending date.  If you put an incorrect date or just hit <Enter>, the date will
  298. remain unchanged.  
  299.  
  300.     The last question asks you if you want to change the length of the lines
  301. in relation to the time scale of the graph.  If you want to forecast the
  302. production rates on the well enter (Y) for yes.  The idea is to determine what
  303. percentage of the entire graph should the line take up in order for the line to
  304. reach the bottom of the graph.  Start out with 50 (for 50%) which will double
  305. the scale of the graph.  After printing the graph, draw a line though the points
  306. to illustrate your idea of the forecast line.  If the line doesn't reach the
  307. bottom of the graph try a smaller percentage.  You can only enter 1 thru 100. 
  308. A future version of this program will automatically forecast lines.
  309.   
  310.     All of the settings that change the graph appearance will remain  
  311. unchanged if you press <enter> at the questions.  The settings remain in  
  312. memory until you change them or leave the program.      
  313.  
  314.                              PRINTING GRAPHS   
  315.   
  316.     If you have a IBM Graphics or Epson compatible printer, you may use   
  317. <Print Screen> to print the graph from your CGA or EGA (not VGA) screen   
  318. to your printer.  Remember to first change the background and scale settings 
  319. on the graphs to Black and Dots.  
  320.   
  321.     To print a graph you must first load the Epson driver.  Included with  
  322. this package are two Public Domain drivers to help you screen-dump your  
  323. graphics to your IBM or Epson compatible printers.  The first is EGAEPSON.COM,
  324. which allows you to print your graphs from an EGA screen to an Epson or IBM  
  325. compatible printer.  It will also print from your CGA screen on some machines. 
  326. To use this program, just enter EGAEPSON before running DECLINE.  The second
  327. program is NOLF.COM which takes away the extra line feeds some printers
  328. produce during screen dumps.  If your printer prints every other line you need
  329. to also enter NOLF before running DECLINE.   If you have a CGA and the
  330. EGAEPSON does not work, re-boot your system and invoke the Dos "GRAPHICS"
  331. command prior to running Decline.  Future versions of this program will
  332. support printing detail graphs from VGA screens.   The new DOS 4.0 has drivers
  333. (Graphics) that will screen dump from  CGA, EGA and VGA screens.  This will
  334. work great with this program.   
  335.   
  336.     If you are having trouble with the program, or have suggestions or need
  337. customized versions of the program please send me a letter and I will get back
  338. to you as soon as I can.   
  339.    
  340.     I hope the Decline Curve Program is as helpful to you as it is for   
  341. me.  Thanks for your support.   
  342.                                                  Dale C. Cheesman III   
  343.                                        5