Unit Conversion: Installation

Installation of the Unit Conversion program requires the following steps;

Unit Conversion is distributed as shareware. The package will run with some minor limitations, which are discussed here. If you find the trial version useful, please consider purchasing a license which will unlock the full functionality of the program.

For a detailed discussion of the files and registry settings created by the program, please click here.

Installation of Program

Unit Conversion Setup Icon To install the Unit Conversion program, you must be logged on as a computer administrator.

Unit Conversion is distribted as a self-extracting archive. Double click on the Unit Conversion Distribution.exe program icon (right). At the next prompt (below) click the "Unzip" button. The setup files should be extracted to a temporary directory, and the setup program should run.

Control screen for Unit Conversion self extracting archive

Animations scrolls through Unit Conversion setup screens

Follow the prompts as the installation proceeds; the animation running to the right loops through the sequence of setup screens. The only choices required are the installation directory and whether the program should be installed for all users or just for the current user. Most users can simply select the defaults.

First Time Setup

Once Unit Conversion has been installed, the program is run by clicking on the desktop icon or through the Windows Start menu (e.g. Start/Programs/Unit Conversion/Unit Conversion).

The first time the program is launched, the user must select a "working" directory in which his or her unit data file and registration information are stored. In addition, each user must read and acknowledge the disclaimer information.

The screen shown below appears when the program is started for the first time. Change the location of the working directory if desired, then click on the "Click here..." button to continue.

First time launch of Unit Conversion tool

The disclaimer screen appears next. You must scroll to the bottom of this document and click on the text, at which time you may click the check box at the bottom of the window in order to indicate that you accept the terms.

Unit Conversion disclaimer screen

Finally, the registration screen appears. If you have purchased a full version of Unit Conversion enter your name, exactly as submitted during the purchase process, and the corresponding registration code. If you are installing a trial license, you can leave the boxes blank. Click "OK" to continue.

Unit Conversion registration screen

Return to Top of Page

Setup of Excel© Component

Unit Conversion includes both a standalone program and an "add-in" for Microsoft Excel© that integrates all of the advanced features of this program with Excel ("Excel" and elements of the appearance of the Excel screen are obviously the property of the Microsoft corporation).

To install the Excel add-in, launch the installer worksheet from the Start Menu (e.g. Start/Programs/Unit Conversion/Unit Conversion). Click on the "Install Unit Conversion" button. Excel security setting must be configured to allow macros to run in in order to use the automated installation program. It is not necessary for macros to be enabled in order to use the Unit Conversion add-in once it has been properly configured. More information can be found in the spreadsheet itself, or by consulting Excel help.

Unit Conversion setup for use within Microsoft Excel
Return to Top of Page

Trial vs. Registered Version

Unit Conversion is shareware. The package can be installed and used "as is" for free. This free trial license is granted indefinitely for personal, educational or non-profit use. Commercial or for-profit use of the program requires registration after a limited 30 day evaluation period.

Some program features are unavailable or limited in "Trial" mode. Specifically;

  • The program must be restarted between calculations.
  • New or updated conversion factor data cannot be saved to the database for use in subsequent calculations.
  • The Excel© add-in must be launched from the ribbon between each calculation.
  • Only five Unit Conversion operations can be performed in a single Excel© session; the spreadsheet must be saved and Excel closed and re-opened in order to enable additional Unit Conversion operations.
  • The "UC" and "MW" functions for Microsoft Excel© are not available in the unregistered version.

For many users, these limitations may not be significant; individuals or non-profit institutions that find the program useful in Trial mode are welcome to continue using it indefinitely. For profit entities must register the software or uninstall the trial version after 30 days.


Return to Top of Page

Technical Details

Unit Conversion was written in Visual BASIC, using Microsoft Visual Studio© 2008. It reqires that the .NET framework be installed. The installation package was also created with Visual Studio... It copies the following files to the selected installation directory;

  • installer.xls is an Excel© workbook that contains a macro to automatically install the Excel© add-in.
  • license.txt is an ASCII file that contains the text of the software license terms that must be read during the installation process.
  • Microsoft.VisualBasic.PowerPacks.Vs.dll is a DLL (Dynamic Link Library) file required for the program to run.
  • project1.ico, helpfile.ico, addin.ico are icons for various components of Unit Conversion
  • Unit Conversion.exe is the program itself.
  • unit_conversion.xla is the Excel© add-in version of Unit Conversion.
  • unit_data.udt is an ASCII file containing the base set of unit definitions used by the program.
  • ucpad.xml is an XML "PAD" or Portable Application Description file, defined by the Association of Shareware Professionals
  • \help is a subdirectory containing an html help page (uclocal.html), plus seven supporting files and the MAP subdirectory which contains clickable map images.

When it is launched for the first time by a user, the Unit Conversion program copies the unit_data.udt and license.txt files to the working subdirectory selected by that user to house his or her data. The license.dat file is also created in the user data directory during the first session; it contains the user's name and, if the program has been registered, his or her registration code.

Unit conversion creates a set of Registry keys grouped in HKCU\Software\VB and VBA Program Settings\Convertit. This group of keys contains information such as the location of the data directory for the current user and various settings.

Unit conversion can be uninstalled from the Control Panel. Since the registry keys discussed above are created by the program during operation rather than during the installation process, they must be manually removed using Regedit. They can also be safely left in place, as they do not impact the operation of any other Windows programs or components.

Similarly, since the working directory is created by the program for each user, rather than by the installer, it must be manually deleted. It can also be safely left in place, as it takes up very little disk space. Note that if a new version of Unit Conversion is to be installed, both the registry keys and working directory must be left in place so that settings, registration information and user defined unit data will be available in the new version.


Return to Top of Page