Selafapi

Les résultats de simulation mises à disposition au travers du service Selafapi sont issues de sessions successives de simulations. Chaque session de simulation se compose ainsi de :

• Un modèle
• Une série de données de forçage (période d’étude)
• Un résultat de simulation caractérisé par : Date de lancement de simulation, Période simulée, Indicateur de qualité

Une session de simulation contient pour chaque élément de la zone géographique concernée les valeurs des grandeurs physico-chimiques sur la période simulée, pour chaque pas de temps que comporte la simulation.

• Documentation du modèle numérique Gironde XL 3D
• Site web des Jumeaux numériques du fleuve
• Actualité des Jumeaux numériques du fleuve

Requêter le modèle Gironde XL 3D

Paramètres d'URL

Obtenir les valeurs d'un point géographique

Appeler l'action /point et définissant les paramètres dans l'url. Les paramètres lat et lng sont attendus en EPSG:4326. La date est attendue en UTC.

https://data.jumeaux-numeriques.fr/api/selafapi/v1/activities/fd3ef491-2797-40ef-aefa-eb716f6118b1/point?mode=2d&plane=1&lat=45.610194&lng=-1.307373&date=2024-12-26T02:00:00

{
  "type": "Feature",
  "properties": {
    "date": "2024-12-08T02:00:00Z",
    "lat": 45.610194,
    "lng": -1.307373,
    "plane": 1,
    "variables": {
      "AIR PRESSURE": {
        "value": 1016.8,
        "unit": "PASCAL"
      },
      "VELOCITY ANGLE": {
        "value": 2.4035532,
        "unit": "RADIAN"
      },
      "FREE SURFACE": {
        "value": -1.3531786,
        "unit": "M"
      },
      "VELOCITY MAGNITUDE": {
        "value": 0.14340316,
        "unit": "M/S"
      },
      "VELOCITY U": {
        "value": 0.096487194,
        "unit": "M/S"
      },
      "VELOCITY V": {
        "value": -0.10608811,
        "unit": "M/S"
      },
      "WATER DEPTH": {
        "value": 11.026792,
        "unit": "M"
      },
      "WIND ALONG X": {
        "value": 9.355032,
        "unit": "M/S"
      },
      "WIND ALONG Y": {
        "value": -13.36037,
        "unit": "M/S"
      }
    }
  },
  "geometry": {
    "type": "Point",
    "coordinates": [-1.307373, 45.610194]
  }
}

Description des variables

Les informations suivantes sont disponibles :

• FREE SURFACE: hauteur de la surface d'eau de l’estuaire. L'unité utilisée est le mètre dans le référentiel hydrographique, correspondant au niveau d’eau local le plus bas observé. Une correction locale doit être apportée pour obtenir une hauteur dans le référentiel altimétrique IGN 69. Voir annexe pour la Gironde (info sur calage zéro hydro)
• VELOCITY ANGLE: angle du vecteur courant par rapport au nord (sens trigonométrique). Cette valeur est calculée à partir des composantes U et V des variables VELOCITY MAGNITUDE. L'unité utilisée est le radian (rad).
• VELOCITY U: vitesse des courants marins dans la direction Est-Ouest (valeur positive = le courant se déplace vers l'Est / valeur négative = le courant se déplace vers l’Ouest. L'unité utilisée est le mètre par seconde («m/s»).
• VELOCITY V: vitesse des courants marins dans la direction Nord-Sud (valeur positive = le courant se déplace vers le Nord / valeur négative = le courant se déplace vers le Sud. L'unité utilisée est le mètre par seconde («m/s»).
• VELOCITY MAGNITUDE: vitesse totale du courant marin (module vitesse au sens du vecteur), elle combine VELOCITY U et V. L'unité utilisée est le mètre par seconde («m/s»).
• WIND ALONG X: vitesse du vent dans la direction X (direction géographique est-ouest ou longitude). L'unité utilisée est le mètre par seconde (m/s).
• WIND ALONG Y: vitesse du vent dans la direction Y (direction géographique est-ouest ou longitude). L'unité utilisée est le mètre par seconde (m/s).
• AIR PRESSURE: pression atmosphérique. L'unité utilisée est le Pascal (elle exprime la force exercée par l'air sur une surface donnée / un pascal = un newton par mètre carré)

Obtenir les métadonnées d'une activité

Appeler l'action /metadata

https://data.jumeaux-numeriques.fr/api/selafapi/v1/activities/fd3ef491-2797-40ef-aefa-eb716f6118b1/metadata?mode=2d&plane=1&lat=45.610194&lng=-1.307373&date=2024-12-08T02:00:00

{
  "variables": [
    {
      "name": "VELOCITY U",
      "unit": "M/S"
    },
    {
      "name": "VELOCITY V",
      "unit": "M/S"
    },
    {
      "name": "FREE SURFACE",
      "unit": "M"
    },
    {
      "name": "BOTTOM",
      "unit": "M"
    },
    {
      "name": "WIND ALONG X",
      "unit": "M/S"
    },
    {
      "name": "WIND ALONG Y",
      "unit": "M/S"
    },
    {
      "name": "AIR PRESSURE",
      "unit": "PASCAL"
    },
    {
      "name": "BOTTOM",
      "unit": "FRICTION"
    },
    {
      "name": "VELOCITY MAGNITUDE",
      "unit": "M/S"
    },
    {
      "name": "VELOCITY ANGLE",
      "unit": "RADIAN"
    }
  ],
  "begin": "2024-12-26T00:00:00Z",
  "timestep": {
    "Duration": 3600000000000
  },
  "num_timesteps": 41,
  "projection": "EPSG:2154",
  "num_planes": 1,
  "activity_id": "fd3ef491-2797-40ef-aefa-eb716f6118b1",
  "simulation_id": "540c501c-0870-4e7c-9218-bbf396a85ed1",
  "simulation_date": "2024-12-26T12:01:10Z",
  "simulation_url": "https://forge.naos-cluster.tech/gpmb/modeles-telemac/gironde-xl-3d"
}

Description de la réponse

Les informations suivantes sont disponibles :

• variables: tableau des variables disponibles dans le modèle
• begin: date de début du modèle en UTC (premier pas de temps)
• timestep: durée entre chaque donnée temporelle (pas de temps)
• num_timesteps: nombre de données temporelles (pas de temps)
• projection: projection originale du modèle
• num_planes: nombre de plans verticaux du modèle. Plus le plan est élevé plus la donnée est proche de la surface
• activity_id: identifiant unique de l'activité
• simulation_id: identifiant unique de la simulation ayant généré les données
• simulation_date: date de lancement du calcul de simulation en UTC
• simulation_url: code source de la simulation