# Simplation
A powerful command-line tool for analyzing and visualizing simulation data from CSV files.
## Features
- 📊 **Statistical Analysis**: Mean, RMS, standard deviation, 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**: Mathematical operations combining multiple signals
- 🎯 **Auto Unit Detection**: Automatic unit recognition from signal names
## Installation
```bash
pip install simplation
https://pypi.org/project/simplation/3.0.0/
```
```bash
Quick Start
bash
# Launch the interactive tool
simplation
# Or run directly on a CSV file
simplation --file data.csv
```
```bash
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 - Power calculation
(rms of Voltage * rms of Current) - Apparent power
std of Noise / mean of Signal - Signal-to-noise ratio
(max of Temperature - min of Temperature) / 2 - Temperature swing
(ptp of Ripple / mean of DC) * 100 - Ripple percentage
efficiency of Output Power vs Input Power * 100 - Efficiency in %
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
──────────────────────────────────────────────────────────────────────
💡 TIPS:
• Use fuzzy matching: 'mean of vout' will match 'Output Voltage'
• Complex expressions support: +, -, *, /, (), **
• Units are auto-detected: [V], [A], [W], [°C], etc.
• Rich tables for better data visualization
• Colors for easy result interpretation
Raw data
{
"_id": null,
"home_page": "https://github.com/Gueni/simplation",
"name": "simplation",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "simulation, data-analysis, csv, engineering, visualization, statistics",
"author": "Mohamed Gueni",
"author_email": "Mohamed Gueni <mohamedgueni@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/2d/08/8d7275255d1eabbdff5b3f29f7ed3f33527cb699bc78f22afe6193ff04cb/simplation-3.0.0.tar.gz",
"platform": null,
"description": "# Simplation\r\n\r\nA powerful command-line tool for analyzing and visualizing simulation data from CSV files.\r\n\r\n## Features\r\n\r\n- \ud83d\udcca **Statistical Analysis**: Mean, RMS, standard deviation, min, max, peak-to-peak\r\n- \ud83d\udcc8 **Signal Quality Metrics**: Crest factor, form factor, ripple factor, THD\r\n- \u26a1 **Power System Analysis**: Efficiency, power factor calculations\r\n- \ud83c\udfa8 **Rich Visualization**: Beautiful tables and colored output\r\n- \ud83d\udd0d **Fuzzy Matching**: Intelligent signal name matching\r\n- \ud83d\udccb **Complex Expressions**: Mathematical operations combining multiple signals\r\n- \ud83c\udfaf **Auto Unit Detection**: Automatic unit recognition from signal names\r\n\r\n## Installation\r\n\r\n```bash\r\npip install simplation\r\n\r\nhttps://pypi.org/project/simplation/3.0.0/\r\n```\r\n```bash\r\nQuick Start\r\nbash\r\n# Launch the interactive tool\r\nsimplation\r\n\r\n# Or run directly on a CSV file\r\nsimplation --file data.csv\r\n```\r\n```bash\r\nAvailable Commands\r\nType help in the interactive tool to see all available commands, or examples for detailed usage examples.\r\n\r\n```\r\n\ud83d\udcda SIMPLATION USAGE EXAMPLES\r\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n1. BASIC STATISTICS:\r\n mean of Output Voltage - Average output voltage\r\n rms of Input Current - RMS value of input current\r\n max of Transformer Temperature - Maximum temperature reached\r\n min of Output Power - Minimum power output\r\n ptp of Ripple Voltage - Peak-to-peak ripple voltage\r\n std of Noise Signal - Standard deviation of noise\r\n\r\n2. SIGNAL QUALITY ANALYSIS:\r\n crest factor of Motor Current - Ratio of peak to RMS current\r\n form factor of AC Voltage - Waveform shape quality factor\r\n ripple factor of DC Output - AC component relative to DC\r\n thd of Mains Voltage - Total Harmonic Distortion\r\n\r\n3. POWER SYSTEM ANALYSIS:\r\n efficiency of Output Power vs Input Power - System efficiency\r\n power factor of Mains Voltage vs Line Current - Power factor\r\n\r\n4. VISUALIZATION:\r\n plot Output Voltage - Plot voltage vs time\r\n plot Output Current vs Time - Plot current vs time \r\n plot Efficiency vs Load - Plot efficiency vs load parameter\r\n plot Temperature vs Output Power - Correlation analysis\r\n\r\n5. COMPLEX EXPRESSIONS:\r\n (mean of Vout * max of Iout) / 1000 - Power calculation\r\n (rms of Voltage * rms of Current) - Apparent power\r\n std of Noise / mean of Signal - Signal-to-noise ratio\r\n (max of Temperature - min of Temperature) / 2 - Temperature swing\r\n (ptp of Ripple / mean of DC) * 100 - Ripple percentage\r\n efficiency of Output Power vs Input Power * 100 - Efficiency in %\r\n\r\n6. MULTI-SIGNAL ANALYSIS:\r\n stats - Show all signals statistics\r\n stats Output Voltage - Detailed stats for specific signal\r\n list - Browse all available signals\r\n\r\n7. REAL-WORLD SCENARIOS:\r\n Power Supply Analysis:\r\n mean of Output Voltage\r\n ptp of Output Ripple\r\n efficiency of Output Power vs Input Power\r\n crest factor of Input Current\r\n\r\n Motor Drive Analysis:\r\n max of Motor Current\r\n rms of Phase Voltage\r\n power factor of Input Voltage vs Input Current\r\n plot Motor Speed vs Torque\r\n\r\n Thermal Analysis:\r\n max of Junction Temperature\r\n mean of Heat Sink Temperature \r\n stats Temperature Signals\r\n plot Temperature vs Time\r\n\r\n Power Quality:\r\n thd of Input Voltage\r\n thd of Input Current\r\n power factor of Grid Voltage vs Grid Current\r\n\r\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\ud83d\udca1 TIPS:\r\n\u2022 Use fuzzy matching: 'mean of vout' will match 'Output Voltage'\r\n\u2022 Complex expressions support: +, -, *, /, (), **\r\n\u2022 Units are auto-detected: [V], [A], [W], [\u00b0C], etc.\r\n\u2022 Rich tables for better data visualization\r\n\u2022 Colors for easy result interpretation\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A powerful command-line tool for analyzing and visualizing simulation data from CSV files",
"version": "3.0.0",
"project_urls": {
"Bug Reports": "https://github.com/Gueni/simplation/issues",
"Homepage": "https://github.com/Gueni/simplation",
"Source": "https://github.com/Gueni/simplation"
},
"split_keywords": [
"simulation",
" data-analysis",
" csv",
" engineering",
" visualization",
" statistics"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b3c817199e76cb62040faa9cbc69da20c5f762855a45349aca522c4c520e936a",
"md5": "d01dc8aa24a125e01269b1c371fc3e25",
"sha256": "5547c0f6d7860c9b522842944282d66c1d65cd5cb89c8047394af2c099e97ca8"
},
"downloads": -1,
"filename": "simplation-3.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d01dc8aa24a125e01269b1c371fc3e25",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 13391,
"upload_time": "2025-10-15T13:37:23",
"upload_time_iso_8601": "2025-10-15T13:37:23.421269Z",
"url": "https://files.pythonhosted.org/packages/b3/c8/17199e76cb62040faa9cbc69da20c5f762855a45349aca522c4c520e936a/simplation-3.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2d088d7275255d1eabbdff5b3f29f7ed3f33527cb699bc78f22afe6193ff04cb",
"md5": "ed671fcc75fee04e815113b70c74d4fb",
"sha256": "b4da5914431f855b54e64213511984b5ad1207de9e19a00d5fcfca8bc15d1efd"
},
"downloads": -1,
"filename": "simplation-3.0.0.tar.gz",
"has_sig": false,
"md5_digest": "ed671fcc75fee04e815113b70c74d4fb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 14610,
"upload_time": "2025-10-15T13:37:24",
"upload_time_iso_8601": "2025-10-15T13:37:24.525963Z",
"url": "https://files.pythonhosted.org/packages/2d/08/8d7275255d1eabbdff5b3f29f7ed3f33527cb699bc78f22afe6193ff04cb/simplation-3.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-15 13:37:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Gueni",
"github_project": "simplation",
"github_not_found": true,
"lcname": "simplation"
}
JSON
