vortex-by-gitdeeper 0.1.0__tar.gz

vortex_by_gitdeeper-0.1.0/AUTHORS.md

@@ -0,0 +1,44 @@
+# Authors
+
+## Principal Researcher & Developer
+
+### Samir Baladi
+- **Role**: Interdisciplinary AI Researcher, Scientific Software Developer
+- **Email**: gitdeeper@gmail.com
+- **ORCID**: 0009-0003-8903-0029  
+- **Phone**: +1-614-264-2074
+- **GitLab**: https://gitlab.com/gitdeeper3
+- **Research Interests**: Applied AI/ML in geosciences, computational meteorology, scientific software development
+
+## Current Projects
+
+### Vortex Framework
+- **Primary Repository**: https://gitlab.com/gitdeeper3/vortex
+- **Mirror Repositories**:
+  - **Codeberg**: https://codeberg.org/gitdeeper2/vortex/
+  - **Bitbucket**: https://bitbucket.org/gitdeeper3/vortex/
+  - **GitHub**: https://github.com/gitdeeper3/vortex/
+- **Description**: Multi-parameter assessment protocol for tropical cyclone rapid intensification forecasting
+- **Status**: Active development
+
+## Contact for Collaboration
+
+For research collaboration or technical discussions:
+- **Email**: gitdeeper@gmail.com
+- **GitLab**: @gitdeeper
+
+## Open Source Commitment
+
+All projects follow open science principles:
+- Source code publicly available under MIT License
+- Research methodologies transparently documented
+- Peer review and community feedback welcome
+
+## How to Contribute
+
+1. Fork any of the repositories above
+2. Create a feature branch
+3. Make your improvements
+4. Submit a merge request
+
+See individual project CONTRIBUTING.md files for specific guidelines.

vortex_by_gitdeeper-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gitdeeper3
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vortex_by_gitdeeper-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: vortex-by-gitdeeper
+Version: 0.1.0
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: numpy>=1.20.0
+Dynamic: license-file
+Dynamic: requires-dist

vortex_by_gitdeeper-0.1.0/README.md

