منصوبے کے بارے میں

Altara ایک React کمپوننٹ لائبریری ہے جو روبوٹکس، ایرو اسپیس، خود مختار گاڑیوں اور صنعتی IoT ایپلیکیشنز میں ریئل ٹائم ٹیلی میٹری ڈیش بورڈز بنانے کے لیے ڈیزائن کی گئی ہے۔ یہ کینوس پر رینڈر کردہ آلات، ٹائم سیریز چارٹس، لائیو نقشے اور فلائٹ ڈسپلے فراہم کرتی ہے جنہیں براہ راست کسی بھی React ایپلیکیشن میں شامل کیا جا سکتا ہے۔ لائبریری کئی پیکجز میں منظم ہے: - **@altara/core**: بنیادی پیکج جس میں TimeSeries، Gauge، Attitude، SignalPanel، LiveMap، EventLog، ConnectionBar، MultiAxisPlot اور DashboardLayout جیسے کمپوننٹس شامل ہیں۔ اس میں ڈیٹا سورس اڈاپٹر (mock، MQTT) اور مین تھریڈ سے باہر ڈیسی میشن کے لیے ورکر پر مبنی پائپ لائن بھی شامل ہے۔ - **@altara/aerospace**: فلائٹ آلات بشمول PrimaryFlightDisplay، HorizontalSituationIndicator، Altimeter، VerticalSpeedIndicator، AirspeedIndicator، EngineInstrumentCluster، RadioAltimeter، TerrainAwareness، TCASDisplay، AutopilotModeAnnunciator اور FuelGauge۔ - **@altara/av**: خود مختار گاڑیوں کے UI کمپوننٹس جیسے LiDARPointCloud (Three.js)، OccupancyGrid، ObjectDetectionOverlay، PathPlannerOverlay، VelocityVectorDisplay، PerceptionStateMachine، SensorHealthMatrix، CameraFeed، ControlTrace، RadarSweep اور SLAMMap۔ - **@altara/industrial**: SCADA/HMI کمپوننٹس بشمول WaterfallSpectrogram (FFT)، OEEDashboard، AlarmAnnunciatorPanel، TrendRecorder، PIDTuningPanel، PIDNode، ProcessFlowDiagram، MotorDashboard اور PredictiveMaintenanceGauge۔ - **@altara/ros**: ایک rosbridge اڈاپٹر جس میں عام sensor_msgs میسج ٹائپس کے لیے ٹائپ شدہ فیکٹریاں ہیں۔ - **@altara/mqtt**: ایک MQTT-over-WebSocket اڈاپٹر۔ اہم خصوصیات میں شامل ہیں: - **اعلی کارکردگی**: کینوس رینڈرنگ جس میں requestAnimationFrame اور RingBuffer استعمال کرتے ہوئے ہموار 60+ fps اپڈیٹس ملتے ہیں۔ ایک ورکر پائپ لائن ڈیٹا انجیشن اور ڈیسی میشن کو مین تھریڈ سے باہر منتقل کرتی ہے تاکہ زیادہ تھرو پٹ فیڈز حاصل ہوں۔ - **موک موڈ**: ہر کمپوننٹ ایک `mockMode` سپورٹ کرتا ہے جو حقیقت پسندانہ مصنوعی ڈیٹا پیدا کرتا ہے، جس سے حقیقی ڈیٹا سورسز سے منسلک ہونے سے پہلے پروٹوٹائپ بنانا آسان ہو جاتا ہے۔ - **SSR کے لیے موزوں**: تمام پیکجز `"use client"` ڈائریکٹیو کے ساتھ آتے ہیں، جس سے Next.js App Router سرور کمپوننٹس میں دستی کلائنٹ ریپرز کے بغیر براہ راست امپورٹ ممکن ہوتی ہے۔ اختیاری پیر ڈیپنڈنسیز (Leaflet، Three.js، MQTT) رن ٹائم پر متحرک طور پر امپورٹ کی جاتی ہیں۔ - **ڈیٹا اڈاپٹر**: rosbridge کے ذریعے ROS2، MQTT بروکرز سے منسلک ہوں، یا بلٹ ان موک اور ورکر پر مبنی ڈیٹا سورسز استعمال کریں۔ - **تھیمنگ**: ایک `AltaraProvider` تھیمنگ (مثلاً ڈارک تھیم) سپورٹ کرتا ہے۔ README میں Grafana، Foxglove اور Recharts کے ساتھ موازنہ شامل ہے، جو Altara کو ایک ایسی لائبریری کے طور پر پیش کرتا ہے جو React ایپس میں قدرتی طور پر شامل ہوتی ہے، جس میں ایرو اسپیس اور صنعتی آلات پر توجہ دی گئی ہے۔ یہ رینڈرنگ کارکردگی اور ورکر پائپ لائن کی اہلیت کے لیے بینچ مارک نتائج بھی فراہم کرتا ہے۔ Altara پری-1.0 ہے، جس کا عوامی API ابھی تک مستحکم نہیں سمجھا جاتا۔ دستاویزات میں لائیو ڈیمو کے ساتھ ایک Storybook، ملٹی ٹیب ڈیمو ڈیش بورڈ، گائیڈز، کک بکس اور موازنے شامل ہیں۔ ریپوزٹری ایک مونو ریپو کے طور پر منظم ہے جس میں پیکجز، ایپس (Storybook اور ڈیمو)، ROS2 کے لیے Docker سیٹ اپ اور بینچ مارکنگ اور GIF ریکارڈنگ کے لیے اسکرپٹس شامل ہیں۔