Scanning Tools - Incomplete-Infinity/eve-companion GitHub Wiki

🔍 Scanning Tools

This page outlines the scanning coordination features of the EVE Companion App. These tools help scouts and explorers visualize system layouts, share D-Scan results, and estimate the positions of enemy ships using range and angle data.

🎯 Goals

  • Reconstruct local system layout with celestials and bookmarks
  • Allow users to mark estimated locations of ships
  • Filter D-Scan results and cross-reference with allies
  • Provide spatial tools to simulate triangulation or range overlays

🧩 Module Features

Feature Description
System Map Viewer Render planets, stations, moons, etc. relative to the player
Position Marker Click-based tool for marking object locations
D-Scan Overlay Paste or parse directional scan data
Friendly Filter Hide known allies using corp/alliance filters
Warp-in Calculation Estimate ideal warp angles or approach distances

🗺 System Layout Engine

The system map is reconstructed using:

  • Celestial positions (from /universe/systems/{id}/)
  • Bookmarks (if available)
  • Approximate scale (based on distance between celestials)

Positions are plotted in 2D using D3.js or SVG.

🔬 D-Scan Parsing

Users can paste raw D-Scan results into the tool. The app will:

  • Parse name, type, distance, angle (if available)
  • Cross-reference with known InventoryTypes
  • Apply filters for allies, ships, structures

Example input:

Slasher | Frigate | 2,356 km | 15°
Gnosis  | Battlecruiser | 47,032 km | 180°

🧠 Inferred Ship Positioning (Planned)

With multiple scans at different angles/distances, the app will attempt to:

  • Estimate 2D position via triangulation
  • Display likely ship location and uncertainty area

Future support may include:

  • Timed sweep logs
  • Directional cone visualization

🧱 Interface Pattern

<window-frame data-title="System Scanner">
  <system-map></system-map>
  <dscan-input></dscan-input>
  <filtered-results></filtered-results>
</window-frame>

Results and overlays update reactively with user input.

📡 Planned Enhancements

  • Export parsed D-Scan data to fleet chat or logs
  • Live sync with other scouts in system
  • Hostile heatmap overlay (based on report frequency)
  • Sound alert for notable ship types or proximity

📌 Summary

  • Scanning tools help scouts visualize and triangulate threats
  • Accepts raw D-Scan input and highlights friendly vs unknown
  • System layout is generated from ESI and enhanced manually
  • Designed to speed up recon and improve FC awareness
⚠️ **GitHub.com Fallback** ⚠️