@@ -0,0 +1,204 @@
+# Vortex Framework
+## Multi-Parameter Assessment Protocol for Tropical Cyclone Rapid Intensification
+
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Status](https://img.shields.io/badge/status-active--development-orange)
+
+## 📍 Repository Locations
+
+This project is mirrored across multiple platforms:
+
+- **Primary Repository**: https://gitlab.com/gitdeeper3/vortex
+- **Mirrors**:
+  - **Codeberg**: https://codeberg.org/gitdeeper2/vortex/
+  - **Bitbucket**: https://bitbucket.org/gitdeeper3/vortex/
+  - **PyPI**: https://pypi.org/project/vortex/
+
+## Overview
+
+The **Vortex Multi-Parameter Assessment Protocol** is an operational research framework for predicting Rapid Intensification (RI) in tropical cyclones.
+
+## Core Parameters (8-Parameter Framework)
+
+| # | Parameter | Symbol | Description |
+|---|-----------|--------|-------------|
+| 1 | Ocean Heat Content | OHC | Thermal energy in upper ocean |
+| 2 | Eyewall Symmetry | σ_sym | Structural organization index |
+| 3 | Vertical Wind Shear | VWS | 850-200 hPa wind difference |
+| 4 | Mid-Level Humidity | RH_mid | 700-500 hPa relative humidity |
+| 5 | Low-Level Vorticity | ζ_850 | 850 hPa relative vorticity |
+| 6 | Convective Organization | Org_conv | Inner-core convection coherence |
+| 7 | Outflow Efficiency | Eff_outflow | Upper-level ventilation |
+| 8 | Intensity Trend | ΔInt_trend | 6-12h intensity changes |
+
+## Quick Start
+
+```bash
+# Clone from any repository
+git clone https://gitlab.com/gitdeeper3/vortex.git
+cd vortex
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Install in development mode
+pip install -e .
+```
+
+Project Structure
+
+```
+vortex/
+├── src/                    # Source code
+├── data/                   # Data directory
+├── config/                 # Configuration files
+├── tests/                  # Test suite
+├── reports/                # Report system
+├── examples/               # Usage examples
+└── docs/                   # Documentation
+```
+
+Installation
+
+Basic Installation
+
+```bash
+pip install -r requirements.txt
+pip install -e .
+```
+
+From PyPI
+
+```bash
+# Install from PyPI
+pip install vortex
+
+# Install specific version
+pip install vortex==1.0.0
+```
+
+Usage
+
+```python
+from vortex.core.vortex_engine import VortexEngine
+from vortex.algorithms.time_stepping import EnhancedTimeSteppingForecast
+
+# Initialize engine for Atlantic basin
+engine = VortexEngine(basin="atlantic")
+
+# Initialize forecaster
+forecaster = EnhancedTimeSteppingForecast()
+
+# Generate forecast
+forecast = forecaster.forecast_intensity(
+    initial_intensity_kt=75.0,
+    mpi_trajectory=[80.0, 85.0, 90.0, 95.0],
+    environmental_trends={
+        "vws": [12.0, 10.0, 8.0, 6.0],
+        "sst": [28.5, 28.8, 29.0, 29.2]
+    },
+    time_horizon_hours=24
+)
+
+print(f"RI Probability: {forecast['ri_probability_time_series'][-1]:.1%}")
+```
+
+Documentation
+
+Full documentation is available in the docs/ directory:
+
+· API Reference
+· Scientific Methodology
+· Validation Results
+· Installation Guides
+
+Contributing
+
+Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting contributions.
+
+License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+Citation and Distribution
+
+📚 Academic Citation (Zenodo)
+
+For academic publications, please cite using the Zenodo DOI:
+
+```bibtex
+@software{vortex_framework_2026,
+  author = {Baladi, Samir},
+  title = {Vortex Multi-Parameter Assessment Protocol for Tropical Cyclone Rapid Intensification},
+  year = {2026},
+  publisher = {Zenodo},
+  doi = {10.5281/zenodo.xxxxxxx},
+  url = {https://doi.org/10.5281/zenodo.xxxxxxx},
+  version = {1.0.0}
+}
+```
+
+Zenodo Archive: https://zenodo.org/records/xxxxxxx
+
+📦 Package Distribution (PyPI)
+
+The Vortex package is available on PyPI:
+
+```bash
+# Install from PyPI
+pip install vortex
+```
+
+PyPI Package: https://pypi.org/project/vortex/
+
+Current Version: 1.0.0
+
+PyPI Citation:
+
+```bibtex
+@software{vortex_pypi_2026,
+  author = {Baladi, Samir},
+  title = {vortex: Python package for tropical cyclone RI forecasting},
+  year = {2026},
+  publisher = {PyPI},
+  url = {https://pypi.org/project/vortex/},
+  version = {1.0.0}
+}
+```
+
+🔗 Repository Citations
+
+For referencing specific repository versions:
+
+GitLab:
+
+```bibtex
+@software{vortex_gitlab_2026,
+  author = {Baladi, Samir},
+  title = {Vortex Framework - GitLab Repository},
+  year = {2026},
+  publisher = {GitLab},
+  url = {https://gitlab.com/gitdeeper3/vortex},
+  note = {Version 1.0.0, commit: [specific commit hash]}
+}
+```
+
+Contact
+
+Samir Baladi
+
+· Role: Interdisciplinary AI Researcher, Scientific Software Developer
+· Email: gitdeeper@gmail.com
+· ORCID: 0009-0003-8903-0029
+· Phone: +1-614-264-2074
+· GitLab: @gitdeeper
+· Research Interests: Applied AI/ML in geosciences, computational meteorology, scientific software development
+
+Project Links
+
+· GitLab (Primary): https://gitlab.com/gitdeeper3/vortex
+· Codeberg: https://codeberg.org/gitdeeper2/vortex/
+· Bitbucket: https://bitbucket.org/gitdeeper3/vortex/
+· PyPI: https://pypi.org/project/vortex/
+· Zenodo: https://zenodo.org/records/xxxxxxx

vortex_by_gitdeeper-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

vortex_by_gitdeeper-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vortex_by_gitdeeper-0.1.0/setup.py

@@ -0,0 +1,17 @@
+from setuptools import setup
+
+setup(
+    name="vortex-by-gitdeeper",
+    version="0.1.0",
+    packages=[
+        'src',
+        'src.algorithms', 
+        'src.core',
+        'src.io',
+        'src.parameters',
+        'src.utils',
+        'src.visualization'
+    ],
+    package_dir={'': '.'},  # المفتاح هنا!
+    install_requires=["numpy>=1.20.0"],
+)

vortex_by_gitdeeper-0.1.0/src/__init__.py

@@ -0,0 +1,13 @@
+"""
+Vortex Simulation Package
+Computational fluid dynamics and vortex modeling
+"""
+
+__version__ = "0.1.0"
+__author__ = "gitdeeper3"
+
+# استيرادات اختيارية - يمكن حذفها إذا كانت تسبب مشاكل
+# from src.core.vortex_engine import VortexEngine
+# from src.algorithms.time_stepping import TimeStepper
+
+# __all__ = ['VortexEngine', 'TimeStepper']

vortex_by_gitdeeper-0.1.0/src/algorithms/__init__.py

@@ -0,0 +1,20 @@
+"""
+Algorithm modules for the Vortex framework.
+
+Contains forecasting algorithms and computational methods for
+tropical cyclone intensity prediction and RI probability calculation.
+"""
+
+from .time_stepping import EnhancedTimeSteppingForecast, TimeStepper
+from .probability import RIProbabilityCalculator
+from .integration import ParameterIntegration
+
+__all__ = [
+    'EnhancedTimeSteppingForecast',
+    'TimeStepper',
+    'RIProbabilityCalculator', 
+    'ParameterIntegration',
+]
+
+__version__ = "1.0.0"
+__description__ = "Forecasting algorithms for Vortex framework"

vortex_by_gitdeeper-0.1.0/src/algorithms/integration.py

@@ -0,0 +1,204 @@
+"""
+Parameter Integration Algorithm
+Implements the Vortex RI Index from equation 2.3
+"""
+import numpy as np
+from typing import Dict, List, Optional
+import yaml
+import logging
+
+logger = logging.getLogger(__name__)
+
+class ParameterIntegration:
+    """
+    Integrate 8 parameters into Vortex RI Index
+    
+    Vortex Index = Σ(α_i * P_i)
+    where α_i are basin-dependent weights
+    P_i are normalized parameters (0-1 scale)
+    """
+    
+    def __init__(self, basin: str = "atlantic"):
+        """
+        Initialize integration for specific basin
+        
+        Parameters:
+        -----------
+        basin : str
+            Tropical cyclone basin
+        """
+        self.basin = basin
+        self.weights = self._load_basin_weights(basin)
+        
+    def _load_basin_weights(self, basin: str) -> Dict:
+        """Load basin-specific weights from config"""
+        config_path = f"config/basins/{basin}.yaml"
+        try:
+            with open(config_path, 'r') as f:
+                config = yaml.safe_load(f)
+            return config.get('weights', {}).get('initial_phase', {})
+        except FileNotFoundError:
+            logger.warning(f"Config for {basin} not found, using defaults")
+            return self._get_default_weights()
+    
+    def _get_default_weights(self) -> Dict:
+        """Default weights if config not available"""
+        return {
+            'ohc': 0.15,
+            'sigma_sym': 0.10,
+            'vws': 0.20,
+            'rh_mid': 0.15,
+            'vorticity': 0.10,
+            'outflow': 0.10,
+            'conv_org': 0.10,
+            'int_trend': 0.10
+        }
+    
+    def integrate(self, parameters: Dict[str, float], 
+                  storm_stage: str = "initial_phase") -> Dict[str, float]:
+        """
+        Integrate normalized parameters into indices
+        
+        Parameters:
+        -----------
+        parameters : dict
+            Dictionary of normalized parameters (0-1 scale)
+        storm_stage : str
+            Storm stage: 'initial_phase', 'intensifying_phase', 'mature_phase'
+            
+        Returns:
+        --------
+        dict: Integrated indices
+        """
+        try:
+            # Load appropriate weights for storm stage
+            weights = self._get_weights_for_stage(storm_stage)
+            
+            # Calculate individual indices
+            thermodynamic_idx = self._calculate_thermodynamic_index(
+                parameters.get('ohc_normalized', 0),
+                parameters.get('sst_normalized', 0)
+            )
+            
+            structural_idx = self._calculate_structural_index(
+                parameters.get('sigma_sym', 0),
+                parameters.get('convective_org_score', 0)
+            )
+            
+            environmental_idx = self._calculate_environmental_index(
+                parameters.get('vws_normalized', 0),
+                parameters.get('rh_mid_normalized', 0)
+            )
+            
+            # Calculate combined Vortex Index (equation 2.3)
+            vortex_index = 0.0
+            total_weight = 0.0
+            
+            # Parameter mapping
+            param_mapping = {
+                'ohc': 'ohc_normalized',
+                'sigma_sym': 'sigma_sym',
+                'vws': 'vws_normalized',
+                'rh_mid': 'rh_mid_normalized',
+                'vorticity': 'vorticity_normalized',
+                'outflow': 'outflow_efficiency',
+                'conv_org': 'convective_org_score',
+                'int_trend': 'intensity_trend'
+            }
+            
+            for param_name, weight in weights.items():
+                param_key = param_mapping.get(param_name)
+                if param_key and param_key in parameters:
+                    param_value = parameters[param_key]
+                    # Apply inverse transformation for VWS (equation 2.3: VWS⁻¹)
+                    if param_name == 'vws' and param_value > 0:
+                        param_value = 1.0 / param_value if param_value > 0.1 else 1.0
+                    
+                    vortex_index += weight * param_value
+                    total_weight += weight
+            
+            if total_weight > 0:
+                vortex_index /= total_weight
+            
+            # Apply sigmoid transformation for some parameters
+            vortex_index = self._sigmoid_transform(vortex_index)
+            
+            logger.info(f"Vortex Index calculated: {vortex_index:.3f}")
+            
+            return {
+                'thermodynamic_index': thermodynamic_idx,
+                'structural_index': structural_idx,
+                'environmental_index': environmental_idx,
+                'combined_index': vortex_index,
+                'weights_used': weights,
+                'storm_stage': storm_stage
+            }
+            
+        except Exception as e:
+            logger.error(f"Error in parameter integration: {e}")
+            return {
+                'thermodynamic_index': 0.0,
+                'structural_index': 0.0,
+                'environmental_index': 0.0,
+                'combined_index': 0.0
+            }
+    
+    def _get_weights_for_stage(self, storm_stage: str) -> Dict:
+        """Get weights for specific storm stage"""
+        try:
+            config_path = f"config/basins/{self.basin}.yaml"
+            with open(config_path, 'r') as f:
+                config = yaml.safe_load(f)
+            return config.get('weights', {}).get(storm_stage, self._get_default_weights())
+        except:
+            return self._get_default_weights()
+    
+    def _calculate_thermodynamic_index(self, ohc_norm: float, sst_norm: float) -> float:
+        """Calculate thermodynamic potential index"""
+        return 0.6 * ohc_norm + 0.4 * sst_norm
+    
+    def _calculate_structural_index(self, sigma_sym: float, conv_org: float) -> float:
+        """Calculate structural organization index"""
+        return 0.7 * sigma_sym + 0.3 * conv_org
+    
+    def _calculate_environmental_index(self, vws_norm: float, rh_mid_norm: float) -> float:
+        """Calculate environmental favorability index"""
+        # VWS is inverse relationship (lower is better)
+        vws_component = 1.0 - vws_norm
+        return 0.6 * vws_component + 0.4 * rh_mid_norm
+    
+    def _sigmoid_transform(self, x: float) -> float:
+        """Apply sigmoid transformation to limit range"""
+        return 1.0 / (1.0 + np.exp(-10.0 * (x - 0.5)))
+    
+    def _normalize_vws(self, vws_value: float) -> float:
+        """Normalize vertical wind shear (0-1, where 0 is most favorable)"""
+        # From paper: <5 m/s highly favorable, >15 m/s inhibitor
+        if vws_value < 5.0:
+            return 0.1  # Very favorable
+        elif vws_value < 10.0:
+            return 0.3  # Moderately favorable
+        elif vws_value < 15.0:
+            return 0.7  # Unfavorable
+        else:
+            return 1.0  # RI inhibitor
+
+# Test function
+if __name__ == "__main__":
+    integrator = ParameterIntegration("atlantic")
+    
+    # Example parameters (normalized 0-1)
+    example_params = {
+        'ohc_normalized': 0.8,
+        'sst_normalized': 0.9,
+        'sigma_sym': 0.7,
+        'vws_normalized': 0.2,
+        'rh_mid_normalized': 0.6,
+        'vorticity_normalized': 0.5,
+        'outflow_efficiency': 0.4,
+        'convective_org_score': 0.6,
+        'intensity_trend': 0.3
+    }
+    
+    results = integrator.integrate(example_params, "intensifying_phase")
+    print("Integration Results:", results)

vortex_by_gitdeeper-0.1.0/src/algorithms/normalization.py

@@ -0,0 +1 @@
+# Placeholder for future implementation