This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
docs:utils:findsoln [2010/03/04 07:52] gibson created |
docs:utils:findsoln [2010/03/04 17:37] (current) gibson |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== findsoln ====== | ====== findsoln ====== | ||
- | find an equilibrium, traveling wave, periodic orbit, or relative periodic orbit of plane Couette or channel flow | + | find an equilibrium, traveling wave, periodic orbit, or relative periodic orbit of plane Couette or channel flow, |
+ | using a [[docs:math:newton_krylov_hookstep| Newton-Krylov-hookstep search algorithm]]. | ||
====== main options ====== | ====== main options ====== | ||
Line 20: | Line 21: | ||
</code> | </code> | ||
+ | ====== solution type ====== | ||
+ | |||
+ | ''findsoln'' finds solutions of //σ f^T(u) - u = 0// where //f^T// is the time-//T// forward map of the Navier-Stokes equations plus boundary conditions and σ is a symmetry of the flow. This equation has several kinds of solutions | ||
+ | |||
+ | * equilibrium: //σ = 1///, all //T// | ||
+ | * relative equilibrium: //σ = // a translation or phase shift that scales linearly in //T//, all //T// (also called a traveling wave) | ||
+ | * periodic orbit: //σ = 1// and some finite value of //T// (and integer multiples of it) | ||
+ | * preperiodic orbit: //σ ≠ 1// but //σ^n = 1// for some //n>1//, and some finite value of //T// (and integer multiples) | ||
+ | * relative periodic orbit: some element //σ// of the appropriate symmetry group, and some finite value of //T// (and integer multiples) | ||
+ | |||
+ | You specify which kind of solution to find by telling the search algorithm which variables to treat as unknowns, with the ''-eqb, -orb, -xrel, -zrel'' options. The ''-eqb'' option specifies that //T// is held fixed; the ''-orb'' option specifies that is unknown. The ''-xrel'' and ''-zrel'' options specifying that the //x// and //z// phase shifts in σ are unknown. The appropriate combinations for each solution type are best shown by example. | ||
+ | |||
+ | ^command^search type^ | ||
+ | |''findsoln -eqb uguess.h5'' | equilibrium solution | | ||
+ | |''findsoln -eqb -xrel uguess.h5'' | traveling wave in //x// | | ||
+ | |''findsoln -eqb -xrel -zrel uguess.h5'' | traveling wave in //x,z// | | ||
+ | |''findsoln -eqb -zrel -sigma sigma.asc -T 20 uguess.h5'' | traveling wave in //z// with an initial guess for wavespeed | | ||
+ | |''findsoln -orb -T 64.3 uguess.asc'' | periodic orbit with initial guess for period //T// | | ||
+ | |''findsoln -orb -T 34.8 -sigma sigma.asc uguess.h5'' | pre-periodic orbit | | ||
+ | |''findsoln -orb -xrel -T 49.1 -sigma sigma.asc uguess.h5'' | relative periodic orbit with phase shift in //x// | | ||
+ | |||
+ | |||
+ | ([[docs:math:newton_krylov_hookstep|mathematical details of algorithm]] |