home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / BF / BF023A.ZIP / SMPRHIS2.HLP < prev    next >
Text File  |  1989-02-15  |  9KB  |  154 lines
  1. SPECIFICATION OF ASCII FILE FORMAT-HISTORICAL DATA - RELEASE 2.54 - PAGE 1 OF 7
  2.  
  3. The data to be "imported" must be in ASCII (say "askee") format, because this
  4. is a universal format which can be understood by most communications, spread-
  5. sheet and database programs.  ASCII is a standard which describes the bit pat-
  6. terns used for computer storage of individual letters, digits, puncutation and
  7. other special characters. For example the capital letter "A" has the bit pat-
  8. tern 01000001.  Most personal computers can recognize ASCII.  Textual informa-
  9. tion, such as what you are reading now, is usually stored in ASCII format.
  10.  
  11. Numbers must be in a binary format before they can be used in calculations by a
  12. computer.  The Stock Charting System stores volume, prices, dates and other in-
  13. formation in a binary format.  Therefore, numbers in ASCII must be "translated"
  14. to binary before they are useful for calculations.
  15.  
  16. This program looks for and processes only those individual lines on the ASCII
  17. input file which contain valid data.  Any lines which contain column headings,
  18. explanatory information, advertising, communications protocol and other things
  19. will be ignored.
  20.  
  21.  
  22.  
  23.  
  24. SPECIFICATION OF ASCII FILE FORMAT FOR HISTORICAL VOLUME/PRICES     PAGE 2 OF 7
  25.  
  26. All data in the ASCII input file MUST pertain to the SAME stock.  There is no
  27. provision to "import" historical information for many dates for many stocks --
  28. historical data for only one stock can be imported at a time.  To "import" data
  29. for many stocks for just the CURRENT date, invoke the (W) or (D) function from
  30. the Master Menu screen.
  31.  
  32. The lines in the ASCII input file can be in any order, EXCEPT when "importing"
  33. DAILY information to be used on a WEEKLY-updated file.  In that case, lines
  34. containing valid data MUST be in increasing order by date to insure proper com-
  35. bination of daily volume/prices into weekly data; and volume and prices for
  36. dates to be updated should be zeroed out first if they are not already.
  37.  
  38. The program scans each individual line from left to right and looks for valid
  39. data items.  These include the date, volume and high, low and closing prices.
  40. If the required data items are found, they are converted to binary format.  The
  41. date must be present and must match a previously computed date on the price
  42. history file.  Number values are checked for "reasonableness" and for proper
  43. relationship, for example high or ask >= closing price >= low or bid.  (The >=
  44. symbol means "greater than or equal to".)  Any error will cause that line to be
  45. discarded.
  46.  
  47. SPECIFICATION OF ASCII FILE FORMAT FOR HISTORICAL VOLUME/PRICES     PAGE 3 OF 7
  48.  
  49. Data items must be separated by blank spaces or other non-numeric characters.
  50. Either fractional or decimal values are acceptable. Fractions must be separated
  51. from their corresponding whole numbers by one and only one blank space.
  52.  
  53. The program will ignore characters such as * to indicate ex-dividend.  It will
  54. also ignore any quote marks or commas that may be used to separate data items.
  55. Thus, it will accept data in the CSV, or comma-separated value, format which is
  56. used by some database programs.  It is the responsibility of the user, in the
  57. process of using the external communications or other program of his or her
  58. choice, to make sure the required data items are available.
  59.  
  60. Here are some examples of acceptable data arranged by trading period date,
  61. high, low, close and volume:
  62.  
  63.          01/29/88   *120        109 3/4    110 1/2   110375   (* ignored)
  64.          "01/29/88",15.25,14,14.875,56259   (CSV format)
  65.          01-29-88  31.125 29 30.5 4075   (either - or / in date is OK)
  66.  
  67. For the above data format, you would type MABCV to specify the order in which
  68. the data items appear (see next screen page).
  69.  
  70. SPECIFICATION OF ASCII FILE FORMAT FOR HISTORICAL VOLUME/PRICES     PAGE 4 OF 7
  71.  
  72. The prompt you were responding to before these Help screens is necessary to
  73. specify the sequence in which data items appear in the file you are "importing"
  74. into the Stock Charting System.  This sequence may vary, depending on what
  75. source the data comes from.  The required data items must be in the same
  76. sequence on each line on which they appear.
  77.  
  78. Each required data item is identified by a letter of the alphabet, such as A
  79. for ask or high, B for bid or low, etc.  The sequence in which data items
  80. appear in the input is specified by typing those letters in a corresponding
  81. sequence, for example MABCV for date-high-low-close-volume. If you don't know
  82. the sequence, you can find out from the documentation for the program that
  83. created the file, or by visual inspection after displaying the file on the
  84. screen or printer.  Usually a program that creates a file can also display it.
  85.  
  86. Note there are many different allowable date formats.  Use M for a date in
  87. mm/dd/yy or mm-dd-yy format (generally used in the USA).  Use D for a date in
  88. dd/mm/yy or dd-mm-yy format; or use Y for a date in yy/mm/dd or yy-mm-dd
  89. format.  The program will also accept dates without punctuation or with 4-digit
  90. years, for example 112588 or 19881125.  Dates without punctuation must be
  91. exactly six or exactly eight digits long.
  92.  
  93. SPECIFICATION OF ASCII FILE FORMAT FOR HISTORICAL VOLUME/PRICES     PAGE 5 OF 7
  94.  
  95. To skip over a data item you don't want to use, type the letter "R" if it is a
  96. stock price (ask/bid/last/open/etc.); otherwise type the letter "S". In general
  97. you can use "S" to skip any data item, UNLESS it may contain a number with a
  98. fractional value such as 2 11/16.  "S" skips anything delimited by spaces or
  99. double quotes, so it won't work on fractions.  That's why you have to use "R"
  100. to consistently skip over numeric values that may contain fractions.  Either
  101. "R" or "S" will work with whole numbers and decimal values.
  102.  
  103. For example, when receiving historical quotes from Dow Jones Information Ser-
  104. vices, the data items are in date-high-low-close-volume order.  Therefore, if
  105. you want only date and closing price, type the letters MRRC to specify the data
  106. item order.  Note in that case you do not have to specify the volume if you
  107. don't want; the program will ignore it.
  108.  
  109. Use S instead of R to skip a field such as the time of day or a date.
  110.  
  111. Use V for volume in hundreds (the normal case).  Otherwise use U.  Which one to
  112. use can be determined by inspection of the data.  U means volume in UNITS of 1.
  113.  
  114.  
  115.  
  116. SPECIFICATION OF ASCII FILE FORMAT FOR HISTORICAL VOLUME/PRICES     PAGE 6 OF 7
  117.  
  118. Not all of the aforementioned data items must be present.  The program can use
  119. the trading period date and the current volume, high, low and close.  However
  120. the only items that absolutely must be available on each line are the date and
  121. either the current closing price (or net asset value) or the ask and bid
  122. prices.  If the ask and bid prices are present, but not the closing price, the
  123. closing price is set to the bid price.  If only the closing price is present,
  124. the high and low are set equal to the close.
  125.  
  126. After the "translation" process is finished, you are automatically sent back to
  127. the Data Entry screen.  There, you can "browse" through the data and perhaps
  128. set moving average periods and other graphics options.
  129.  
  130. The program does not indicate errors in the incoming data during the transla-
  131. tion process; invalid data is simply ignored.  Errors will become apparent as
  132. you "browse" through the data or graph it - where errors were found, the data
  133. is missing from the price history file.  See the next screen for some "trouble
  134. shooting" advice.
  135.  
  136.  
  137.  
  138.  
  139. SPECIFICATION OF ASCII FILE FORMAT FOR HISTORICAL VOLUME/PRICES     PAGE 7 OF 7
  140.  
  141. If you got most of the data but a few lines are missing, the problem could be
  142. "glitches" on the telephone line (when receiving data through a modem).  This
  143. could cause some "garbage" to get into the incoming data, or perhaps a few
  144. individual characters could have gotten lost.  You might be able to use a text
  145. editor or word processor to edit the ASCII file and correct the problem.  Or,
  146. you could get the missing data from an old newspaper, or try to download the
  147. data again using your communications program.
  148.  
  149. If you didn't get any data at all, or you got only one or two lines, the most
  150. likely cause is that the data items are not in the same order you specified.
  151. You should visually inspect both the incoming ASCII data and the resulting
  152. Stock Charting System data to make sure everything is reasonable and hopefully
  153. correct.
  154.