Includes functions to upload DESC and VMEC data to the stellarator database.
Project description
Stellarator-Database
Includes the functions required to upload DESC or VMEC results to the stellarator database. You can access the database here.
This is still a work in progress.
Install using pip
pip install stelladb
Install using GIT
Clone GIT repo
git clone https://github.com/PlasmaControl/Stellarator-Database.git
Once you get the files,
cd Stellarator-Database
Building conda environment
conda create --name db 'python>=3.9, <=3.12'
conda activate db
pip install -r requirements.txt
Sample usage
For more detailed explanation, refer to the tutorial.ipynb
notebook in the repo.
from desc.examples import get
from stelladb import save_to_db_desc
eq = get("HELIOTRON")
# if you are using DESC, you can directly upload Equilibrium or
# EquilibriumFamily objects. For EquilibriumFamily, only the last
# Equilibrium will be uploaded.
save_to_db_desc(eq, config_name="test-HELIOTRON", user="username")
# if you have an outfile, supply the name of it without extension
# For DESC example, we need to save it first to get the .h5 file
eq.save("test_output_HELIOTRON.h5")
save_to_db_desc("test_output_HELIOTRON", config_name="another-HELIOTRON", user="username")
# use copy parameter, if you want the local copy of the files that are uploaded
# default value is False
save_to_db_desc(eq, config_name="HELIOTRON-test-name", user="username", copy=True)
You can give config_name
as you wish. However, if there is an existing configuration with same parameters in the database, you will get following error,
Configuration data already exists in the database with name: HELIOTRON.
Then, you should change your config_name
to match that and try again.
VMEC Utilities are not tested yet!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
stelladb-0.2.8.tar.gz
(12.3 kB
view hashes)
Built Distribution
stelladb-0.2.8-py3-none-any.whl
(14.3 kB
view hashes)