graFMECA

This tool helps visualize FMECA analyses directly in your browser to make working with FMECA tables easier.

The FMECA table is displayed as a layered graph, allowing you to explore relationships between functions and failure modes interactively.

Your data is processed locally in the browser — no information is uploaded or transferred elsewhere.

The interface allows you to:

• filter entries by numeric values (e.g., severity, probability, criticality)
• select nodes and focus on their connected neighbors
• explore relationships within the FMECA structure interactively

Getting Started

You can use the tool without downloading the entire project.

1. Download the file graFMECA.html.
2. Open it in your web browser.
3. Upload your FMECA CSV file using the interface.

---

CSV Format

We provide an example FMECA CSV file:
FMECA-example.csv

Your CSV file must include the following columns:

• function
• failure mode
• failure cause
• failure detection
• compensation provision

Optional numeric columns (used for filtering):

• criticality number
• probability number
• severity number

If your CSV uses different or additional column names, you can adjust them in the configuration panel on the left side of the tool.

---

Development

This is a Vite + React + TypeScript project. Requires Node.js 18+.

npm install      # install dependencies
npm run dev      # start the dev server with hot reload
npm run build    # type-check (tsc -b) and produce a production build
npm test         # run the test suite (vitest)

Building the single-file app

npm run build uses vite-plugin-singlefile to inline all JS, CSS, and assets into one self-contained HTML file at dist/index.html. This file runs entirely offline, no server needed.

The graFMECA.html shipped in this repo is that build output copied to the project root. To refresh it after changes:

npm run build
cp dist/index.html graFMECA.html

---

License

This project is licensed under the MIT License — see the LICENSE file for details.