extractinput

Data files produced by Gkeyll may have the input file used to generate that data saved in them as an attribute. We can extract the input file and print it to screen or to a new file with extractinput.

Command Docstrings

Certain versions of ADIOS (the I/O library Gkeyll uses) have trouble saving very long files. For this reason saving the input file in data files is sometimes disabled. In those cases extractinput may fail or return nothing.

Command line

Command help
pgkyl extractinput -h
  Usage: pgkyl extractinput [OPTIONS]

     Extract embedded input file from compatible BP files

  Options:
     -u, --use TEXT  Specify a 'tag' to apply to (default all tags).
     -h, --help  Show this message and exit.

If we run the ion acoustic gyrokinetic simulation, it would produce save the initial ion distribution function in the file gk-ionSound-1x2v-p1_ion_0.bp. We can extract the input file used to generate this data with

pgkyl gk-ionSound-1x2v-p1_ion_0.bp extract

where we have shortened extractinputfile into extract for simplicity. This would print it to screen.

Suppose you wish to write it to a new file because, say, you lost the original input file and wish to recreate or restart this simulation. You could write the saved input file to a new input file with:

pgkyl gk-ionSound-1x2v-p1_ion_0.bp extract > gk-ionSound-1x2v-p1.lua

If you are using the same name as the original input file you’ll be able to restart the simulation. If the original input file is still in the directory it will be overwritten.