Logo Icon

News | FAQ | Screenshots | Help

View full version

Customization

Unit Conversions and Constants

If you have purchased RealCalc Plus, you can customize the unit conversion and constant tables. These are stored in an xml data file. This data can be exported to a file on your device or a cloud service, edited, then imported back into the calculator. Using a cloud service such as Google Drive will allow you to keep a copy of your customized data and import it easily to multiple devices.

To customize the conversions/constants:

  1. Go to Menu > Settings and scroll down to the Customization section.
  2. Tap 'Export …' and select a destination for the xml file. This can be on your device or on a cloud service such as Google Drive. It will be named 'realcalc-data.xml' by default.
  3. Edit the file, following the existing data as an example. You can add, change or remove units and constants or whole groups. You will need to use a text editor which supports UTF-8, such as Notepad on Windows (but not WordPad). A more powerful editor such as Notepad++ is recommended.
  4. Select 'Import …' from the Customization section of the settings and select the file for import. If there are any errors in your xml file, you will be notified and the import will not change anything. Correct the errors and repeat the import.
  5. Return to the main calculator screen. The CONV and CNST functions will now use your new custom conversions and constants.

To restore default conversions/constants:

  1. Go to Menu > Settings and select 'Reset to defaults' in the Customization section.
  2. Select 'OK' to confirm.
  3. Return to the main calculator screen. The default CONV and CNST functions will now be restored.

For RealCalc v2.x, please see below for old instructions.

Examples

Fuel Consumption

Showing use of inverse units. In this example, the ratio for litres per 100km is set as if the unit were 100km per litre, and the attribute inverse="true" is added.

  <group name="Fuel Consumption">
    <unit name="Kilometres per litre"   symbol="km/l"        ratio="1.0"                    />
    <unit name="Litres per 100km"       symbol="l/100km"     ratio="100.0" inverse="true"   />
    <unit name="Miles per gallon (Imp)" symbol="mpg (Imp)"   ratio="1.609344/4.54609"       />
    <unit name="Miles per gallon (US)"  symbol="mpg (US)"    ratio="1.609344/3.785411784"   />
  </group>

Frequency/Wavelength

<group name="Frequency/Wavelength">
  <unit name="Hertz"     symbol="Hz"  ratio="1.0"              />
  <unit name="Kilohertz" symbol="kHz" ratio="1000.0"           />
  <unit name="Megahertz" symbol="MHz" ratio="1000000.0"        />
  <unit name="Metres"    symbol="m"   ratio="299792458"        inverse="true" />
  <unit name="Feet"      symbol="ft"  ratio="299792458/0.3048" inverse="true" />
</group>

RealCalc v2.x

To customize the conversions/constants:

  1. Go to Menu > Settings > Customization Options.
  2. Select 'Export …'. The data will be written to your device's storage in 'realcalc/data.xml'.
  3. Copy the data.xml file to your computer.
  4. Edit the data.xml file, following the existing data as an example. You can add, change or remove units and constants or whole groups. You will need to use a text editor which supports UTF-8, such as Notepad on Windows (but not WordPad). A more powerful editor such as Notepad++ is recommended.
  5. When finished, copy the file back to the same place on your device.
  6. Select 'Import …' from the Customization Options screen. If there are any errors in your xml file, you will be notified and the import will not change anything. Correct the errors and repeat the import.
  7. Return to the main calculator screen. The CONV and CNST functions will now use your new custom conversions and constants.
  8. It is recommended that you keep your data.xml file as a backup. If you have to uninstall RealCalc for any reason, your customizations will be lost, but you can re-import the data.xml file at any time.

To restore the default conversions/constants:

  1. Go to Menu > Settings and select 'Customization Options'.
  2. Select 'Reset to defaults …' and confirm.
  3. Return to the main calculator screen. The default CONV and CNST functions will now be restored.