RayNmeaSimulatorUSER GUIDE · v0.1.1
Simulation
On this page

Weather and Environmental Simulation

Generate Weather can use manually entered values or configured weather providers. Atmospheric, marine and descriptive observations are not interchangeable, and not every provider/station supplies every field.

Start with manual weather

  1. Add Generate Weather and compatible environmental instruments.
  2. Review source Enable and Dispatch. Leave external Sending stopped while checking bindings.
  3. Enter valid air/water temperature, humidity, pressure and wind values using the displayed units.
  4. Inspect instrument/canonical values and environmental-source status. Check which fields the provider supplies and which remain Unavailable.

Fetch provider data deliberately

  1. Review the target latitude/longitude. When Vessel Movement is connected, these can change during a run.
  2. Choose the API source. For OpenWeatherMap, configure the appropriate API key through Setup's secure storage workflow; do not paste keys into Layouts or screenshots.
  3. For National Data Buoy Center, inspect station selection/availability information. Different stations provide different atmospheric/marine subsets.
  4. Click Fetch Weather once and read the visible status. Review observation time/source rather than assuming all tabs were freshly populated.
  5. Use automatic refresh only after manual retrieval is understood, with a sensible interval and bounded provider use.

Ordinary simulated motion is allowed during retrieval. The application associates a cycle with request coordinates and applies locality/freshness safeguards; a large relocation or superseded request can legitimately invalidate a delayed result. Do not retry on every coordinate change. Current cycle locality is bounded, including a 5 km movement limit from its request snapshot; this is an application validity policy, not a provider accuracy guarantee.

Inspect the tabs and freshness

Atmosphere, Marine, More, Description and Refresh show the available conditions and scheduling controls. Check observation time, source and stale-data indications. Values restored from a Layout may be older than the current location or conditions.

When Setup enables environmental influence, valid Weather conditions contribute simulated wind drift and wave attitude. Water-current and wind-induced-yaw effects are not available. Without valid applicable conditions, those environmental effects are not applied.

Recover from provider failures

  • Check provider choice, coordinates, key availability and network/service errors before changing movement physics.
  • For missing fields, inspect station/provider coverage and observation age; choose another legitimate source rather than filling gaps with arbitrary numbers.
  • After a large position change, let the old request finish/cancel according to status, then perform a deliberate fresh retrieval.
  • Respect rate limits. Repeated retries, overlapping requests or deleting the key store are not normal recovery steps.

Fetching weather updates the Weather source. It does not enable external instrument Sending.

Illustrated controls

Reading guide: Read top to bottom: API Source, request coordinates, Fetch Weather, then parameter tabs. The Refresh tab controls scheduling; Dispatch controls delivery and does not authorize network transmission.

Review or enter atmospheric temperature, humidity, pressure and wind values.
Figure 49. Review or enter atmospheric temperature, humidity, pressure and wind values. Click to enlarge.

Marine values and waves are distinct from atmospheric observations.
Figure 50. Marine values and waves are distinct from atmospheric observations. Click to enlarge.

Additional provider fields may be unavailable; the simulator does not invent missing observations.
Figure 51. Additional provider fields may be unavailable; the simulator does not invent missing observations. Click to enlarge.

Provider descriptions and observation context must be reviewed before using data.
Figure 52. Provider descriptions and observation context must be reviewed before using data. Click to enlarge.

Automatic refresh is explicitly configured; fetching weather does not enable Sending.
Figure 53. Automatic refresh is explicitly configured; fetching weather does not enable Sending. Click to enlarge.

Choose Open Weather Map as the weather provider; configure its API key in Setup.
Figure 54. Choose Open Weather Map as the weather provider; configure its API key in Setup. Click to enlarge.

Choose National Data Buoy Center and review the selected station and available measurements.
Figure 55. Choose National Data Buoy Center and review the selected station and available measurements. Click to enlarge.

Generating NMEA Data · Enable, Dispatch and Sending · Manual Vessel Movement · Autopilot and Route Following · Game Controller Mode · Engine and Transmission Simulation · AIS Simulation · Windlass Simulation · Connection Troubleshooting · Route Overview · Engineering Units

Help Home · Back to top

Image