Interface Option 1

The following preliminary design option gives the PPF more control over the particles. The added control enables the PPF to force the programmers to correctly implement domain decomposition of their code and cuts down on the amount of code the developer using the PPF must write. The drawbacks of implementing the PPF with more control is that it makes it more difficult to integrate the PPF into existing code and packages using the PPF will contain large amounts of proprietary code that is PPF specific.

• PPF.submitParticles pass the PPF a pointer to the list of particles
• PPF.reset set the current position in the particle list to the first particle
• PPF.nextParticle return a pointer to current particle in the list, advance current particle to the next particle in the list
• PPF.moveTo move current particle to x position, y position in mesh (Note: message passing must be considered in this method)
• PPF.getParticle return the current particle
• PPF.addParticle add a single particle to the current position
• PPF.distributeParticleList add the particles within a linked list to the current list of particles by randomly distributing them throughout the current list.
• PPF.deleteParticle delete current particle, or particle at a given index