Oakland CPM Archive/oakcpm.iso/cpm/list/filepl31.lbr/FILEPLOT.DZC/FILEPLOT.DOC

Text File | 1987-08-29 | 12KB | 275 lines

*****************************************************************
*****************************************************************
****           FILEPLOT  ---- A File Plotting Program        ****
****            by E. M. Schwartz and T. E. Bullock          ****
****                   version 3.1    6/2/86                 ****
*****************************************************************
*****************************************************************


INTRODUCTION
     Thi≤áá packagσá wil∞á allo≈á thσá use≥á t∩á prin⌠á plot≤á oµ      ì
ááááápublishablσá qualit∙á usinτá ßá Do⌠á Matri°á printe≥á anΣá ß      ì
ááááámachinσá runninτá CP═ witΦ 64╦ oµ memor∙ o≥ MSDO╙á oεá ßá P├ ì
ááááácompatiblσ machinσ witΦ o≥ withou⌠ usinτ ß graphic≤ display«

OVERVIEW
áááááThσá do⌠á matri°á printe≥ caε bσ useΣ t∩ producσá ver∙á gooΣ ì
áááááplot≤á froφ datß files«á  Thi≤ prograφ i≤ designeΣá t∩á reaΣ ì
ááááádatß generateΣ a≤ outpu⌠ froφ othe≥ program≤ o≥ entereΣ witΦ ì
áááááßá worΣá processor«á  Thσ prograφ wa≤ originall∙ writteεá iε ì
áááááBASI├ anΣ theε iε Turb∩ Pasca∞ wheε i⌠ wa≤ founΣ tha⌠á speeΣ ì
áááááwa≤á ver∙á important«á  Mos⌠ plottinτ program≤ fo≥á machine≤ ì
áááááwitΦ graphic≤ display≤ simpl∙ usσ ß screeε dum≡ oµ thσá plo⌠ ì
áááááafte≥á i⌠á i≤ buil⌠ u≡ oε thσ screen«á  Thi≤ methoΣ ha≤á thσ ì
ááááádisadvantagσ oµ requirinτ ß graphic≤ displa∙ anΣ thσ limiteΣ ì
áááááresolutioεá oµ thσ graphic≤ display«á  Aεá alternatσá methoΣ ì
ááááábuild≤á thσá imagσá u≡ iε memor∙ anΣ theε dump≤á i⌠á t∩á thσ ì
áááááprinter¼á usinτ largσ amount≤ oµ memory«  Thσ methoΣ useΣ b∙ ì
áááááFILEPLO╘ i≤ t∩ generatσ thσ plo⌠ sequentially¼á storinτ onl∙ ì
áááááthσá bi⌠ ma≡ fo≥ ß singlσ linσ oµ printe≥ outpu⌠ a⌠ ßá time« ì
áááááThi≤ i≤ donσ iε aε efficien⌠ manne≥ s∩ tha⌠ thσ prograφ doe≤ ì
ááááánot run too slowly.

ááááá     The main features of FILEPLOT are

ááááá  -- Data input from text files
ááááá
ááááá  -- Plotting of Multiple plots

ááááá  -- Plotting to the screen for initial preview

ááááá  -- Optional interpolation and grids

ááááá  -- Optional plot size and labeling

ááááá  -- Commands from the keyboard or a file

ááááá  -- Plot file output for later plotting

ááááá  -- Fast enough to be useful

ááááá  -- Multiple computer and printer support

ááááááá--áInstallation for various terminals and printersáá
è
SUPPLIED FILES
áááááThis library should contain the following files

ááááá     FILEPLOT.COM - A CPM COM file for use on CPM
                         machines.

ááááá     OUT.MPI      - Sample Printer Output for MPI

ááááá     OUT.EPS      - Sample Printer Output for Epson

ááááá     OUT.PRO      - Sample Printer Output for Prowriter

ááááá     DATA.RAW     - A test data file

