Package it.unisa.diem.ai.torcs.model

Interface SensorModel

All Known Implementing Classes:
MessageBasedSensorModel
public interface SensorModel
Interfaccia che definisce il contratto per l’accesso ai dati dei sensori in TORCS. Implementata da classi che forniscono letture sensoriali in tempo reale dal simulatore. I sensori includono informazioni sul veicolo, sul tracciato, sugli avversari e su altri parametri dinamici.

  • Method Details

    • getSpeed

      double getSpeed()
      Returns:
      la velocità longitudinale del veicolo (asse X) in km/h.

    • getAngleToTrackAxis

      double getAngleToTrackAxis()
      Returns:
      l’angolo (in radianti) tra l’asse longitudinale del veicolo e l’asse centrale della pista.

    • getTrackEdgeSensors

      double[] getTrackEdgeSensors()
      Returns:
      un array di 19 valori che rappresentano la distanza dai bordi della pista a varie angolazioni (da -90° a +90°).

    • getFocusSensors

      double[] getFocusSensors()
      Returns:
      un array di 5 valori che rappresentano le letture dei sensori di messa a fuoco direzionale.

    • getTrackPosition

      double getTrackPosition()
      Returns:
      la posizione laterale del veicolo rispetto al centro della pista, in un intervallo [-1, 1].

    • getGear

      int getGear()
      Returns:
      la marcia attualmente inserita (-1 = retromarcia, 0 = folle, 1–6 = marce avanti).

    • getOpponentSensors

      double[] getOpponentSensors()
      Returns:
      un array di 36 valori che indicano la distanza dagli avversari in ogni direzione (risoluzione 10°).

    • getRacePosition

      int getRacePosition()
      Returns:
      la posizione corrente del veicolo nella gara (es. 1 = primo).

    • getLateralSpeed

      double getLateralSpeed()
      Returns:
      la velocità laterale del veicolo (asse Y) in km/h.

    • getCurrentLapTime

      double getCurrentLapTime()
      Returns:
      il tempo corrente del giro in corso, in secondi.

    • getDamage

      double getDamage()
      Returns:
      il livello di danni subiti dal veicolo (valore cumulativo).

    • getDistanceFromStartLine

      double getDistanceFromStartLine()
      Returns:
      la distanza dalla linea di partenza lungo la pista, in metri.

    • getDistanceRaced

      double getDistanceRaced()
      Returns:
      la distanza totale percorsa in gara fino a questo momento, in metri.

    • getFuelLevel

      double getFuelLevel()
      Returns:
      il livello corrente del carburante nel serbatoio, in litri.

    • getLastLapTime

      double getLastLapTime()
      Returns:
      la durata del giro precedente, in secondi.

    • getRPM

      double getRPM()
      Returns:
      i giri al minuto (RPM) attuali del motore.

    • getWheelSpinVelocity

      double[] getWheelSpinVelocity()
      Returns:
      un array con 4 valori che rappresentano la velocità di rotazione di ciascuna ruota.

    • getZSpeed

      double getZSpeed()
      Returns:
      la velocità verticale del veicolo (asse Z), in km/h.

    • getZ

      double getZ()
      Returns:
      la posizione verticale del veicolo (altezza sul piano), in metri.

    • getMessage

      String getMessage()
      Returns:
      il messaggio grezzo completo ricevuto dal simulatore (per debug/logging).