Skip to content

GitLab

G
gkdb

Home

Last edited by Yann Camenen
Page history

The Gyro-Kinetic DataBase (GKDB) project

The Gyro-Kinetic DataBase (GKDB) is a publicly accessible database of δf flux-tube gyro-kinetic simulations of tokamak plasmas. It was designed to serve the following purposes:

  • Repository for simulation data used in publications and conferences
  • Platform for code benchmarks
  • Train neural networks for fast and accurate prediction of turbulent transport in the quasi-linear approximation

The GKDB is being developed in the EUROfusion Enabling Research Project: Realtime capable first principle transport modelling for tokamak prediction and control. This project aims to provide an accurate and realtime-capable transport model for tokamak temperature, density, and rotation velocity prediction.

Many of the GKDB tools are still in development. Please let us know if you think a new functionality should be added!!

Database overview

The GKDB is a PostgreSQL database and is hosted at gkdb.org. It stores the inputs and outputs of a gyro-kinetic simulation with all physical quantities normalized following the GKDB conventions. The physical inputs and outputs, together with the code specific parameters (grids, code version, etc.) necessary to reproduce the simulations are combined into a single entry named ids_properties.
The database schema and the GKDB parameters definition are described in the documentation section.

Contributing to the GKDB

The database is meant to be a community tool and the hope is that many users will contribute to populate the GKDB. The main steps to upload data to the GKDB are:

  • Generate a JSON file containing gyro-kinetic simulation results converted to the GKDB format
  • Use the GKDB Python module to convert the JSON file into an entry in the SQL database The GKDB Python module automatically performs the following tasks:
    • Compute derived quantities for more convenient queries
    • Check the entry validity (fields dimensions, ranges, etc.)
    • Check the entry sanity (numerical stability, ambipolarity, etc.)
    • If all checks pass a new ids_properties is added to the database

Getting Started

Codes interfaced with the GKDB

The gyro-kinetic code GKW is interfaced with the GKDB. The conversion of GKW data to the GKDB format is documented here and a Matlab package has been developed to convert the data and generate a JSON file for submission to the GKDB.

The interface for the GENE and QuaLiKiz codes is currently being developed.