-- Input file for Poisson bracket operator
-- polynomial order
polyOrder = 1
-- cfl number to use
cfl = 0.3/2
-- domain extents
XL, XU = -2*Lucee.Pi, 2*Lucee.Pi
VL, VU = -10.0, 10.0
-- number of cells
NX, NV = 16, 32
-- electron temperature
elcTemp = 1.0
-- signed electron charge
elcCharge = -1.0
-- electron mass
elcMass = 1.0
-- permittivity of free space
epsilon0 = 1.0
-- Determine number of global nodes per cell for use in creating CG
-- fields. Note that this looks a bit odd as this not the number of
-- *local* nodes but the number of nodes in each cell to give the
-- correct number of global nodes in fields.
if (polyOrder == 1) then
numCgNodesPerCell = 1
numCgNodesPerCell_1d = 1 -- for spatial basis
elseif (polyOrder == 2) then
numCgNodesPerCell = 3
numCgNodesPerCell_1d = 2 -- for spatial basis
end
-- Determine number of global nodes per cell for use in creating DG
-- fields.
if (polyOrder == 1) then
numDgNodesPerCell = 4
numDgNodesPerCell_1d = 2 -- for spatial basis
elseif (polyOrder == 2) then
numDgNodesPerCell = 8
numDgNodesPerCell_1d = 3 -- for spatial basis
end
-- phase space grid
grid = Grid.RectCart2D {
lower = {XL, VL},
upper = {XU, VU},
cells = {NX, NV},
}
-- create FEM nodal basis
basis = NodalFiniteElement2D.Serendipity {
-- grid on which elements should be constructured
onGrid = grid,
-- polynomial order in each cell. One of 1, or 2. Corresponding
-- number of nodes are 4 and 8.
polyOrder = polyOrder,
}
-- distribution function for ions
distfIon = DataStruct.Field2D {
onGrid = grid,
numComponents = 1*numDgNodesPerCell,
ghost = {1, 1},
}
-- clear out contents
distfIon:clear(0.0)
-- Maxwellian
function maxwellian(vt, vdrift, x, v)
return 1/math.sqrt(2*Lucee.Pi*vt^2)*math.exp(-(v-vdrift)^2/(2*vt^2))
end
-- updater to initialize distribution function
initDistfIon = Updater.EvalOnNodes2D {
onGrid = grid,
-- basis functions to use
basis = basis,
-- are common nodes shared?
shareCommonNodes = false, -- In DG, common nodes are not shared
-- function to use for initialization
evaluate = function(x,y,z,t)
local vd = 1.0
return maxwellian(elcTemp, vd, x, y)
end
}
initDistfIon:setOut( {distfIon} )
-- initialize ion distribution function
initDistfIon:advance(0.0) -- time is irrelevant
-- write this out a diagnostic
distfIon:write("distfIon.h5")
-- distribution function
distf = DataStruct.Field2D {
onGrid = grid,
numComponents = 1*numDgNodesPerCell,
ghost = {1, 1},
}
-- clear out contents
distf:clear(0.0)
-- extra fields for performing RK update
distfNew = DataStruct.Field2D {
onGrid = grid,
numComponents = 1*numDgNodesPerCell,
ghost = {1, 1},
}
distf1 = DataStruct.Field2D {
onGrid = grid,
numComponents = 1*numDgNodesPerCell,
ghost = {1, 1},
}
-- Hamiltonian
hamil = DataStruct.Field2D {
onGrid = grid,
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numCgNodesPerCell,
ghost = {1, 1},
-- ghost cells to write
writeGhost = {0, 1} -- write extra layer on right to get nodes
}
-- create field to store kinetic energy term in Hamiltonian
hamilKE = DataStruct.Field2D {
onGrid = grid,
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numCgNodesPerCell,
ghost = {1, 1},
-- ghost cells to write
writeGhost = {0, 1} -- write extra layer on right to get nodes
}
-- updater to initialize hamiltonian
initHamilKE = Updater.EvalOnNodes2D {
onGrid = grid,
-- basis functions to use
basis = basis,
-- are common nodes shared?
shareCommonNodes = true,
-- function to use for initialization
evaluate = function (x,y,z,t)
local v = y
return v^2/2
end
}
initHamilKE:setOut( {hamilKE} )
-- initialize potential
initHamilKE:advance(0.0) -- time is irrelevant
hamilKE:applyPeriodicBc(0)
-- write this out a diagnostic
hamilKE:write("hamilKE.h5")
-- updater to initialize distribution function
initDistf = Updater.EvalOnNodes2D {
onGrid = grid,
-- basis functions to use
basis = basis,
-- are common nodes shared?
shareCommonNodes = false, -- In DG, common nodes are not shared
-- function to use for initialization
evaluate = function(x,y,z,t)
local alpha = 1.0 -- perturbation
local vd = 1.0
local xm = XL + 0.25*(XU-XL)
if (x<xm) then
return (1+math.exp(-0.75*(x-xm)^2))*maxwellian(elcTemp, vd, x, y)
else
return (1+math.exp(-0.075*(x-xm)^2))*maxwellian(elcTemp, vd, x, y)
end
end
}
initDistf:setOut( {distf} )
-- initialize potential
initDistf:advance(0.0) -- time is irrelevant
-- updater for Poisson bracket
pbSlvr = Updater.PoissonBracket {
onGrid = grid,
-- basis functions to use
basis = basis,
-- cfl number to use
cfl = cfl,
-- flux type: one of "upwind" (default) or "central"
fluxType = "upwind",
}
-- spatial grid
grid_1d = Grid.RectCart1D {
lower = {XL},
upper = {XU},
cells = {NX},
}
-- spatial FEM nodal basis
basis_1d = NodalFiniteElement1D.Lobatto {
-- grid on which elements should be constructured
onGrid = grid_1d,
-- polynomial order in each cell. One of 1, or 2. Corresponding
-- number of nodes are 2 and 3.
polyOrder = polyOrder,
}
-- number density
numDensityIon = DataStruct.Field1D {
onGrid = grid_1d,
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numDgNodesPerCell_1d,
ghost = {1, 1},
}
-- number density
numDensity = DataStruct.Field1D {
onGrid = grid_1d,
location = "vertex",
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numDgNodesPerCell_1d,
ghost = {1, 1},
}
-- copy is needed as numDensity field is modified to represent net
-- charge density.
numDensityCopy = DataStruct.Field1D {
onGrid = grid_1d,
location = "vertex",
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numDgNodesPerCell_1d,
ghost = {1, 1},
}
-- to compute number density
numDensityCalc = Updater.DistFuncMomentCalc1D {
-- 2D phase-space grid
onGrid = grid,
-- 2D phase-space basis functions
basis2d = basis,
-- 1D spatial basis functions
basis1d = basis_1d,
-- desired moment (0, 1 or 2)
moment = 0,
}
-- dynvector for total particle count
totalPtcl = DataStruct.DynVector { numComponents = 1, }
-- to compute total number of particles in domain
totalPtclCalc = Updater.IntegrateNodalField1D {
-- grid for updater
onGrid = grid_1d,
-- basis functions to use
basis = basis_1d,
-- are common nodes shared?
shareCommonNodes = false, -- for DG fields common nodes not shared
}
-- set input field
totalPtclCalc:setIn( {numDensityCopy} )
-- set output dynvector
totalPtclCalc:setOut( {totalPtcl} )
-- dynvector for number density in a cell
numDensInCell = DataStruct.DynVector {
numComponents = numDgNodesPerCell_1d,
}
-- to compute number density in a cell
numDensInCellCalc = Updater.RecordFieldInCell1D {
-- grid for updater
onGrid = grid_1d,
-- index of cell to record
cellIndex = {2},
}
-- set input field
numDensInCellCalc:setIn( {numDensityCopy} )
-- set output dynvector
numDensInCellCalc:setOut( {numDensInCell} )
-- ptcl energy
ptclEnergy = DataStruct.Field1D {
onGrid = grid_1d,
location = "vertex",
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numDgNodesPerCell_1d,
ghost = {1, 1},
}
-- updater to compute ptcl energy
ptclEnergyCalc = Updater.DistFuncMomentCalc1D {
-- 2D phase-space grid
onGrid = grid,
-- 2D phase-space basis functions
basis2d = basis,
-- 1D spatial basis functions
basis1d = basis_1d,
-- desired moment (0, 1 or 2)
moment = 2,
}
-- dynvector for total ptcl energy
totalPtclEnergy = DataStruct.DynVector { numComponents = 1, }
-- to compute total particle energy
totalPtclEnergyCalc = Updater.IntegrateNodalField1D {
-- grid for updater
onGrid = grid_1d,
-- basis functions to use
basis = basis_1d,
-- are common nodes shared?
shareCommonNodes = false, -- for DG fields common nodes not shared
}
-- set input field
totalPtclEnergyCalc:setIn( {ptclEnergy} )
-- set output dynvector
totalPtclEnergyCalc:setOut( {totalPtclEnergy} )
-- momentum
ptclMomentum = DataStruct.Field1D {
onGrid = grid_1d,
location = "vertex",
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numDgNodesPerCell_1d,
ghost = {1, 1},
}
-- updater to compute ptcl momentum
ptclMomentumCalc = Updater.DistFuncMomentCalc1D {
-- 2D phase-space grid
onGrid = grid,
-- 2D phase-space basis functions
basis2d = basis,
-- 1D spatial basis functions
basis1d = basis_1d,
-- desired moment (0, 1 or 2)
moment = 1,
}
-- dynvector for total ptcl momentum
totalPtclMomentum = DataStruct.DynVector { numComponents = 1, }
-- to compute total particle momentum
totalPtclMomentumCalc = Updater.IntegrateNodalField1D {
-- grid for updater
onGrid = grid_1d,
-- basis functions to use
basis = basis_1d,
-- are common nodes shared?
shareCommonNodes = false, -- for DG fields common nodes not shared
}
-- set input field
totalPtclMomentumCalc:setIn( {ptclMomentum} )
-- set output dynvector
totalPtclMomentumCalc:setOut( {totalPtclMomentum} )
-- calculate number density
function calcNumDensity(curr, dt, distfIn, numDensOut)
numDensityCalc:setCurrTime(curr)
numDensityCalc:setIn( {distfIn} )
numDensityCalc:setOut( {numDensOut} )
numDensityCalc:advance(curr+dt)
numDensOut:applyPeriodicBc(0)
-- make copy to use in diagnostics
numDensityCopy:copy(numDensOut)
end
-- compute number density for ions
calcNumDensity(0.0, 0.0, distfIon, numDensityIon)
-- write it out
numDensityIon:write("numDensityIon.h5")
-- calculate ptcl energy
function calcPtclEnergy(curr, dt, distfIn, energyOut)
ptclEnergyCalc:setCurrTime(curr)
ptclEnergyCalc:setIn( {distfIn} )
ptclEnergyCalc:setOut( {energyOut} )
ptclEnergyCalc:advance(curr+dt)
energyOut:applyPeriodicBc(0)
end
-- calculate ptcl momentum
function calcPtclMomentum(curr, dt, distfIn, momentumOut)
ptclMomentumCalc:setCurrTime(curr)
ptclMomentumCalc:setIn( {distfIn} )
ptclMomentumCalc:setOut( {momentumOut} )
ptclMomentumCalc:advance(curr+dt)
momentumOut:applyPeriodicBc(0)
end
-- compute moments from distribution function
function calcMoments(curr, dt, distfIn)
calcNumDensity(curr, dt, distfIn, numDensity)
calcPtclEnergy(curr, dt, distfIn, ptclEnergy)
calcPtclMomentum(curr, dt, distfIn, ptclMomentum)
end
-- function to apply boundary conditions
function applyBc(fld)
fld:applyPeriodicBc(0)
fld:applyPeriodicBc(1)
end
-- apply BCs to initial conditions
applyBc(distf)
-- field to store continous potential in 1D
phi1d = DataStruct.Field1D {
onGrid = grid_1d,
-- numNodesPerCell is number of global nodes stored in each cell
numComponents = 1*numCgNodesPerCell_1d,
-- ghost cells
ghost = {1, 1},
-- write ghosts
writeGhost = {0, 1},
}
-- updater to copy 1D field to 2D field
copyTo2D = Updater.Copy1DTo2DNodalField {
-- grid for updater
onGrid = grid,
}
-- function to copy 1D field to 2D field
function copyPhi(curr, dt, phi1, phi2)
copyTo2D:setCurrTime(curr)
copyTo2D:setIn( {phi1} )
copyTo2D:setOut( {phi2} )
copyTo2D:advance(curr+dt)
phi2:applyPeriodicBc(0)
end
-- updater to compute phi from number density
phiFromNumDensityCalc = Updater.FemPoisson1D {
-- grid for updater
onGrid = grid_1d,
-- basis functions to use
basis = basis_1d,
-- flag to indicate if nodes in src field are shared
sourceNodesShared = false, -- default true
-- periodic directions
periodicDirs = {0},
}
-- dynvector for field energy
fieldEnergy = DataStruct.DynVector { numComponents = 1, }
-- to compute field energy
fieldEnergyCalc = Updater.NormGrad1D {
-- grid for updater
onGrid = grid_1d,
-- basis functions to use
basis = basis_1d,
}
-- set input field
fieldEnergyCalc:setIn( {phi1d} )
-- set output dynvector
fieldEnergyCalc:setOut( {fieldEnergy} )
-- update Poisson bracket operator
function poissonBracket(curr, dt, distfIn, hamilIn, distfOut)
pbSlvr:setCurrTime(curr)
pbSlvr:setIn( {distfIn, hamilIn} )
pbSlvr:setOut( {distfOut} )
return pbSlvr:advance(curr+dt)
end
-- compute phi from number density
function calcPhiFromNumDensity(curr, dt, numDensIn, phiOut)
phiOut:clear(0.0)
phiFromNumDensityCalc:setCurrTime(curr)
numDensIn:accumulate(-1.0, numDensityIon)
numDensIn:scale(1/epsilon0)
numDensIn:applyPeriodicBc(0)
phiFromNumDensityCalc:setIn( {numDensIn} )
phiFromNumDensityCalc:setOut( {phiOut} )
return phiFromNumDensityCalc:advance(curr+dt)
end
-- compute hamiltonian
function calcHamiltonian(curr, dt, distIn, hamilOut)
calcMoments(curr, dt, distIn)
calcPhiFromNumDensity(curr, dt, numDensity, phi1d)
hamilOut:clear(0.0)
copyPhi(curr, dt, phi1d, hamilOut) -- potential energy contribution
hamilOut:scale(elcCharge/elcMass)
hamilOut:accumulate(1.0, hamilKE)
hamilOut:applyPeriodicBc(0)
end
-- calculate initial Hamiltonian
calcHamiltonian(0.0, 0.0, distf, hamil)
-- compute various diagnostics
function calcDiagnostics(curr, dt)
totalPtclCalc:setCurrTime(curr)
totalPtclCalc:advance(curr+dt)
numDensInCellCalc:setCurrTime(curr)
numDensInCellCalc:advance(curr+dt)
totalPtclEnergyCalc:setCurrTime(curr)
totalPtclEnergyCalc:advance(curr+dt)
totalPtclMomentumCalc:setCurrTime(curr)
totalPtclMomentumCalc:advance(curr+dt)
fieldEnergyCalc:setCurrTime(curr)
fieldEnergyCalc:advance(curr+dt)
end
-- compute initial diagnostics
calcDiagnostics(0.0, 0.0) -- funky?
-- function to take a time-step using SSP-RK3 time-stepping scheme
function rk3(tCurr, myDt)
local status, dtSuggested
-- RK stage 1
status, dtSuggested = poissonBracket(tCurr, myDt, distf, hamil, distf1)
if (status == false) then
return status, dtSuggested
end
applyBc(distf1)
calcHamiltonian(tCurr, myDt, distf1, hamil)
-- RK stage 2
status, dtSuggested = poissonBracket(tCurr, myDt, distf1, hamil, distfNew)
if (status == false) then
return status, dtSuggested
end
distf1:combine(3.0/4.0, distf, 1.0/4.0, distfNew)
applyBc(distf1)
calcHamiltonian(tCurr, myDt, distf1, hamil)
-- RK stage 3
status, dtSuggested = poissonBracket(tCurr, myDt, distf1, hamil, distfNew)
if (status == false) then
return status, dtSuggested
end
distf1:combine(1.0/3.0, distf, 2.0/3.0, distfNew)
applyBc(distf1)
distf:copy(distf1)
calcHamiltonian(tCurr, myDt, distf, hamil)
return status, dtSuggested
end
-- make a duplicate in case we need it
distfDup = distf:duplicate()
-- function to advance solution from tStart to tEnd
function advanceFrame(tStart, tEnd, initDt)
local step = 1
local tCurr = tStart
local myDt = initDt
local status, dtSuggested
while tCurr<=tEnd do
distfDup:copy(distf)
if (tCurr+myDt > tEnd) then
myDt = tEnd-tCurr
end
print (string.format("Taking step %d at time %g with dt %g", step, tCurr, myDt))
status, dtSuggested = rk3(tCurr, myDt)
if (status == false) then
print (string.format("** Time step %g too large! Will retake with dt %g", myDt, dtSuggested))
distf:copy(distfDup)
myDt = dtSuggested
else
calcDiagnostics(tCurr, myDt)
tCurr = tCurr + myDt
myDt = dtSuggested
step = step + 1
if (tCurr >= tEnd) then
break
end
end
end
return dtSuggested
end
-- write data to H5 files
function writeFields(frame)
distf:write( string.format("distf_%d.h5", frame) )
numDensityCopy:write( string.format("numDensity_%d.h5", frame) )
ptclMomentum:write( string.format("ptlcMomentum_%d.h5", frame) )
phi1d:write( string.format("phi1d_%d.h5", frame) )
hamil:write( string.format("hamil_%d.h5", frame) )
totalPtcl:write( string.format("totalPtcl_%d.h5", frame) )
totalPtclEnergy:write( string.format("totalPtclEnergy_%d.h5", frame) )
totalPtclMomentum:write( string.format("totalPtclMomentum_%d.h5", frame) )
fieldEnergy:write( string.format("fieldEnergy_%d.h5", frame) )
numDensInCell:write( string.format("numDensInCell_%d.h5", frame) )
end
-- write out initial conditions
writeFields(0)
-- parameters to control time-stepping
tStart = 0.0
tEnd = 20.0
dtSuggested = 0.1*tEnd -- initial time-step to use (will be adjusted)
nFrames = 1
tFrame = (tEnd-tStart)/nFrames
tCurr = tStart
for frame = 1, nFrames do
Lucee.logInfo (string.format("-- Advancing solution from %g to %g", tCurr, tCurr+tFrame))
dtSuggested = advanceFrame(tCurr, tCurr+tFrame, dtSuggested)
writeFields(frame)
tCurr = tCurr+tFrame
Lucee.logInfo ("")
end