PeriodicXPIC Custom Task

A custom task to use XPIC(m) method on selected time steps

Introduction

The XPIC(m) method is an advanced damping method that filters out unwanted noise (in the null space) without damping out useful information. Its drawback is that it adds calculation time as m in XPIC(m) increases. In some simulations, it may not be necessary to use XPIC(m) update methods on every time step. This custom tasks lets you convert such simulations to use XPIC(m) periodically instead of on every time step. Note that both the XPIC(m) method and this custom tasks are only available in OSParticulas.

Task Scheduling

The first step is to select default update method. Normally, the default method would be a standard FLIP method selected by using Damping commands and picking (fractionPIC) to 1. Next, you select an XPIC order (the m in XPIC(m)) and frequency to run the XPIC(m) calculations. In scripted files, a PeriodicXPIC custom task is scheduled with

CustomTask PeriodicXPIC
Parameter periodicSteps,(stepInterval)
Parameter periodicTime,(timeInterval)
Parameter XPICOrder,(order)
Parameter fractionPIC,(fractionPIC)
Parameter verbose,{verbose}

In XML files, this task is scheduled using a <Schedule> element, which must be within the single <CustomTasks> block:

<Schedule name='PeriodicXPIC'>
   <Parameter name='periodicSteps'>(stepInterval)</Parameter>
   <Parameter name='periodicTime'>(timeInterval)</Parameter>
   <Parameter name='XPICOrder'>(order)</Parameter>
   <Parameter name='fractionPIC'>(fractionPIC)</Parameter>
   <Parameter name='verbose'>(verbose)</Parameter>
</Schedule>

where the parameters are:

• (stepInterval) and (timeInterval) - sets the frequency for running periodic XPIC(m) calculations. The (stepInterval) option sets number of time steps between each XPIC(m) calculation while (timeInterval) sets frequency in alt time units. If both are entered, the (stepInterval) is used. Default is every time step.
• (XPICOrder) and (fractionPIC) - Enter XPIC order (the m in XPIC(m)) and fraction XPIC(m) (0 to 1) to use when doing periodic XPIC(m) calculations. See Damping Options for details on these settings.
• (verbose) - If a non-zero integer, a line is printed in output files every time XPIC(m) calculations are done. The default it 0.