Pressure Drop Calculator (افت فشار در لوله‌ها)

English Section 🇬🇧

📌 Overview

This project is a Pressure Drop Calculator for single-phase fluid flow in pipelines, implemented in MATLAB (App Designer).
Version 1.0 focuses on providing a user-friendly GUI and accurate hydraulic calculations for engineers and students.

🚀 Features (v1.0)

• GUI Interface using MATLAB App Designer
• Pressure drop calculation using:
  • Darcy–Weisbach equation
  • Friction factor (Colebrook–White, Swamee–Jain, Moody correlations)
• Fluid properties (density, viscosity) for water and basic fluids
• Pipe geometry definition (diameter, length, roughness)
• Reynolds number and velocity calculation
• Output results in table format
• Graphical visualization:
  • Pressure drop profile along the pipeline
  • Moody chart (optional)
• Export results to Excel/PDF
• Pre-defined test cases for validation

📂 Project Structure

📦 PressureDropProject │ ├── PressureDropApp.mlapp # Main GUI file │ ├── src/ # Core calculation functions │ ├── FluidProperties.m │ ├── ReynoldsNumber.m │ ├── FrictionFactor.m │ ├── PressureDrop.m │ ├── Velocity.m │ └── HeadLoss.m │ ├── utils/ # Helper functions │ ├── UnitConverter.m │ ├── PlotMoodyChart.m │ └── ExportResults.m │ ├── data/ # Databases and reference data │ ├── fluids.xlsx │ ├── pipeRoughness.xlsx │ └── testCases.xlsx │ ├── docs/ # Documentation │ ├── UserManual.pdf │ └── ValidationReport.pdf │ └── results/ # Saved outputs ├── case1.xlsx ├── case1_plot.png └── ...

📖 Usage

1. Open PressureDropApp.mlapp in MATLAB (R2020b or later).
2. Enter pipe and fluid data in the GUI.
3. Click Calculate to view results.
4. Export results as Excel/PDF if needed.

---

بخش فارسی 🇮🇷

📌 معرفی

این پروژه یک نرم‌افزار محاسبه افت فشار در لوله‌ها برای جریان سیال تک‌فاز است که در محیط MATLAB (App Designer) طراحی شده است.
نسخه ۱.۰ بر روی ایجاد یک رابط کاربری ساده و کاربرپسند و انجام محاسبات دقیق هیدرولیکی تمرکز دارد.

🚀 ویژگی‌ها (نسخه ۱.۰)

• رابط کاربری گرافیکی (GUI) با App Designer
• محاسبه افت فشار با:
  • معادله دارسی–ویس‌باخ (Darcy–Weisbach)
  • ضریب اصطکاک با روابط Colebrook–White، Swamee–Jain و نمودار Moody
• محاسبه خواص سیال (چگالی، ویسکوزیته) برای آب و چند سیال پایه
• تعریف مشخصات هندسی لوله (قطر، طول، زبری سطح)
• محاسبه عدد رینولدز و سرعت جریان
• نمایش نتایج به صورت جدول
• ترسیم نمودار:
  • پروفایل افت فشار در طول لوله
  • نمودار Moody (اختیاری)
• خروجی گرفتن از نتایج به صورت Excel و PDF
• شامل مثال‌های مرجع برای تست و اعتبارسنجی

📂 ساختار پروژه

📦 PressureDropProject │ ├── PressureDropApp.mlapp # فایل اصلی رابط کاربری │ ├── src/ # توابع محاسباتی اصلی │ ├── FluidProperties.m │ ├── ReynoldsNumber.m │ ├── FrictionFactor.m │ ├── PressureDrop.m │ ├── Velocity.m │ └── HeadLoss.m │ ├── utils/ # توابع کمکی │ ├── UnitConverter.m │ ├── PlotMoodyChart.m │ └── ExportResults.m │ ├── data/ # داده‌های مرجع و دیتابیس │ ├── fluids.xlsx │ ├── pipeRoughness.xlsx │ └── testCases.xlsx │ ├── docs/ # مستندات │ ├── UserManual.pdf │ └── ValidationReport.pdf │ └── results/ # خروجی‌ها ├── case1.xlsx ├── case1_plot.png └── ...

📖 نحوه استفاده

1. فایل PressureDropApp.mlapp را در MATLAB (ورژن R2020b به بعد) باز کنید.
2. مشخصات لوله و سیال را در رابط کاربری وارد کنید.
3. روی دکمه Calculate کلیک کنید تا نتایج نمایش داده شوند.
4. در صورت نیاز خروجی‌ها را به صورت Excel یا PDF ذخیره کنید.

---

✍️ Developed by: Amin (امین)
📅 Version: 1.0
📌 Language: MATLAB (App Designer)#