Nstrophy is a tool to compute the two-dimensional flow of the Navier-Stokes equation as well as Gallavotti's reversible Navier-Stokes equation, and compare them.
Go to file
2023-06-13 19:01:37 -04:00
docs Proper normalization for enstrophy norm 2023-06-13 19:01:37 -04:00
src Proper normalization for enstrophy norm 2023-06-13 19:01:37 -04:00
LICENSE License 2023-05-10 19:33:29 -04:00
Makefile License 2023-05-10 19:33:29 -04:00
README.md delta_max and fix cabs2 2023-06-13 18:45:19 -04:00

Nstrophy is a tool to solve the two-dimensional Navier-Stokes equation as well as Gallavotti's reversible Navier-Stokes equation and compare them.

Nstrophy is under active development

Building

Compile Nstrophy with

make

which will place a binary at build/nstrophy.

The syntax for the execution of Nstrophy is

./build/nstrophy [-p parameters] [-s savefile] <command>

Nstrophy is written in C. The Makefile uses the GNU C Compiler.

Nstrophy depends on fftw: [https://fftw.org]

Commands

The available commands are

  • enstrophy: to compute the enstrophy and various other observables. This command prints step_index time average(alpha) average(enstrophy) average(alpha*enstrophy) alpha enstrophy alpha*enstrophy where the averages are running averages over print_freq. In addition, if the algorithm has an adaptive step, an extra column is printed with delta.

  • uk: to compute the Fourier transform of the solution.

  • quiet: does not print anything, useful for debugging.

Parameters

The parameters can be specified using the -p flag. The parameter string should be a ; sperated list of key=value pairs. The possible keys are

  • equation: either irreverisible (default) or reversible.

  • K (int, default 16): cutoff in momentum space: -K<=k_i<=K

  • K1 (int, default K): cutoff in momentum space for the x component: -K<=k_x<=K

  • K2 (int, default K): cutoff in momentum space for the y component: -K<=k_y<=K

  • N (int, default smallest power of 2 that is larger than 3K): size of fft vectors: must be at least 3 times K to avoid aliasing.

  • N1 (int, default N): same as N but only for x component.

  • N2 (int, default N): same as N but only for y component.

  • final_time (double, default 100000): time at which to end the computation. Set to <0 to keep on going forever.

  • nu (double, default 0.00048828125): viscosity.

  • delta (double, default 0.0001220703125): step size.

  • L (double, default 2pi): size of box.

  • print_freq (double, default 1): only print when time crosses integer multiples of print_freq.

  • starting_time (double, default 0): starting time.

  • driving: either zero for no driving, test (default) for a testing driving force or file:<filename> or file_txt:<filename> to read the driving force from a file. When using file:<filename> the file should be binary, whereas with file_txt:<filename> it should be plaintext. The binary file format is (double)(double) for each entry of the driving force, excluding kx<0 and kx=0&&ky<=0. The plaintext file format is kx ky real_part imag_part.

  • init: either random for a random initialization, gaussian (default) for a Gaussian initial condition or file:<filename> or file_txt:<filename> to read the driving force from a file. When using file:<filename> the file should be binary, whereas with file_txt:<filename> it should be plaintext. The binary file format is (double)(double) for each entry of the driving force, excluding kx<0 and kx=0&&ky<=0. The plaintext file format is kx ky real_part imag_part.

  • init_en (double, default 1.54511597324389e+02): initial value of the energy if equation=irreversible or of the enstrophy if equation=reversible.

  • random_seed (int, default ): seed for random initialization.

  • algorithm: fixed step methods: RK4 for Runge-Kutta 4, RK2 for Runge-Kutta 2. adaptive step methods: RKF45 for Runge-Kutta-Fehlberg (order 4), RKDP54 for Runge-Kutta-Dormand-Prince (order 5), RKBS32 for Runge-Kutta-Bogacki-Shampine (order 3).

  • adaptive_tolerance (double, default 1e-11): when using an adaptive step method, this is the maximal allowed relative error.

  • adaptive_factor (double, default 0.9): when using the RKF45 method, the step gets adjusted by factor*delta*(tolerance/error)^(1/5).

  • max_delta (double, default 1e-2): when using the adaptive step, do not exceet delta_max.

Interrupting/resuming the computation

The computation can be interrupted by sending Nstrophy the SIGINT signal (e.g. by pressing Ctrl-C.) When Nstrophy receives the SIGINT signal, it finishes its current step and writes the value of uk, either to savefile if such a file was specified on the command line (using the -s flag), or to stderr. In addition, when a savefile is specified it writes the command that needs to be used to resume the computation (which essentially just sets the appropriate starting_time and init:file:<savefile> parameters. The data written to the savefile is binary.

License

Nstrophy is released under the Apache 2.0 license.

Copyright 2017-2023 Ian Jauslin