About MEASUR

MEASUR (Manufacturing Energy Assessment Software for Utility Reduction) is part of the Oak Ridge National Laboratory (ORNL) Industrial Resources suite. MEASUR empowers manufacturers to boost energy efficiency at both the plant and system levels. The application guides users step-by-step to identify opportunities, monitor progress, and drive continuous improvement. It also supports energy management system implementation and helps facilities prepare for ISO 50001 and Superior Energy Performance certification. MEASUR is a modern refactoring of legacy Department of Energy (DOE) tools, developed by ORNL to bring advanced energy analysis to today’s industrial environments.

MEASUR, like it's sibling applications VERIFI and JUSTIFI, is developed as a web application but is also packaged and distributed as an installable desktop application.

The latest web version of the application can be found at https://measur.ornl.gov

Installable versions of the application can be found under the releases section of this repository.

Alternatively, downloads and additional information about ORNL's suite of tools can be found at ORNL's Industrial Resources site.

📋 Project Board

Track our progress and planned work on the MEASUR GitHub Project Board.

MEASUR Tools Suite

MEASUR calculations are powered by the MEASUR-Tools-Suite. A C++ library with a WebAssembly compilation target.

MEASUR Modules

The application has a variety of modules outlined below.

System & Equipment Assessment Modules

Evaluating financial and energy impacts of modifications to different energy consuming systems:

Module	Status	Description
Pump	✅ Available	Assess pump system efficiency and savings
Compressed Air	✅ Available	Analyze compressed air systems
Process Heating	✅ Available	Evaluate process heating improvements
Fan	✅ Available	Assess fan system efficiency and savings
Steam	✅ Available	Steam system analysis
Treasure Hunt	✅ Available	Identify low-cost/no-cost energy-saving opportunities
Wastewater	✅ Available	Wastewater system assessment
Water	🟡 Beta	Water system analysis
Process Cooling	🛠️ In Development	Process cooling system assessment

Equipment Inventories Modules

Track facility equipment and populate assessment modules via equipment inventories:

Inventory Module	Status	Description
Motor	✅ Available	Track and manage motor inventory
Pump	✅ Available	Track and manage pump inventory
Compressed Air	✅ Available	Track and manage compressed air equipment
Fans	⏳ Planned	Fan inventory management
Process Cooling	⏳ Planned	Process cooling inventory
Hot and Cold Flows	⏳ Planned	Hot/cold flow inventory
Maintenance Logs	⏳ Planned	Equipment maintenance logging

Additional Modules

Enhance your analysis and visualization with these supporting tools:

Module	Status	Description
Data Explorer	✅ Available	Visualize, categorize, and analyze logger data
Water Diagram	🟡 Beta	Interactive water system mapping and visualization

🧮 Standalone Calculators

MEASUR includes a comprehensive suite of over 80 standalone equipment calculators for energy analysis, system optimization, and cost savings.
See the full categorized list with descriptions and links in docs/calculator_list.md.

For Developers

🛠️ Dependencies

• Node.js LTS
  The MEASUR team recommends managing Node versions using Node Version Manager (NVM). The recommended Node.js version is specified in the project's package.json under the engines field.

---

🚀 Install and Run the Project

1. Install Node Dependencies for All Modules

Note: Both /AMO-Tools-Desktop and /AMO-Tools-Desktop/process-flow-diagram-component must have their dependencies installed for a successful build.

Quick Install (recommended):

npm run install-packages

Manual Install:

# Install process-flow-diagram-component dependencies
cd /AMO-Tools-Desktop/process-flow-diagram-component
npm install

# Install Angular project dependencies
cd /AMO-Tools-Desktop
npm install

---

2. Build for Development

Note: It is recommended to develop using the web build (npm run start) unless you are specifically working on Electron-only features. This provides faster reloads and a smoother development experience.

• Serve the web build:

  npm run start

• Build for Electron development with hot-reload:

  npm run build-watch

  • To start the Electron app:

    npm run electron

---

3. Build for Production

• Build the desktop installer:

  npm run build-prod-desktop
  npm run dist

  The package will be placed in the output directory.

• Build the web distribution:

  npm run build-prod-web

---

ℹ️ Workflow Specifics

Reset All Project Build Artifacts and Dependencies

This script removes /dist, package-lock.json, and node_modules for both /AMO-Tools-Desktop and /AMO-Tools-Desktop/process-flow-diagram-component:

npm run reset

---

Upgrade MEASUR-Tools-Suite

MEASUR-Tools-Suite available versions are published to the npm registry measur-tools-suite npm

IMPORTANT: Both /AMO-Tools-Desktop and /AMO-Tools-Desktop/process-flow-diagram-component MEASUR-Tools-Suite versions must match to avoid API version conflicts

To upgrade the MEASUR-Tools-Suite dependency:

• Specify Version:
  modify the package.json file in both /AMO-Tools-Desktop and /AMO-Tools-Desktop/process-flow-diagram-component with the desired version.
• Reset, Install, and Run:
  Follow steps above to Reset All Project Build Artifacts and Dependencies, then follow steps for Install and Run the Project

---

ℹ️ More Information

Bundled Dependencies

Process Flow Diagram Component

MEASUR depends on this native web component built in React (using ReactFlow). The process-flow-diagram-component webpack build runs concurrently with the main project, and the component is copied into the Angular /dist output and referenced in the Angular project's index.html.

Process Flow Library

Both MEASUR and the Process Flow Diagram Component depend on /process-flow-lib as a shared library of types, calculations, and utility methods.

License

This project is licensed under the MIT License. See LICENSE for details.