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