ááááá     FILEPLOT.DAT - A file which demonstrates operation
ááááá                    of the program without manual commands

          INSTALLF.COM - A program for installation of several
                         types of printers and terminals

          FILEPINS.COM - Terminal installation program called
                         by INSTALLF above.

          FILEPINS.DTA - Terminal installation data

          FILEPINS.MSG - Messages for terminal installation

ááááá Somσá oµá thesσ file≤ ma∙ havσ beeε squeezeΣá s∩á tha⌠á thσ ì
áááááname≤á arσá slightl∙ modifieΣ witΦ thσ middlσ lette≥ oµá thσ ì
áááááextension≤ replaceΣ b∙ Q¼á fo≥ examplσ FILEPLOT.CO═ wil∞á bσ ì
áááááFILEPLOT.CQM. These files should be unsqueezed before using.

INSTALLATION
        Thi≤á prograφá i≤ installeΣ fo≥ aε ADM3▒ (o≥ LOB╧á MAX80⌐ ì
áááááanΣá ßá C«á ItoΦ Prowrite≥ printer«á  Iµ yo⌡ wisΦ t∩á usσá ß ì
ááááádifferen⌠á printe≥á o≥á ßá differen⌠á terminal¼á follo≈á thσ ì
áááááinstallatioε procedurσ below«  Otherwise¼ ski≡ thi≤ ste≡ anΣ ì
ááááádon't bother to unsqueeze the FILEPINS and INSTALLF files.
ááááá   T∩á instal∞ thσ program¼á unsqueezσ al∞ oµ thσá FILEPINS¼ ì
áááááINSTAL╞ anΣ FILEPLO╘ files«á Thσ FILEPIN╙ anΣ INSTALL╞ file≤ ì
áááááshoulΣ bσ placeΣ oε onσ drive«  Thσ FILEPLOT.CO═ filσ shoulΣ ì
ááááábσá placeΣá oε an∙ drivσ witΦ a⌠ leas⌠ witΦ a⌠ leas⌠ 24╦á oµ ì
áááááfreσá space«á  Loτ ont∩ thσ drivσ witΦ thσ INSTALL╞á prograφ ì
áááááanΣ ruε it«  Thσ prograφ wil∞ firs⌠ asδ fo≥ thσ drivσ t∩ usσ ì
áááááfo≥á thσ FILEPLO╘ prograφ anΣ theε i⌠ wil∞ givσ yo⌡ ß choicσ ì
áááááoµ printer≤ froφ thσ followinτ list:

ááááá  1. Epson (or OkiData with Plug and Play or IBM graphics Printer)

ááááá  2. ProWriter (or C. Itoh or DMP-85)

ááááá  3. Spare Printer Definition (Don''t Use it)

ááááá  4. MPI Printerè
áááááOthe≥ printer≤ wil∞ bσ addeΣ late≥ a≤ thσ neeΣá arises«á  Iµ ì
áááááyou≥á printe≥ i≤ no⌠ here¼á wσ wil∞ tr∙ t∩ adΣ i⌠ iµ yo⌡ caε ì
ááááásenΣá u≤ completσ detail≤ oµ ho≈ thσ graphic≤á command≤á fo≥ ì
áááááyour printer work.
ááááá  Thσá instal∞á prograφá wil∞á renamσá thσá olΣá versioεá oµ ì
áááááFILEPLOT.CO═á t∩á FILEPLOT.BA╦á anΣ wil∞á storσá ßá modifieΣ ì
áááááversion of the program on the selected drive.
ááááá  Thσá nex⌠ par⌠ oµ thσ instal∞ prograφ i≤ thσ norma∞á TURB╧ ì
áááááPasca∞ instal∞ program«á  T∩ savσ space¼á thσá documentatioε ì
áááááfo≥á tha⌠ prograφ i≤ no⌠ repeateΣ here«á  Follo≈ thσ prompt≤ ì
ááááát∩á instal∞ standarΣ terminal≤ o≥ t∩ specif∙ ßá non-standarΣ ì
áááááconfiguration«á  A⌠á thσá completioεá oµ thi≤á par⌠á oµá thσ ì
áááááprogram¼á yo⌡ musa⌠ typσ ╤ t∩ quit«  Yo⌡ d∩ no⌠ neeΣ t∩ savσ ì
áááááan∙á oµ thσ instal∞ files¼á onl∙ thσ FILEPLOT.CO═ filσá froφ ì
áááááthis operation unless you wish to reinstall the program.  ì
ì
OPERATION
ááááá  No≈á returεá t∩ thσ librar∙ anΣ ge⌠ thσá remaininτá files¼ ì
áááááFILEPLOT.DA╘á anΣ DATA.RAW«á  T∩ checδ ou⌠ thσ prograφ usinτ ì
áááááautomatioεá operation¼á loτ ont∩ thσ disδ witΦ thσá program≤ ì
áááááanΣ ente≥

ááááá         FILEPLOT FILEPLOT.DAT

áááááThi≤á shoulΣ automaticall∙ ruε thσ prograφ usinτ thσá samplσ ì
ááááádatßá se⌠á anΣá generatσ ß plo⌠ oε you≥ screeεá anΣá oεá thσ ì
áááááprinter«á  Iµ i⌠ doe≤ no⌠ work¼á thσ firs⌠ suggestioε i≤á t∩ ì
áááááselec⌠á thσ versioε fo≥ anothe≥ printer«á  A≤ ßá nex⌠á test¼ ì
áááááunsqueezσ thσ OU╘ filσ fo≥ you≥ printer«á  Theε tr∙ t∩ prin⌠ ì
ááááátha⌠ filσ directl∙ oε you≥ printer«á  Iµ thi≤ doe≤ no⌠á worδ ì
áááááeither¼á makσá certaiεá tha⌠ you≥ printe≥ interfacσá o≥á thσ ì
áááááprinte≥ itselµ wil∞ handlσ thσ ╕ bi⌠ printe≥ graphic≤ codes«  ì
áááááIµá al∞á elsσ fails¼á yo⌡ caε writσ t∩ thσá authors«á Iµá i⌠ ì
áááááworks¼ yo⌡ caε explorσ thσ prograφ furthe≥ b∙ typinτ

ááááá         FILEPLOT

áááááanΣá theεá responΣ t∩ thσ prompts«á  Notσ tha⌠á thσá defaul⌠ ì
áááááoptioεá i≤ indicateΣ b∙ thσ ╝ ╛ symbol≤ anΣ i≤á obtaineΣá b∙ ì
ááááápressinτ ente≥ insteaΣ oµ thσ requesteΣ value«á  Thσ defaul⌠ ì
ááááádatß se⌠ i≤ DATA.RA╫ whicΦ wσ plotteΣ earlier«  AlthougΦ thσ ì
áááááoption≤áá whicΦáá thσáá prograφá offer≤á arσáá fairl∙áá selµ ì
áááááexplanatory¼ somσ furthe≥ note≤ arσ giveε below«

PREPARATION OF THE DATA
áááááThσ inpu⌠ datß forma⌠ i≤ fairl∙ free«á  Yo⌡ can¼á oµ course¼ ì
áááááusσá thσ samplσ datß file¼á DATA.RAW¼á t∩ seσ wha⌠ thσá datß ì
áááááshoulΣ looδ like«á  Iε tha⌠ file¼á tw∩ function≤ arσá given« ì
áááááThσá point≤ t∩ bσ plotteΣ arσ thσ ° valuσ followeΣ b∙ thσá ∙ ì
ááááávaluσá iεá an∙á orde≥ fo≥ thσ firs⌠á function«á  Thσá seconΣ ì
áááááfunctioε (iµ any⌐ i≤  signifieΣ b∙ ß non-numeriπ entr∙ oεá ß ì
áááááline, for example

ááááá           FUNCTIONTWOè
ááááá   Datßá point≤ arσ separateΣ b∙ spaces«á  Therσ i≤ n∩ limi⌠ ì
ááááát∩ thσ numbe≥ oµ point≤ pe≥ line¼á bu⌠ therσ mus⌠ bσ aε eveε ì
ááááánumber¼á i«á e«á onl∙ completσ x,∙ pair≤ mus⌠ bσ given«  Thσ ì
áááááformat may be in floating form

ááááá               1.000

áááááor in exponential form

ááááá               1.00E+03

áááááwith a variable field length.

ááááá   Thσ optiona∞ commanΣ filσ ma∙ bσ prepareΣ usinτ an∙á tex⌠ ì
áááááprocessinτá prograφ anΣ shoulΣ contaiε thσ samσ input≤á tha⌠ ì
áááááyo⌡ woulΣ ente≥ froφ thσ keyboard«á  Iε thσ samplσ file¼ thσ ì
áááááprompt≤á froφá thσ prograφ arσ entereΣ t∩ thσ righ⌠á oµá thσ ì
ááááádatßá t∩ hel≡ yo⌡ remembe≥ wha⌠ questioε yo⌡ arσá answering« ì
áááááThi≤á is¼á oµ course¼á no⌠ requireΣ anΣ caε bσ omitted«á Thσ ì
áááááfilσ namσ i≤ arbitrary¼á bu⌠ mus⌠ bσ oε thσ commanΣ linσá iε ì
áááááorde≥á fo≥á thσá prograφ t∩ accep⌠ thσ inpu⌠ froφá thσá filσ ì
áááááinsteaΣ oµ froφ thσ keyboard«á  Yo⌡ migh⌠ examinσ thσ samplσ ì
áááááfilσ carefull∙ anΣ theε tr∙ writinτ you≥ own«

COMMENTS

áááááA.áááUse≥ entrie≤ -- Throughou⌠ these notes use≥ entrie≤ arσ ì
ááááááááááshowεá b∙á appearinτ betweeε █ anΣá ]¼á althougΦá thesσ ì
áááááááááábracket≤ arσ no⌠ t∩ bσ useΣ durinτ execution.

áááááB.   Anothe≥á -- The prompt:
ááááá
ááááá          Another (<y> or n):
ááááá
ááááááááááresult≤ wheε ß plo⌠ i≤ complete«  T∩ agaiε ruε thσ jus⌠ ì
áááááááááácompleted prograφ, [y] (the default) should be entered.

áááááC.   Casσá -- Al∞á response≤ ma∙ bσ eithe≥á uppe≥á o≥á lowe≥
áááááááááácase«

áááááD«á  ConcatinateΣ plot≤ -- ┴ serie≤ oµ curve≤ caε bσ plotteΣ ì
ááááááááááoεá thσ samσ grapΦ b∙ concatinatinτ thσ datß sucΦá tha⌠ ì
ááááááááááthσ point≤ oε ß curvσ occu≥ iε continuou≤ blocks«á  Thσ ì
áááááááááádifferen⌠á datßá set≤á shoulΣ bσ separateΣá b∙á ßá non-ì
áááááááááánumeriπá characte≥ o≥ strinτ oε ß separatσá line«á  Thσ ì
ááááááááááprograφ wil∞ coun⌠ anΣ displa∙ thσ numbe≥ oµ x,∙á pair≤ ì
ááááááááááwhicΦá i⌠ ha≤ founΣ iε eacΦ se⌠ s∩ yo⌡ caε checδ t∩ seσ ì
ááááááááááif the data is being read correctly.  ì

     E.á  Default≤á -- Al∞ defaul⌠ value≤ arσ showε b∙á appearinτ           ì
          betweeεá ╝ anΣ >¼á a≤  iε  ¿ <y╛  o≥  ε )¼á wherσá  "yó              ì
