Simplation

A powerful command-line tool for analyzing and visualizing simulation data from CSV files.

Stable Version 3.0.3 : https://pypi.org/project/simplation/3.0.3/

Features

- Statistical Analysis     : Mean, RMS, min, max, peak-to-peak
- Signal Quality Metrics   : Crest factor, form factor, ripple factor, THD
- Power System Analysis    : Efficiency, power factor calculations
- Rich Visualization       : Beautiful tables and colored output
- Fuzzy Matching           : Intelligent signal name matching
- Complex Expressions      : Combined Mathematical operations
- Auto Unit Detection      : Automatic unit recognition from signal names
- Plotting                 : plot signals vs time or signal vs signal

Installation

pip install simplation

Requirements

- Python     : 3.10.8    or higher
- NumPy      : 1.22.4    or higher
- pandas     : 2.2.2     or higher  
- Matplotlib : 3.6.2     or higher
- PyFiglet   : 0.8.post1 or higher
- Rich       : 14.0.0    or higher
- Colorama   : 0.4.6     or higher

Quick Start

# Launch the interactive tool
simplation

# Or run directly on a CSV file
simplation --file data.csv

Available Commands

Type help in the interactive tool to see all available commands, or examples for detailed usage examples.

SIMPLATION USAGE EXAMPLES

1. BASIC STATISTICS:
   - mean of Output Voltage           -  Average output voltage
   - rms of Input Current             -  RMS value of input current
   - max of Transformer Temperature   -  Maximum temperature reached
   - min of Output Power              -  Minimum power output
   - ptp of Ripple Voltage            -  Peak-to-peak ripple voltage
   - std of Noise Signal              -  Standard deviation of noise

2. SIGNAL QUALITY ANALYSIS:
   - crest factor of Motor Current    - Ratio of peak to RMS current
   - form factor of AC Voltage        - Waveform shape quality factor
   - ripple factor of DC Output       - AC component relative to DC
   - thd of Mains Voltage             - Total Harmonic Distortion

3. POWER SYSTEM ANALYSIS:
   - efficiency of Output Power vs Input Power     - System efficiency
   - power factor of Mains Voltage vs Line Current - Power factor

4. VISUALIZATION:
   - plot Output Voltage              - Plot voltage vs time
   - plot Output Current vs Time      - Plot current vs time  
   - plot Efficiency vs Load          - Plot efficiency vs load parameter
   - plot Temperature vs Output Power - Correlation analysis

5. COMPLEX EXPRESSIONS:
   - (mean of Vout * max of Iout) / 1000
   - (rms of Voltage * rms of Current)
   - std of Noise / mean of Signal
   - (max of Temperature - min of Temperature) / 2
   - (ptp of Ripple / mean of DC) * 100
   - efficiency of Output Power vs Input Power * 100

6. MULTI-SIGNAL ANALYSIS:
   - stats                           - Show all signals statistics
   - stats Output Voltage            - Detailed stats for specific signal
   - list                            - Browse all available signals

7. REAL-WORLD SCENARIOS:

   • Power Supply Analysis:
     - mean of Output Voltage
     - ptp of Output Ripple
     - efficiency of Output Power vs Input Power
     - crest factor of Input Current

   • Motor Drive Analysis:
     - max of Motor Current
     - rms of Phase Voltage
     - power factor of Input Voltage vs Input Current
     - plot Motor Speed vs Torque

   • Thermal Analysis:
     - max of Junction Temperature
     - mean of Heat Sink Temperature  
     - stats Temperature Signals
     - plot Temperature vs Time

   • Power Quality:
     - thd of Input Voltage
     - thd of Input Current
     - power factor of Grid Voltage vs Grid Current