Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

AMO-Tools-Desktop

An energy efficiency calculation application for use with industrial equipment such as pumps, furnaces, fans, and motors, as well as for industrial systems such as steam.
https://github.com/ORNL-AMO/AMO-Tools-Desktop

Category: Consumption
Sub Category: Production and Industry

Keywords

energy energy-assessment energy-efficiency factory furnace industrial industrial-technology measur modeling modeling-tool plants pump steam

Keywords from Contributors

fans process-heating emissions

Last synced: about 4 hours ago
JSON representation

Repository metadata

AMO-Tools-Desktop (MEASUR) helps industrial facilities improve system-level energy efficiency. Provides detailed analysis of industrial systems to identify system-level energy-savings opportunities.

README.md

About MEASUR

Build Status
Latest Release
Issues
Pull Requests
Contributors
Last Commit

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.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 9,810
Total Committers: 44
Avg Commits per committer: 222.955
Development Distribution Score (DDS): 0.545

Commits in past year: 768
Committers in past year: 8
Avg Commits per committer in past year: 96.0
Development Distribution Score (DDS) in past year: 0.557

Name Email Commits
mark-root m****t@i****m 4461
nblondheim n****m@i****m 1761
rhernandez-intertech r****z@i****m 975
Dmitry Howard d****d@i****m 630
Robert Root r****t@l****m 279
pshires p****1@v****u 191
Gia Jacob m****9@g****m 182
ysintertech y****s@i****m 115
INTERTECH\jdepauw j****w@i****m 112
Jon Hadden j****n@n****m 108
Woodrow Kromar w****r@i****m 94
Kai Chen d****3@g****m 85
causeyc 4****c 61
Mlwhitmer w****m@g****m 61
Kyle Beanblossom k****1@g****m 61
dependabot[bot] 4****] 61
Allie Ledbetter a****9@g****m 54
Rappoport b****p@u****u 53
Hayden Esser e****r@o****v 51
shivasaurus s****t@g****m 48
qpk k****p@o****v 45
JL102 j****s@m****g 44
Rappoport 1****r@m****v 41
zf9 f****h@g****m 39
c-merch c****4@p****u 28
shubhamkokul s****l@g****m 25
Zach Fontenot f****z@e****u 24
Gina Accawi a****k@o****v 21
Whitmer i****w@o****v 17
Chen 7****q@o****v 11
and 14 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 4 months ago

Total issues: 913
Total pull requests: 1,101
Average time to close issues: 8 months
Average time to close pull requests: 2 days
Total issue authors: 16
Total pull request authors: 7
Average comments per issue: 0.66
Average comments per pull request: 0.06
Merged pull request: 931
Bot issues: 1
Bot pull requests: 95

Past year issues: 328
Past year pull requests: 663
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 1 day
Past year issue authors: 4
Past year pull request authors: 6
Past year average comments per issue: 0.29
Past year average comments per pull request: 0.05
Past year merged pull request: 542
Past year bot issues: 0
Past year bot pull requests: 40

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ORNL-AMO/AMO-Tools-Desktop

Top Issue Authors

  • nbintertech (420)
  • koay9f (321)
  • rhernandez-intertech (97)
  • rmroot (44)
  • AlexBotts (7)
  • gaccawi (5)
  • esserhr (4)
  • kaichen127 (4)
  • vanced (2)
  • JL102 (2)
  • DmitryHoward (2)
  • FontenotZach (1)
  • probonopd (1)
  • wenningtj (1)
  • dependabot[bot] (1)

Top Pull Request Authors

  • nbintertech (669)
  • rhernandez-intertech (217)
  • dependabot[bot] (95)
  • rmroot (50)
  • esserhr (48)
  • kaichen127 (17)
  • WoodrowKromar (5)

Top Issue Labels

  • bug (172)
  • Water (124)
  • enhancement (124)
  • Calculator (94)
  • Application (82)
  • Process Heating (79)
  • Treasure Hunt (70)
  • Needs Engineering! (68)
  • Compressed Air (68)
  • Steam (58)
  • Pumps (53)
  • Epic (52)
  • Fans (51)
  • Compressed Air Inventory (50)
  • Status Check (46)
  • Intern To Do (44)
  • low priority (37)
  • Expert Submitted (31)
  • Process Cooling (30)
  • Data Explorer (27)
  • Reports (21)
  • Stale (20)
  • important (20)
  • question (17)
  • Waste Water (17)
  • Databases (17)
  • Help Text (16)
  • CO2 Emissions (16)
  • help wanted (15)
  • Motor Inventory (15)

Top Pull Request Labels

  • dependencies (95)
  • javascript (57)
  • github_actions (4)
  • bug (2)
  • devops (2)

Package metadata

proxy.golang.org: github.com/ornl-amo/amo-tools-desktop

proxy.golang.org: github.com/ORNL-AMO/AMO-Tools-Desktop

Dependencies

package-lock.json npm
  • 1414 dependencies
package.json npm
  • @angular-devkit/build-angular 13.2.5 development
  • @angular-devkit/core 13.2.5 development
  • @angular-devkit/schematics 13.2.5 development
  • @angular/cli 13.2.5 development
  • @types/jasmine ~3.6.0 development
  • @types/lodash 4.14.100 development
  • @types/node ^14.18.12 development
  • angular-plotly.js ^4.0.4 development
  • axios ^0.27.2 development
  • codelyzer ^6.0.2 development
  • electron 13.6.6 development
  • electron-builder ^23.1.0 development
  • electron-download-tf 4.3.4 development
  • electron-packager 15.2.0 development
  • jasmine-spec-reporter ~5.0.0 development
  • jquery 3.5.0 development
  • karma ^6.3.14 development
  • karma-chrome-launcher ~3.1.0 development
  • karma-cli ~1.0.1 development
  • karma-coverage-istanbul-reporter ^0.2.0 development
  • karma-jasmine ~4.0.0 development
  • karma-jasmine-html-reporter ^1.5.0 development
  • lodash.foreach ^4.5.0 development
  • lodash.keys ^4.2.0 development
  • moment ^2.29.2 development
  • ngx-bootstrap 8.0.0 development
  • ngx-clipboard 15.0.1 development
  • nodemon ^2.0.16 development
  • papaparse ^5.1.0 development
  • plotly.js-dist ^2.9.0 development
  • protractor ^7.0.0 development
  • ts-node 8.0.3 development
  • tslint ^6.1.3 development
  • typescript 4.5.5 development
  • @angular/animations 13.2.4
  • @angular/common 13.2.4
  • @angular/compiler 13.2.4
  • @angular/compiler-cli 13.2.4
  • @angular/core 13.2.4
  • @angular/forms 13.2.4
  • @angular/localize 13.2.4
  • @angular/platform-browser 13.2.4
  • @angular/platform-browser-dynamic 13.2.4
  • @angular/platform-server 13.2.4
  • @angular/router 13.2.4
  • @ng-bootstrap/ng-bootstrap 12.0.0
  • @popperjs/core ^2.11.2
  • ajv 6.12.5
  • amo-tools-suite 1.0.0
  • bootstrap 4.3.1
  • c3 0.7.20
  • core-js 3.21.1
  • electron-log 4.2.4
  • electron-updater 4.3.5
  • exceljs ^4.3.0
  • file-saver ^2.0.5
  • font-awesome ^4.7.0
  • ngx-electron 2.2.0
  • ngx-indexed-db ^9.4.2
  • pptxgenjs ^3.10.0
  • regression ^2.0.0
  • rxjs ^7.5.5
  • rxjs-compat 6.6.3
  • xlsx ^0.17.0
  • zone.js 0.11.4

Score: -Infinity