Skip to content

LAUNCH_OPTIMIZATION_USAGE.md

Latest commit

 

History

History
274 lines (218 loc) · 6.8 KB

LAUNCH_OPTIMIZATION_USAGE.md

File metadata and controls

274 lines (218 loc) · 6.8 KB
Raw

🧭 Gaza Launch Point Optimization - Usage Guide

🚀 QUICK START

Method 1: Basic Run (Auto-generates candidates)

python run_optimization.py

Method 2: With Custom Container

python run_optimization.py --container-volume 8.0 --container-mass 4.0 --rope-length 10.0

Method 3: With Your GPS Coordinates

python run_optimization.py --coordinates "31.1234,34.0567;31.1456,34.0789;31.1678,34.0912"

Method 4: With Coordinates File

python run_optimization.py --coordinates-file sample_coordinates.txt

📍 USING YOUR GPS COORDINATES

Command Line Format:

--coordinates "lat1,lon1;lat2,lon2;lat3,lon3"

Example:

python run_optimization.py \
  --coordinates "31.1234,34.0567;31.1456,34.0789;31.1678,34.0912" \
  --target-success 0.8

File Format:

Create a text file with one coordinate per line:

# comments start with #
31.1234, 34.0567
31.1456, 34.0789  
31.1678, 34.0912

Example:

python run_optimization.py --coordinates-file my_coordinates.txt

⚙️ ALL AVAILABLE OPTIONS

python run_optimization.py \
  --target-lat 31.2794 \              # Target latitude (Gaza Beach)
  --target-lon 34.2542 \              # Target longitude (Gaza Beach)
  --container-volume 5.0 \            # Container volume in liters
  --container-mass 2.5 \              # Container mass in kg
  --container-density 500 \           # Container density in kg/m³
  --rope-length 5.0 \                 # Rope length in meters
  --season summer \                   # summer/autumn/winter/spring
  --launch-time dawn \                # dawn/day/dusk/night
  --target-success 0.8 \              # Target success rate (80%)
  --wind-factor 1.0 \                 # Wind strength multiplier
  --current-factor 1.0 \              # Current strength multiplier
  --coordinates-file coordinates.txt   # Your GPS coordinates file

🎯 TARGETING HIGH SUCCESS RATES

The system will automatically search until it finds 80%+ success rates (or your specified target).

Adjusting Target Success Rate:

# Search for 90% success rate
python run_optimization.py --target-success 0.9

# Search for 70% success rate (easier)
python run_optimization.py --target-success 0.7

What Happens:

  1. Analyzes your coordinates (or generates candidates if none provided)
  2. Calculates success probability for each using real physics
  3. Expands search area if target success rate not found
  4. Shows best options with detailed analysis

🔧 OPTIMIZING FOR BETTER RESULTS

Increase Container Stability:

# Heavier container (more stable)
python run_optimization.py --container-mass 4.0

# Better density (closer to water)
python run_optimization.py --container-density 700

# Larger volume (more buoyancy)
python run_optimization.py --container-volume 8.0

Improve Rope System:

# Longer rope (more stability)
python run_optimization.py --rope-length 10.0

# Combined improvements
python run_optimization.py \
  --container-mass 4.0 \
  --container-volume 8.0 \
  --rope-length 10.0

Optimal Environmental Conditions:

# Summer + Dawn = Best conditions
python run_optimization.py --season summer --launch-time dawn

# Reduce wind/current effects
python run_optimization.py --wind-factor 0.8 --current-factor 0.8

📋 EXAMPLE COORDINATE FILES

Egyptian Coast Points:

# egyptian_coast.txt
31.1234, 34.0567
31.1456, 34.0789
31.1678, 34.0912
31.1890, 34.1123

Cyprus Launch Points:

# cyprus_points.txt
31.0987, 33.9876
31.0765, 33.9654
31.0543, 33.9432

Mixed Strategy Points:

# mixed_strategy.txt
# Close points (conservative)
31.2123, 34.1234
31.2345, 34.1456

# Medium distance (optimal)  
31.1678, 34.0912
31.1890, 34.1123

# Far points (extended)
31.0987, 33.9876
31.0765, 33.9654

📊 UNDERSTANDING THE OUTPUT

Success Probability Meaning:

  • 80%+: Excellent chance of success
  • 60-80%: Good chance with some risk
  • 40-60%: Moderate chance, consider improvements
  • <40%: High risk, needs better configuration

Strategy Options Explained:

  • 🟢 Conservative: Closer launch, higher success rate, lower risk
  • 🔵 Optimal: Physics-balanced point, best overall score
  • 🟡 Extended: Longer distance, weather buffer, more robust

What to Look For:

  1. Success Probability: Primary metric for mission success
  2. Distance: Operational considerations (fuel, time, detection risk)
  3. Advantages: Positive factors working in your favor
  4. Risk Factors: Potential problems to mitigate
  5. Recommendations: Suggested improvements

🚀 EXAMPLE USAGE SCENARIOS

Scenario 1: Test Specific Coordinates

python run_optimization.py \
  --coordinates "31.1234,34.0567;31.1456,34.0789" \
  --target-success 0.8

Scenario 2: Optimize Heavy Cargo

python run_optimization.py \
  --container-volume 10.0 \
  --container-mass 6.0 \
  --rope-length 15.0 \
  --target-success 0.75

Scenario 3: Winter Operations

python run_optimization.py \
  --season winter \
  --launch-time night \
  --wind-factor 1.3 \
  --current-factor 1.2 \
  --coordinates-file winter_coordinates.txt

Scenario 4: Maximum Precision

python run_optimization.py \
  --container-density 600 \
  --rope-length 8.0 \
  --target-success 0.9 \
  --season summer \
  --launch-time dawn

🔍 TROUBLESHOOTING

Problem: All Success Rates Are 0%

Solutions:

  1. Increase container mass: --container-mass 4.0
  2. Use longer rope: --rope-length 10.0
  3. Try different coordinates closer to target
  4. Lower target success: --target-success 0.6

Problem: Success Rates Too Low

Solutions:

  1. Improve container design: 
    --container-volume 8.0 --container-mass 4.0 --container-density 700
  2. Optimize conditions: 
    --season summer --launch-time dawn
  3. Try different launch points

Problem: Coordinates File Error

Check:

  • File format: latitude, longitude (one per line)
  • No extra spaces or characters
  • Comments start with #
  • File exists and is readable

🎯 QUICK TIPS FOR SUCCESS

  1. Start with provided sample: --coordinates-file sample_coordinates.txt
  2. Use summer dawn: --season summer --launch-time dawn
  3. Heavier containers work better: --container-mass 4.0
  4. Longer ropes add stability: --rope-length 10.0
  5. Target 70-80% success: --target-success 0.75
  6. Check multiple coordinate sets to find the best options
  7. Use visualization output to understand the physics

🌊 The system will keep searching until it finds launch points that meet your success criteria!