Metadata-Version: 2.4
Name: phytrade
Version: 1.2.6
Summary: Institutional trade physics library for global commodity arbitration (50 Domains).
Author-email: Kazi Saad Asif <kazisaadasif29@gmail.com>
License: Proprietary
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Intended Audience :: Manufacturing
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24.0
Dynamic: license-file

# phytrade (v1.2.6)

**Institutional Physics Library for Global Commodity Arbitration**

`phytrade` is a high-precision computational physics framework designed to resolve mass, quality, and environmental disputes in international trade. By implementing industry-standard thermodynamics, fluid dynamics, and mechanical stress models, it provides an objective "Arbitrator" for maritime and land-based commerce.

---

## 🏛️ Project Architecture: The 50-Problem Roadmap

Version **1.2.6** marks the transition from a specialized thermal tool to a comprehensive physics engine. All five core domains are now **Active**, populating the library with the first 50 essential problem-solvers for global trade.

| Category | Domain | Status | Scope |
| :--- | :--- | :--- | :--- |
| **I** | **Thermodynamics** | ✅ **Active** | Problems 1-10 (Moisture, Heat, PCM) |
| **II** | **Fluid Dynamics** | ✅ **Active** | Problems 11-20 (Drag, Cavitation, Siltation) |
| **III** | **Mechanical** | ✅ **Active** | Problems 21-30 (Stress, Torque, Wind Tech) |
| **IV** | **Logistics** | ✅ **Active** | Problems 31-40 (Platooning, Docking, Routing) |
| **V** | **Strategic** | ✅ **Active** | Problems 41-50 (ROI, Risk, Game Theory) |

---

## 🚀 Key Features (v1.2.6 Expansion)

The library now supports multi-domain arbitration across the following engines:

* **Thermo (Category I):** Mass Deconvolution (ASABE D245.7), Container Rain Prediction, and Perishable Respiration models.
* **Fluids (Category II):** **Hull Skin Friction** analysis for bio-fouling, **Propeller Cavitation** erosion risk, and **Port Siltation** depth impact on cargo capacity.
* **Mechanical (Category III):** **Wind-Assisted Propulsion** (Sails/Rotors) force calculation, **Shaft Torque** monitoring, and **Hull Stress** analysis.
* **Logistics (Category IV):** **Aerodynamic Drafting** (Truck/Ship Platooning) fuel savings and optimized **Dry-Docking** scheduling.
* **Strategic (Category V):** **Economical Speed** optimization, **Strategic Reserve** utilization, and **Market Volatility** hedging.

---

## 📦 Installation 

```bash
pip install phytrade

🛠️ Usage  
To integrate the arbitration engine into your workflow, initialize the specific domain arbitrator:

from phytrade import ThermoArbitrator, FluidsArbitrator, MechanicalArbitrator

# 1. Initialize the Engines
thermo = ThermoArbitrator()
fluids = FluidsArbitrator()
mech = MechanicalArbitrator()

# 2. Solve a Hull Friction Dispute (Problem 11)
# Estimate drag increase from bio-fouling (15% fouling index) at 12 knots
drag_increase = fluids.estimate_hull_skin_friction(
    velocity=6.17,  # 12 knots in m/s
    wetted_area=3500, 
    bio_fouling_index=0.15
)

# 3. Calculate Wind Propulsion Offset (Problem 19)
wind_force = mech.calculate_wind_propulsion(
    wind_speed=15.0, 
    sail_area=200, 
    angle=45
)

print(f"Added Drag Force: {drag_increase} N")
print(f"Wind Assist Force: {wind_force} N")

📝 Standards Compliance
phytrade adheres to international scientific and engineering standards, including:

ASABE D245.7: Moisture relationships for agricultural products.

ASTM D2495: Standard test method for moisture in cotton.

ITTC Recommended Procedures: For Hull Resistance and Propeller Cavitation.

ISO 19011: Guidelines for auditing management systems.

📄 License & Citation
License:Proprietary. All rights reserved.

If you use this library in commercial arbitration or academic research, please cite it using the included CITATION.cff file:

Plaintext:

Asif, K. S. (2026). phytrade: Institutional Physics Library for Global Commodity Arbitration (v1.2.6).

Author: Kazi Saad Asif

Contact: kazisaadasif29@gmail.com

GitHub: ksaad20/phytrade
