home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / spredsht / prof2d.arc / PROF2D.DOC < prev    next >
Text File  |  1990-01-03  |  17KB  |  419 lines
  1.                              Prof2d
  2.                              ------
  3.  
  4.                         The General Purpose  
  5.                    2D Measurement Data Processor
  6.  
  7.                       by Gertjan L. Ouwerling
  8.  
  9.                   Electrical Materials Laboratory
  10.                   Delft University of Technology
  11.                    P.O. BOX 5031, 2600 GA  DELFT
  12.                          The Netherlands
  13.  
  14.  
  15. Contents
  16. --------
  17.  
  18. 1. Some legal matters
  19. 2. A 250 word introduction to Prof2d
  20. 3. A 1000 word introduction to Prof2d
  21. 4. Installation of Public Domain Prof2d on the IBM-PC.
  22. 5. How to obtain the Profile/Prof2d sources and further executables.
  23. 6. Printable Bug Report Form
  24. 7. Printable Software Request Form
  25.  
  26.  
  27. 1. Some Legal Matters.
  28.    -------------------
  29.  
  30. You have now available the Public Domain version of the general purpose 
  31. 2D measurement data processor Prof2d. This software may not be distributed 
  32. commercially, that is, for more than the cost of distribution. However, 
  33. non-commercial copying of this program package (for example by non-profit 
  34. organizations, computer user groups, bulletin board systems or private 
  35. users) is encouraged. 
  36.  
  37. In other words: Copy Freely, But Do Not Sell.
  38.  
  39. You are strongly urged to distribute this software in its original form. 
  40. That is a compressed archive file called PROF2D.ARC. It contains not only 
  41. the executable program, but also the help file, further documentation and 
  42. several example Prof2d programs. If you don't copy the ARC file, at least
  43. copy all files that were spawned from it.
  44.  
  45. Every care has been taken to ensure that the Prof2d package operates
  46. properly. We however make no warranties, explicit or implied, that it is
  47. free of error. If you use Prof2d to solve a problem whose incorrect 
  48. solution might injure people or damage property, you do so at your own
  49. risk. 
  50.  
  51. By using Prof2d you agree to the terms above. You also agree that the
  52. author and the Delft University of Technology will not be held liable for
  53. any cost you may incur, or potential income you might lose as a result of
  54. using Prof2d. 
  55.  
  56.  
  57. 2. A 250 Word Introduction To Prof2d.
  58.    ----------------------------------
  59.  
  60. PRINCIPLE
  61.  
  62.    Separation of measurement/simulation data acquisition 
  63.    from          data interpretation
  64.  
  65. PURPOSE
  66.  
  67.    Relief the developer of (electrical) measurements or the user of
  68.    various 2D simulation tools from computer programming (as much as 
  69.    possible) by providing
  70.  
  71.      - Standard measurement data interpretation tools
  72.      - Data I/O and graphical facilities
  73.      - Hooks for easy add-on of problem specific software
  74.  
  75. SCOPE
  76.  
  77.  - Both interactive and programmable use (like BASIC)
  78.  - Free expression definition and evaluation (all math functions)
  79.    Even use as a pocket calculator!
  80.  - History mechanism and command line editting
  81.  - Scalar variables, 1D rows and columns and 2D fields as data types
  82.  - Various data transformations (reduction, removal)
  83.  - Both 2D contour plots and 1D cross section plots
  84.  - File I/O + fast graphical output on various devices 
  85.    (HP Plotter, IBM-PC, Tek4010, VT100, line printer)
  86.  - On-line help and 150 page manual
  87.  - Written in portable C
  88.  - Available on the IBM-PC, VAX/VMS and various UNIX systems
  89.  
  90. AVAILABILITY
  91.  
  92.  - This Public Domain Prof2d IBM-PC executable may be copied freely.
  93.  
  94.  - The Profile/Prof2d source code, User's Manual and IBM-PC and 
  95.    VAX/VMS executables are available against handling cost from the 
  96.    Electrical Materials Laboratory of the Delft University of Technology. 
  97.    A license agreement then must be signed. A suitable request form
  98.    is included as a part of this file.
  99.  
  100. Note that a sister program, Profile, is also available in the public domain
  101. (as PROFILE.ARC) against the same conditions. This is a 1D data processor
  102. with an optimizer for parameters extraction on nonlinear models.
  103. The two programs share large parts of the same source code.
  104.  
  105. 3. A 1000 Word Introduction to Prof2d.
  106.    -----------------------------------
  107.  
  108. Profile and Prof2d are computer programs that have evolved from the
  109. impurity profiling project which is being carried out at the Electrical
  110. Materials Laboratory of the Delft University of Technology.
  111.  
  112. However, their scope goes beyond impurity profiling. With Profile and
  113. Prof2d, any measured or simulated data can be read, processed, plotted,
  114. written and even generated, provided that the format in which the data
  115. is supplied or needed conforms to some simple standards.
  116.  
  117. The usefulness of the two programs is much enhanced by the fact that
  118. any mathematical expression, containing measurement data and other,
  119. user specified data, can be executed. Many mathematical functions are
  120. provided by the programs. Profile and Prof2d even can be used as an
  121. on-line pocket calculator.
  122.  
  123. A sequence of data processing commands and expressions can be saved
  124. or prepared in advance in a separate file and executed as a program by
  125. Profile and Prof2d. This allows use of the same data processing scheme
  126. on many different data.
  127.  
  128. Prof2d operates as a command interpreter. When invoked it prompts with
  129.  
  130. pr2d>
  131.  
  132. and to this prompt commands and expressions may be typed. A command
  133. tells prof2d to do something with the data (read it, write it,
  134. perform a numerical transformation, make a plot, etc). An expression
  135. is a mathematical formula that tells prof2d to compute new data using
  136. data already present.
  137.  
  138. pr2d> cplot x1 y1 z1 this is a nice plot     or
  139. pr2d> z2=ln(x2/pi)+sin(y2*pi)
  140.  
  141. Data is present in the form of scalars (variables), 1D vectors
  142. (rows and columns) and 2D fields. The names of the data types
  143. must be declared to prof2d using commands such as row and var.
  144. All data is represented by double precision floating point numbers.
  145.  
  146. If a command operates on an undetermined number of data types or
  147. variables, it usually ends in a dollar sign '$', that indicates
  148. the end of data names:
  149.  
  150. pr2d> put file.nam a1 a2 a3 a4 $
  151.  
  152. If however prof2d knows in advance how many names will be given,
  153. the dollar sign is not required:
  154.  
  155. pr2d> cplot idrain vgate idrfit
  156.  
  157. When giving commands, prof2d asks for more data until it is
  158. satisfied. E.g., if you only type the command name cplot, it will ask
  159. for the names of the appropriate data types:
  160.  
  161. pr2d> cplot
  162. x-axis (row) name: idrain
  163. y-axis (column) name: vgate
  164. z-axis (field) name: idrfit
  165.  
  166. Hence, in case you are unsure, just give the command name.
  167.  
  168. Help on all commands, and on a number of topics of general interest,
  169. is available by giving
  170.  
  171. pr2d> help <keyword>
  172.  
  173. A list of possible keywords is displayed if you give
  174.  
  175. pr2d> help help
  176.  
  177. Most UNIX or MS-DOS commands can be executed directly without leaving
  178. the program Prof2d. This allows you to use e.g. the system editor for
  179. changing data in files whilst using the Prof2d package.
  180.  
  181. pr2d> edit data.dat
  182.  
  183. A 150 page User's Manual is available (together with the source code
  184. and PC and VAX/VMS executables) from the Electrical Materials 
  185. Laboratory of the Delft University of Technology by license agreement.
  186. More information is provided in section 5. of this documentation.
  187. A provisional manual can be obtained by printing the contents of the
  188. file with help texts called PR2D.HEL that is bundled with the 
  189. Public Domain Prof2d version.
  190.  
  191.  
  192. 4. Installation of Public Domain Prof2d on the IBM-PC.
  193.    ---------------------------------------------------
  194.  
  195. This Public Domain version of Prof2d runs on the IBM-PC and true
  196. compatibles. It benefits greatly from a mathematical co-processor, but
  197. it executes without one. It will drive the CGA, EGA, VGA, Hercules and 
  198. Olivetti (AT&T 6300) graphics adaptors. These are recognized automatically.
  199. If for some reason the wrong adaptor is detected, you may use set a
  200. graphics adaptor type with the command <adapt>.
  201.  
  202. From the PROF2D.ARC file you have obtained a PROF2D.EXE file.
  203. If you have a hard disk, you should put this in a directory that 
  204. is in your search path (see MS-DOS command PATH).
  205.  
  206. Prof2d may use two auxiliary files, PR2D.MES and PR2D.HEL. The PR2D.HEL 
  207. file contains the help texts shown when using the command help.
  208. The content of the PR2D.MES file is printed each time Prof2d is invoked. 
  209. Only the PR2D.HEL file is bundled with Public Domain Prof2d. If you
  210. want, you can create your own PR2D.MES.
  211. By default, Prof2d expect these files to be present in a directory 
  212. called C:\EXTRA. You can either create such a directory or use the run 
  213. time option -d (see also the invoke help page) to state the help files 
  214. directory.
  215.  
  216. It may be a good idea to create a prof2d.bat file in your usual directory
  217. with executable programs. This file should contain a single line like
  218. (if the program resides in directory C:\PROGS and the helpfiles in
  219. directory C:\HELPFILES)
  220.  
  221. C:\PROGS\PROF2D.EXE -dC:\HELPFILES %1 %2
  222.  
  223. If you do not have a hard disk, you will need option -d to tell the
  224. programs that the helpfiles are on disk A: or B: and invoke by
  225.  
  226. A> pr2d -dA:    <- search on disk A:
  227. A> pr2d -d      <- search in current directory
  228.  
  229. Finally, Prof2d also finds the help file if it is in the current 
  230. directory.
  231.  
  232. Some Prof2d example programs are included with in the Public Domain 
  233. distribution file. You may execute such a program by typing:
  234.  
  235. C> prof2d example1.pr2 <enter>
  236.  
  237. Plots can be made by connecting a HP7550A or compatible plotter to the
  238. IBM-PC serial port (COM1). A cable fit for hardwired RS232 handshaking
  239. should be used. The baud rate of the plotter should be equal to the
  240. baud rate set for the PC's serial port with the MS-DOS command mode.
  241. For each handshaking sequence a dot (.) is printed on the screen.
  242.  
  243. Setting the RS232 port's baud rate to (e.g.) 4800 b/s:
  244.  
  245. C> mode com1:48
  246.  
  247. The following HP7550A plotter settings are suggested:
  248.  
  249. Main menu:      Monitor mode: off
  250.                 Standard (not enhanced)
  251.  
  252. Serial menu:    Dataflow:     remote, standalone
  253.                 Bypass:       off
  254.                 Handshake:    hardwired, direct
  255.                 Duplex:       full
  256.                 Parity:       8 bits off
  257.                 Baud:         As set by MS-DOS command mode
  258.  
  259.  
  260.  
  261. 5. How to obtain the Profile/Prof2d sources and further executables.
  262.    -----------------------------------------------------------------
  263.  
  264. The Prof2d Public Domain version you now have is limited in several 
  265. ways:
  266.  
  267. - Public Domain notices are given in the graphical output
  268. - No object files are available, hence no user written code can be
  269.   linked to add user specific data interpretation software.
  270.  
  271. Prof2d is written in portable C and runs on various computer systems,
  272. including the IBM-PC, VAX/VMS and several UNIX dialects. You can acquire
  273. a printed manual, non Public Domain executables for the VAX and the PC 
  274. and the source code by signing a licence agreement with the Faculty of
  275. Electrical Engineering of the Delft University of Technology. Send a 
  276. written request, stating the desired magnetic carrier, to
  277.  
  278.                           dr. Wim Crans
  279.                    Electrical Materials Laboratory
  280.                    Delft University of Technology
  281.                       P.O. Box 5031, Mekelweg 4
  282.                            2600 GA  DELFT
  283.                           THE NETHERLANDS
  284.                         Fax: +31-15-783622
  285.                        Telex 38151 butud nl
  286.  
  287. You will then be sent the appropiate licence forms. After shipment of the
  288. manual and the software you will be billed for the handling cost, estimated 
  289. to be US $50 or Dfl. 100,--, unless you enclose a check for that amount.
  290. A suitable software request form is included underneath.
  291.  
  292. Good news for Delft University Users: you do not need a licence agreement.
  293. The manual and executables can be ordered at the above address using an 
  294. internal order form. The exchange of the source code is negotiable.
  295.  
  296.  
  297. 6. Printable Bug Report Form
  298.  
  299. Cut here and print with single line spacing
  300. -----------------------------------------------------------------------------
  301.            
  302.            
  303.  
  304.  
  305.    dr. ir. W. Crans           BRF2            Do not phone. Write.
  306.    Electrical Materials Laboratory            Fax     +31-15-783622
  307.    Delft University of Technology             Telex   38151 butud nl
  308.    Mekelweg 4, P.O. Box 5031,                 
  309.    2600 GA  DELFT, The Netherlands.           
  310.    
  311.    
  312.     
  313.    
  314.    ------------------------------------------------------------------
  315.    Fold here and send in a window envelope.
  316.    
  317.                           Profile/Prof2d Bug Report Form
  318.    
  319.    If you find a bug or shortcoming in Profile or Prof2d, do NOT phone, but 
  320.    print this form and send it to us by mail or fax. Do not send large
  321.    Profile/Prof2d programs or log sequences, but try to find the smallest 
  322.    possible program that reproduces the problem and write it down below. If 
  323.    possible, use internally generated data (with the default data type 
  324.    count).  If you cannot avoid data files or larger programs, do not (only)
  325.    send listings but also a floppy disk or an electronic mail message.
  326.    
  327.    NOTE: Your comments are higly appreciated. However, no guarantees about 
  328.    bug repair can be made. 
  329.    
  330.    o  Profile     o  Prof2d    Version number (in startup message):
  331.    
  332.    +---------------------------------------------------------------------+
  333.    | Bug Description                                                     |
  334.    |                                                                     |
  335.    |                                                                     |
  336.    |                                                                     |
  337.    |                                                                     |
  338.    |                                                                     |
  339.    |                                                                     |
  340.    |                                                                     |
  341.    |                                                                     |
  342.    |                                                                     |
  343.    |                                                                     |
  344.    |                                                                     |
  345.    |                                                                     |
  346.    +---------------------------------------------------------------------+
  347.    
  348.    Name:                            Institute:
  349.    Address:                         City + Zip:
  350.    Country:                         E-mail:
  351.    Phone: +  -  -         Fax: +  -  -             Telex:         -      
  352.  
  353.  
  354. Cut here 
  355. -----------------------------------------------------------------------------
  356.  
  357. 7. Printable Software Request Form
  358.  
  359. Cut here and print with single line spacing
  360. -----------------------------------------------------------------------------
  361.  
  362.  
  363.  
  364.     
  365.     dr. ir. W. Crans           SRF2            Phone   +31-15-786104
  366.     Electrical Materials Laboratory            Fax     +31-15-783622
  367.     Delft University of Technology             Telex   38151 butud nl
  368.     Mekelweg 4, P.O. Box 5031,                 
  369.     2600 GA  DELFT, The Netherlands.           
  370.     
  371.             
  372.      
  373.     
  374.     ------------------------------------------------------------------------
  375.     Fold here and send in a window envelope.
  376.     
  377.     
  378.                            ELMAT Software Request Form
  379.     
  380.     By filing this completed form, you will receive a software license 
  381.     agreement, to be signed by a duly authorized person. After receipt of 
  382.     the signed agreement we will send you the software in the desired form. 
  383.     Demonstration versions of the programs may be obtained directly without 
  384.     signing the license agreement.
  385.     You will be billed for handling cost (US $50 or Dfl. 100,--).
  386.     
  387.     
  388.                                      Request
  389.     
  390.     Please make available to my institute the following ELMAT developed 
  391.     software
  392.     
  393.     o  Profile/Prof2d    o  ASA      o  TIPSY     o  Other:
  394.     
  395.     o  Executable for    o  IBM-PC   o  VAX/VMS   o  Other:
  396.     o  Demo Version (No license required)
  397.     o  Source Code     (license required)
  398.     o  Printed User's Manual
  399.     
  400.     on the following carriers
  401.     
  402.     o  IBM-PC Floppy Disk   o 5.25 inch/360K   o 3.5 inch/720K
  403.     o  Magnetic Tape ANSI 9-track  Density   o 1600 bpi   o 6250 bpi
  404.     o  Electronic mail      o Usenet  o BITNET
  405.     
  406.     
  407.     Name:                            Institute:
  408.     Address:                         City + Zip:
  409.     Country:                         E-mail:
  410.     Phone: +  -  -         Fax: +  -  -             Telex:         -  
  411.     
  412.     SIGNATURE:
  413.  
  414.  
  415.  
  416. Cut here
  417. -----------------------------------------------------------------------------
  418. End of the file Prof2d.doc.
  419.