@altara/industrial

Industrial / SCADA / HMI React components for Altara. Embeddable waterfall spectrogram (FFT + Canvas), OEE dashboard, PID tuning panel, alarm annunciator, multi-pen trend recorder, P&ID instrument symbols, process flow diagram, motor dashboard, and predictive-maintenance gauge — for manufacturing HMIs, energy control rooms, water-treatment dashboards, smart-factory monitors, and process-control UIs.

Install

npm install @altara/core @altara/industrial

Import the design-token stylesheet from @altara/core once at your app root:

import '@altara/core/styles.css';

Quick start

import { AltaraProvider } from '@altara/core';
import { WaterfallSpectrogram, OEEDashboard, AlarmAnnunciatorPanel } from '@altara/industrial';

export function FactoryFloor() {
  return (
    <AltaraProvider theme="dark">
      <WaterfallSpectrogram mockMode width={720} height={360} />
      <OEEDashboard mockMode shift="A1" />
      <AlarmAnnunciatorPanel mockMode columns={6} />
    </AltaraProvider>
  );
}

Components

| Component | Description | | --- | --- | | WaterfallSpectrogram | Real-time FFT spectrogram waterfall — Hann window + radix-2 FFT, dB color mapping (heat / viridis / plasma / grayscale). Built for vibration / acoustic / RF analysis. | | OEEDashboard | Overall Equipment Effectiveness — three ring gauges (availability × performance × quality) + Pareto loss-category chart. | | AlarmAnnunciatorPanel | Industrial alarm tile grid — blink while unacknowledged, click to acknowledge, priority-based status colors. | | TrendRecorder | Multi-pen chart recorder, up to 8 channels each on its own Y range. Time scales from 1 minute to 24 hours. | | PIDTuningPanel | Setpoint / process-value / controller-output overlay with Kp/Ki/Kd readouts and live error band. | | PIDNode | Single P&ID instrument symbol per the ISA 5.1 standard (FIC, TT, PIC, …). Field / panel / DCS location styles. | | ProcessFlowDiagram | Composable SVG diagram — tanks, pumps, heat exchangers, valves, instruments connected by flow paths. | | MotorDashboard | Motor health — RPM, torque, current, temperature in arc gauges + active fault log. | | PredictiveMaintenanceGauge | Weighted health index from contributor metrics (vibration / temperature / current / acoustic), plus RUL with confidence band. |

Showcase

FFT performance

WaterfallSpectrogram runs an inline radix-2 Cooley-Tukey FFT — fine at fftSize ≤ 2048 and scrollRate ≤ 30 Hz on modern hardware. For very large FFTs at high cadences, push the work into a Web Worker via createWorkerDataSource from @altara/core to keep the main thread at 60 fps.

Data sources

Every component accepts an AltaraDataSource from @altara/core. Pair with @altara/mqtt for broker-published industrial telemetry (Mosquitto, HiveMQ, EMQX), or @altara/ros for collaborative-robotics / process-line ROS2 deployments.

Documentation

The full component playground lives in the project Storybook:

git clone https://github.com/JayaSaiKishanChapparam/altara.git
cd altara
pnpm install
pnpm --filter @altara/storybook storybook

Open the Industrial/ section.

Sibling packages

| Package | What it does | | --- | --- | | @altara/core | Components, hooks, MQTT/mock adapters, design tokens. The starting point. | | @altara/aerospace | Flight instruments — PFD, HSI, altimeter, airspeed, VSI, engine cluster, TCAS, TAWS, FMA, fuel gauge, radio altimeter. | | @altara/av | Autonomous-vehicle UI — LiDAR (Three.js), occupancy grid, object detection, path planner, perception state machine, SLAM, radar, control trace. | | @altara/ros | ROS2 / rosbridge adapter + typed factories for common sensor_msgs/* message types. | | @altara/mqtt | MQTT-over-WebSocket adapter for IoT brokers. |

Links

• GitHub repository
• Issue tracker
• Discussions

License

MIT — see LICENSE.