home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / utility / esunits / esunits.faq < prev    next >
Encoding:
Text File  |  1995-07-30  |  12.8 KB  |  270 lines
  1.  
  2.  
  3.  
  4.                       ENTISOFT UNITS V1.0 FACT SHEET
  5.  
  6.  
  7.  
  8.                              Executive Summary
  9.  
  10.    * Entisoft Units is a sophisticated measurement conversion calculator
  11.      for Microsoft Windows and Microsoft Office.  It recognizes any
  12.      combination of the approximately 500 built-in SI, metric, English, and
  13.      historical measures.
  14.    * The package includes an interactive Windows executable program for
  15.      performing measurement conversions.
  16.    * The package also includes Microsoft Access and Excel Add-In versions. 
  17.      These Add-Ins provide both function call libraries (APIs) and simple
  18.      interactive calculators.
  19.    * The registered package includes Visual Basic source code to all
  20.      versions, including a port for Microsoft Project.
  21.    * Single user price is $39.95.  Site licensing prices are detailed
  22.      below.
  23.    * The shareware (trial) package is available on CompuServe, America
  24.      Online, and our Entisoft BBS in a file named ESUNITS.ZIP.  The
  25.      miniature shareware package is available in a file named ESUNITM.ZIP.
  26.  
  27.  
  28.                             General Information
  29.  
  30.    * Uses a natural language interface for expressing measurements.  For
  31.      example, converting from "10 cups" to "liters" returns 2.37.
  32.    * Measurements can be preceded by any of 50 known prefixes.
  33.    * Measurements are known by their common names, abbreviations, acronyms,
  34.      and synonyms.  For example, "kilometers per hour" can be entered as
  35.      "KPH", "km/hr", "kmeters/hour", "kilometers per hour", etc.
  36.    * Understands any combination of the known units and/or prefixes.  For
  37.      example, converting "45 ft*lbs/second^2" (a measure of force) to
  38.      "newtons" returns 6.22.
  39.    * Sophisticated parser uses case sensitivity and other hints to help
  40.      interpret the measurements.
  41.    * Returns the remaining units when the units being converted do not
  42.      represent the same type of physical measurement.  For example,
  43.      converting "12 joules" (a measure of energy) to "newtons" (a measure
  44.      of force) returns "12 meters" (a measure of length).
  45.    * Understands numbers expressed in either decimal form or as fractions.
  46.    * Powerful text replacement definitions extend the variations of names
  47.      and abbreviations recognized by the program.
  48.  
  49.  
  50.              Windows Executable Program (Visual Basic Version)
  51.  
  52.    * Features interactive calculator, list of known units and prefixes, tip
  53.      wizard, history list, and user-defined conversion factors box.
  54.    * All user input and calculated results are shown with the physical
  55.      measurements that they represent.  For example, any measurements of
  56.      the form "length per time" (e.g. "miles per hour") are described as
  57.      "speed".
  58.    * The units mentioned in all input and result expressions can be
  59.      enumerated.  For example, the program will tell you that "kg*m^2" was
  60.      interpreted as "kilogram meter^2"
  61.    * Any remaining units are returned in the standard SI units for the
  62.      physical measurement.  For example, measurements of energy such as
  63.      "kilowatt hours" are displayed in joules (the SI unit of energy). 
  64.      Results can optionally be displayed in terms of the fundamental base
  65.      units (kilograms, meters, seconds, amperes, etc.)
  66.    * Result window changes colors to indicate when units are matched or
  67.      mismatched or when there is an error.
  68.    * Several menu items control the content and format of the units and
  69.      prefixes list.
  70.    * User-defined unit and prefix definitions can be entered into the
  71.      program directly or read from a text file.
  72.    * Results are formatted as appropriate to show as much information as
  73.      possible within the result window.
  74.    * Results are calculated and displayed as soon as there is a pause in
  75.      your typing--no need to press {Enter} to perform the calculation.
  76.  
  77.  
  78.                              Shareware Package
  79.  
  80.    * Contains Windows executable, Access Add-in, and Excel Add-In trial
  81.      versions of Entisoft Units.
  82.    * Installation program allows users to setup our software quickly and it
  83.      does not mess the Windows environment in any way.
  84.    * Installation program is optional, allowing more experienced users to
  85.      try our software directly.
  86.    * Available on CompuServe in the MSMASIC, MSACCESS, MSEXCEL, and other
  87.      Forum Libraries.
  88.    * Does not include the required VBRUN300.DLL file which is freely
  89.      available from several sources including our BBS.
  90.  
  91.  
  92.                             Registered Package
  93.  
  94.    * Registered users receive the complete Visual Basic source code to all
  95.      versions.
  96.    * Includes an additional data file with more than twenty categories of
  97.      technical data.
  98.    * Registered users can download the latest registered distribution of
  99.      Entisoft Units from our BBS.
  100.    * Does not contain the "nag" messages which appear each time that the
  101.      Shareware versions are opened and closed.
  102.    * Supplemental data file contains the full name, common names, and
  103.      ticker symbol definitions for most internationally-traded currencies. 
  104.      Users and developers must supply their own daily currency values as
  105.      appropriate, but this example shows you the necessary format for the
  106.      data.
  107.  
  108.                           Microsoft Excel Version
  109.  
  110.    * Conversion functions can be called from within Worksheets, Modules,
  111.      Charts, and Macros.
  112.    * Includes a simple calculator for performing measurement conversions
  113.      interactively.
  114.  
  115.  
  116.                          Microsoft Access Version
  117.  
  118.    * Conversion functions can be called from within Queries, Forms,
  119.      Reports, and Modules.
  120.    * Includes a simple calculator for performing measurement conversions
  121.      interactively.
  122.    * In the registered package, the Access version contains all of the
  123.      conversion factors, prefixes, and other definitions in the form of an
  124.      Access database Table.
  125.  
  126.  
  127.                               Macintosh Users
  128.  
  129.    * We do not officially support the use of our software on Macintosh
  130.      computers, nor have we thoroughly tested our software on a Macintosh,
  131.      however...
  132.    * Most of our Excel Add-In functions work with Excel 5.0 for Macintosh
  133.      because it does not use any Windows-specific functions.
  134.    * We believe that most of functions in the Project version Entisoft
  135.      Units will work with Microsoft Project for Macintosh for the same
  136.      reasons.
  137.    * You can try the Excel Add-In from our Shareware Distribution if you
  138.      have any questions about whether the features you need work when our
  139.      software is used on a Macintosh.
  140.    * We cannot offer Entisoft Units on Macintosh-format floppy diskettes at
  141.      this time so Mac users will need to acquire our software
  142.      electronically.
  143.    * Entisoft Units is distributed in a compressed PKZIP v2.04g format
  144.      file.  Mac users can get a PKZIP uncompression program from either
  145.      CompuServe or our BBS.
  146.  
  147.  
  148.                          Developer Considerations
  149.  
  150.    * Each version consists of about 10,000 lines of documented Visual
  151.      Basic/VBA source code.
  152.    * The Excel Add-In and secured Access Add-in versions can be freely
  153.      distributed with your custom applications.
  154.    * The source code can be compiled into your Visual Basic executables. 
  155.      It can also be included within your Excel Add-Ins and secured Access
  156.      applications, as long as it is not shared with unregistered users.
  157.    * Clear separation between back-end measurement conversion functions and
  158.      front-end user interface functions.
  159.    * All versions employ error detection and correction so that you are not
  160.      required to safeguard your use of our functions with error trapping.
  161.    * Source Code contains several generally useful functions from our
  162.      library.
  163.    * When measurements cannot be recognized, the functions return a string
  164.      error message suggesting possibe alternatives which either sound alike
  165.      or partially match the unknown name.
  166.    * Additional user-defined definitions can be easily embedded within the
  167.      source code itself.
  168.    * Contains functions for inserting new conversion factors/prefixes and
  169.      for modifying the existing definitions.  Also contains functions for
  170.      reading conversion factors from a text file.
  171.    * Conversion factors are read from text files in the form of Basic
  172.      function calls.  This single format for specifying unit and prefix
  173.      definitions means that they can be freely moved between the source
  174.      code, external text files, and the user-defined definitions box in the
  175.      Windows executable program.
  176.    * Functions cache certain important operations to improve the
  177.      performance of subsequent calls.
  178.    * The names of all "public" functions/subroutines, constants, and
  179.      user-defined types are prefixed with "est" to help avoid conflicts
  180.      with your existing code.
  181.    * Conversion functions can determine if cycles exist within the unit and
  182.      prefix definitions.
  183.    * The Visual Basic program does not currently require any custom
  184.      controls (VBXs, OCXs, etc.) nor dynamic link libraries (DLLs) other
  185.      than VBRUN300.DLL.  This means that developers can use the Standard
  186.      Edition of Visual Basic to modify, run, and compile the software.
  187.  
  188.  
  189.                                API Overview
  190.  
  191.    * estConvert performs measurement conversions given a numeric
  192.      measurement, the units of that measurement, and the desired units for
  193.      the result.  For example, estConvert(5, "feet", "meters") converts 5
  194.      feet into meters, returning 1.524.
  195.    * estConvertSpecial performs measurement conversions to and/or from
  196.      multiple related units, as well as supporting fractional numbers and
  197.      the rounding of results.  For example, estConvertSpecial("5' 11
  198.      13/16""", "m", "", 1000, False) converts 5 feet 11 13/16 inches into
  199.      meters, returning 1.824.
  200. e   * estConvertString performs similar conversions given a string
  201.      describing the conversion to be performed.  For example,
  202.      estConvertString("5 feet to meters") performs the same conversion as
  203.      in the above example.
  204.    * estConvertEnum enumerates the units represented by an expression.  For
  205.      example, estConvertEnum("KW*hr") returns "kilowatt hour".
  206.    * estConvertFindCat determines the physical measurement represented by
  207.      an expression.  For example, estConvertFindCat("KW*hr") returns
  208.      "energy".
  209.    * estConvertCheck performs several consistency checks of the
  210.      currently-defined measurements and prefixes.
  211.    * estConvertLoadFiles loads the unit and prefix definitions contained
  212.      within one or more text files.
  213.    * estConvertAddUnit registers a new conversion factor which Entisoft
  214.      Units can use within conversion calculations.  For example,
  215.      estConvertAddUnit("in", "inches", 1/12, "foot", "length") defines a
  216.      unit of length named "inches" with identifier "in" as 1/12 of a foot.
  217.    * estConvertAddPrefix registers a new prefix which Entisoft Units can
  218.      use within conversion calculations.  For example,
  219.      estConvertAddPrefix("m", "mega", 1000000) adds the prefix "mega"
  220.      identified by "m" as 1,000,000 (10^6).
  221.    * estConvertAddReplacement registers a new text string replacement which
  222.      Entisoft Units will attempt to apply during each conversion
  223.      calculation.  For example, estConvertAddReplacement("inch", "in", 0)
  224.      adds the synonym "inch" which is replaced everywhere that it occurs
  225.      within expressions by "in".
  226.  
  227.  
  228.                                Miscellaneous
  229.  
  230.    * Built-in definitions include several physical constants.
  231.    * Supports the conversion of temperatures which have different base
  232.      scales.
  233.    * Supports the conversion of resistor color codes to the corresponding
  234.      resistance values.
  235.  
  236.  
  237.                                   Pricing
  238.  
  239.                      Individual use license is $39.95.
  240.                         Multiple use site licenses:
  241.                         $30 each for 2-9 computers
  242.                        $24 each for 10-24 computers
  243.                        $20 each for 25-49 computers
  244.                        $14 each for 50-99 computers
  245.                       $10 each for 100-500 computers
  246.  
  247.  
  248.                            Orders & Information
  249.  
  250.                     Voice: 800-610-0440 or 310-312-0440
  251.                  Internet Mail: 76605.3550@compuserve.com
  252.                         CompuServe Mail: 76605,3550
  253.                              Fax: 310-479-7948
  254.  
  255.  
  256.                              Technical Support
  257.  
  258.                             Voice: 310-575-0142
  259.                  Internet Mail: 73200.3207@compuserve.com
  260.                         CompuServe Mail: 73200,3207
  261.                     BBS: 310-575-4192 (2400-28800 bps)
  262.  
  263.  
  264.                                   Address
  265.  
  266.                                  Entisoft
  267.                       10933 Wellworth Ave., Suite #13
  268.                         Los Angeles, CA 90024-6289
  269.                                     USA
  270.