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!!
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
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_propertiesis added to the database
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.