ááááááááááis thσ defaul⌠ value.
áááááááááá
áááááF.áááInterpolatioεá -- Linea≥á interpolatioε ma∙ bσ useΣá b∙ ìèááááááááááresponding [y] to the prompt:

áááááááááá     Interpolation  (<y> or n)     :              .
áááááááááá
áááá G.áááNicσá scalinτá -- The prompt:
áááááááááá
áááááááááá     Nice scaling   (<y> or n)     :
áááááááááá
áááááááááácaε bσ useΣ t∩ givσ ß plo⌠ scale≤ othe≥ thaε thosσ tha⌠ ì
ááááááááááwoulΣáá resul⌠á froφá thσá giveεá point≤áá anΣáá sizes«  ì
ááááááááááRespondinτ [y▌ (thσ default⌐ wil∞ resul⌠ iε scale≤ witΦ ì
áááááááááá"niceóá griΣá sizes«á  ì

áááááH.áááPrinter or CRT -- The prompt:
áááááááááá
áááááááááá     <P>rinter or (C)rt:

ááááááááááwil∞á allo≈á thσ use≥ t∩ firs⌠ vie≈ ß "sketchóá oµá thσ ì
ááááá     plot  oεá thσ CR╘ beforσ printing«á  Thσ sketcΦ ma∙á bσ ì
ááááááááááusefu∞á t∩ avoiΣ thσ wastσ iε timσ anΣ pape≥á tha⌠á ma∙ ì
ááááááááááresult≤á froφá obviousl∙ useles≤ plots«á  Sketche≤á arσ ì
ááááááááááalmos⌠ instantaneous¼á whilσ plot≤ takσ froφ second≤ t∩ ì
ááááááááááminute≤ dependinτ oε thσ sizσ oµ thσ plot«á  Iµ [c▌á i≤ ì
ááááááááááthσ response¼ thσ followinτ prompt- t∩ asδ iµ ß printeΣ ì
ááááááááááplo⌠á i≤á desired- wil∞ appea≥ unde≥ thσ sketcΦ oεá thσ ì
ááááááááááCRT«

áááááááááá     Printer (<y> or n):              .

ááááááááááNote that the defaut to this second prompt is "y".

áááááI. FILE OUTPUT
ááááá     Thσá promp⌠á whicΦ ask≤ fo≥ outpu⌠ t∩ printe≥á o≥á filσ ì
áááááwil∞á causσá thσ printe≥ outpu⌠ t∩ bσ routeΣ t∩ ßá filσá fo≥ ì
ááááálate≥á printint«á  Thσ resultinτ outpu⌠ filσ caε bσá printeΣ ì
áááááwithou⌠á ß specia∞ plottinτ prograφ anΣ coulΣ bσ includeΣ a≤ ì
áááááß par⌠ oµ ß norma∞ tex⌠ filσ t∩ includσ ß figurσ iε witΦ thσ ì
ááááátexts«  However¼ somσ tex⌠ processors¼ sucΦ a≤ WordStar¼ ma∙ ì
áááááno⌠á likσá t∩á havσ thi≤ sor⌠ oµ thinτ iε thσá middlσá oµá ß ì
ááááádocumen⌠ file« Notσ tha⌠ i⌠ i≤ possiblσ ge⌠ largσ reduction≤ ì
áááááiεá thσ numbe≥ oµ byte≤ iε thesσ file≤ b∙ thσ usua∞á squeezσ ì
áááááprograms because of all of the repeated patterns.



THE FINAL WORD

ááááá     Thσ author≤ wisΦ t∩ hea≥ froφ yo⌡ iµ yo⌡ havσá problem≤ ì
áááááo≥ suggestions«á  Beforσ yo⌡ ask¼ thσ P├ versioε anΣ perhap≤ ì
áááááthσá Pasca∞á sourcσ wil∞ bσ ou⌠ shortl∙ (I⌠ i≤ workinτá now¼ ì
ááááájus⌠á no⌠á read∙ t∩ distribute⌐ fo≥ ß ver∙á nomina∞á charge«  ì
áááááPleasσ writσ u≤ a⌠

ááááá            Professor T. E. Bullock
ááááá            Department of Electrical Engineeringèááááá            University of Florida
ááááá            Gainesville, FL 32611ì