Unit


Last updated: 2026-03-29

Units of Measurement

The Unit module allows you to define and manage the different units of measurement used in your laboratory or clinic (such as milligrams, liters, or percentages). By grouping these units into categories and giving them conversion factors, the system can automatically calculate and convert lab results for you.

When Do I Use This?

  • When setting up a new lab test that requires a specific measurement unit.
  • When you need the system to automatically convert results (for example, converting grams to milligrams).
  • When organizing your measurements into logical categories like "Weight", "Volume", or "Concentration".

How To Use

1. Creating a Unit Category

Before creating specific units, you need a category to group them (e.g., "Weight").

  1. Navigate to the Unit Categories section.
  2. Click + New.
  3. Enter a Name (e.g., "Weight") and a brief Description.
  4. Click Save.

2. Creating a Unit

Once your category exists, you can add units to it.

  1. Navigate to the Units section.
  2. Click + New.
  3. Enter the Name (e.g., "Kilogram") and Code (e.g., "kg").
  4. Select the correct Category from the dropdown menu.
  5. Enter the Factor (see the tip below for how to calculate this).
  6. Ensure the Active box is checked so staff can use it.
  7. Click Save.

Field Descriptions

Unit Fields

Field Name Description
Name The full, readable name of the unit (e.g., "Milligram").
Code The standard abbreviation for the unit that will appear on printed reports (e.g., "mg").
Category The group this unit belongs to (e.g., "Weight"). The system only allows conversions between units in the same category.
Factor The multiplier used to convert this unit to the category's "Base Unit". The Base Unit must always have a factor of 1.0.
Active Check this box to make the unit available for use. Uncheck it to hide the unit without deleting it.

Category Fields

Field Name Description
Name The title of the category (e.g., "Volume").
Description A short note explaining what types of units belong here.
Tip on Base Units & Factors: Every category needs one "Base Unit" with a Factor of 1.0. All other units in that category are calculated against it.

Example for "Weight":
If your Base Unit is Gram (Factor: 1.0):
- Kilogram is 1000 times larger, so its Factor is 1000.0.
- Milligram is 1/1000th of a gram, so its Factor is 0.001.