ASPECT
|
Public Member Functions | |
virtual void | initialize_one_particle_property (const Point< dim > &position, std::vector< double > &particle_properties) const |
virtual void | update_particle_properties (const ParticleUpdateInputs< dim > &inputs, typename ParticleHandler< dim >::particle_iterator_range &particles) const |
virtual DEAL_II_DEPRECATED void | update_particle_property (const unsigned int data_position, const Vector< double > &solution, const std::vector< Tensor< 1, dim >> &gradients, typename ParticleHandler< dim >::particle_iterator &particle) const |
virtual UpdateTimeFlags | need_update () const |
virtual UpdateFlags | get_needed_update_flags () const |
virtual InitializationModeForLateParticles | late_initialization_mode () const |
virtual std::vector< std::pair< std::string, unsigned int > > | get_property_information () const =0 |
virtual void | set_data_position (const unsigned int data_position) |
virtual unsigned int | get_data_position () const |
Public Member Functions inherited from aspect::Particle::ParticleInterfaceBase | |
ParticleInterfaceBase () | |
void | set_particle_world_index (unsigned int particle_world_index) |
Set which particle world the plugin belongs to. More... | |
unsigned int | get_particle_world_index () const |
Gets which particle world the plugin belong to. More... | |
Public Member Functions inherited from aspect::Plugins::InterfaceBase | |
virtual | ~InterfaceBase ()=default |
virtual void | initialize () |
virtual void | update () |
virtual void | parse_parameters (ParameterHandler &prm) |
Protected Attributes | |
unsigned int | data_position |
Additional Inherited Members | |
Static Public Member Functions inherited from aspect::Plugins::InterfaceBase | |
static void | declare_parameters (ParameterHandler &prm) |
Interface provides an example of how to extend the Particle class to include related particle data. This allows users to attach scalars/vectors/tensors/etc to particles and ensure they are transmitted correctly over MPI and written to output files.
Definition at line 338 of file interface.h.
|
virtual |
Initialization function. This function is called once at the creation of every particle for every property to initialize its value.
[in] | position | The current particle position. |
[in,out] | particle_properties | The properties of the particle that is initialized within the call of this function. The purpose of this function should be to extend this vector by a number of properties. |
Reimplemented in aspect::Particle::Property::IntegratorProperties< dim >, aspect::Particle::Property::ElasticTensorDecomposition< dim >, aspect::Particle::Property::CrystalPreferredOrientation< dim >, aspect::Particle::Property::CpoBinghamAverage< dim >, aspect::Particle::Property::CpoElasticTensor< dim >, aspect::Particle::Property::PTPath< dim >, aspect::Particle::Property::GrainSize< dim >, aspect::Particle::Property::ViscoPlasticStrainInvariant< dim >, aspect::Particle::Property::Function< dim >, aspect::Particle::Property::IntegratedStrain< dim >, aspect::Particle::Property::MeltParticle< dim >, aspect::Particle::Property::Composition< dim >, aspect::Particle::Property::ElasticStress< dim >, aspect::Particle::Property::IntegratedStrainInvariant< dim >, aspect::Particle::Property::InitialComposition< dim >, aspect::Particle::Property::InitialPosition< dim >, aspect::Particle::Property::StrainRate< dim >, aspect::Particle::Property::Velocity< dim >, aspect::Particle::Property::Position< dim >, and aspect::Particle::Property::ReferencePosition< dim >.
|
virtual |
Update function. This function is called every time an update is requested by need_update() for every cell for every property. It is expected to update the properties of all particles in the given range particles
, which are all in one cell. It is obvious that this function is called a lot, so its code should be efficient. The interface provides a default implementation that does nothing, therefore derived plugins that do not require an update do not need to implement this function.
[in] | inputs | A struct of type ParticleUpdateInputs that contains all necessary inputs to compute the particle updates. See the documentation of this struct in include/aspect/particle/property/interface.h for a list of all available inputs. |
[in,out] | particles | The particles that are to be updated within this function. |
Reimplemented in aspect::Particle::Property::ElasticTensorDecomposition< dim >, aspect::Particle::Property::CrystalPreferredOrientation< dim >, aspect::Particle::Property::CpoBinghamAverage< dim >, aspect::Particle::Property::CpoElasticTensor< dim >, aspect::Particle::Property::PTPath< dim >, aspect::Particle::Property::GrainSize< dim >, aspect::Particle::Property::ViscoPlasticStrainInvariant< dim >, aspect::Particle::Property::IntegratedStrain< dim >, aspect::Particle::Property::MeltParticle< dim >, aspect::Particle::Property::Composition< dim >, aspect::Particle::Property::ElasticStress< dim >, aspect::Particle::Property::IntegratedStrainInvariant< dim >, aspect::Particle::Property::StrainRate< dim >, aspect::Particle::Property::Velocity< dim >, aspect::Particle::Property::Position< dim >, and aspect::Particle::Property::ReferencePosition< dim >.
|
virtual |
Update function. This function is called every time an update is request by need_update() for every particle for every property. It is obvious that this function is called a lot, so its code should be efficient. The interface provides a default implementation that does nothing, therefore derived plugins that do not require an update do not need to implement this function.
[in] | data_position | An unsigned integer that denotes which component of the particle property vector is associated with the current property. For properties that own several components it denotes the first component of this property, all other components fill consecutive entries in the particle_properties vector. |
[in] | solution | The values of the solution variables at the current particle position. |
[in] | gradients | The gradients of the solution variables at the current particle position. |
[in,out] | particle | The particle that is updated within the call of this function. The particle location can be accessed using particle->get_location() and its properties using particle->get_properties(). |
|
virtual |
Returns an enum, which determines at what times particle properties are updated. The default implementation returns update_never, which signals that particle properties should never be updated. See the documentation of UpdateTimeFlags for a list of possible values and examples for their use. Every plugin that implements this function should return the value appropriate for its purpose, unless it does not need any update, which is the default. This option saves considerable computation time in cases, when no plugin needs to update particle properties over time.
Reimplemented in aspect::Particle::Property::ElasticTensorDecomposition< dim >, aspect::Particle::Property::CrystalPreferredOrientation< dim >, aspect::Particle::Property::CpoBinghamAverage< dim >, aspect::Particle::Property::CpoElasticTensor< dim >, aspect::Particle::Property::GrainSize< dim >, aspect::Particle::Property::PTPath< dim >, aspect::Particle::Property::ViscoPlasticStrainInvariant< dim >, aspect::Particle::Property::IntegratedStrain< dim >, aspect::Particle::Property::MeltParticle< dim >, aspect::Particle::Property::Composition< dim >, aspect::Particle::Property::IntegratedStrainInvariant< dim >, aspect::Particle::Property::ElasticStress< dim >, aspect::Particle::Property::StrainRate< dim >, aspect::Particle::Property::Velocity< dim >, aspect::Particle::Property::Position< dim >, and aspect::Particle::Property::ReferencePosition< dim >.
|
virtual |
Return which data has to be provided to update all properties. Note that particle properties can only ask for update_default (no data), update_values (solution values), and update_gradients (solution gradients). All other update flags will have no effect.
Reimplemented in aspect::Particle::Property::CrystalPreferredOrientation< dim >, aspect::Particle::Property::CpoBinghamAverage< dim >, aspect::Particle::Property::CpoElasticTensor< dim >, aspect::Particle::Property::GrainSize< dim >, aspect::Particle::Property::PTPath< dim >, aspect::Particle::Property::IntegratedStrain< dim >, aspect::Particle::Property::MeltParticle< dim >, aspect::Particle::Property::ViscoPlasticStrainInvariant< dim >, aspect::Particle::Property::Composition< dim >, aspect::Particle::Property::IntegratedStrainInvariant< dim >, aspect::Particle::Property::StrainRate< dim >, aspect::Particle::Property::ElasticStress< dim >, and aspect::Particle::Property::Velocity< dim >.
|
virtual |
Returns an enum, which determines how this particle property is initialized for particles that are created later than the initial particle generation, e.g. to balance the particle load or prevent empty cells. The default implementation returns interpolate, which will use the particle interpolator to set the new particle properties to a value that is interpolated from the other particles in the cell. See the documentation of InitializationModeForLateParticles for a list of possible values and examples for their use. Every plugin that implements this function should return the value appropriate for its purpose, unless it wants to use the default value.
Reimplemented in aspect::Particle::Property::CrystalPreferredOrientation< dim >, aspect::Particle::Property::GrainSize< dim >, and aspect::Particle::Property::InitialComposition< dim >.
|
pure virtual |
Set up the information about the names and number of components this property requires. Derived classes need to implement this function.
The purpose of this function is to return a vector of pairs of a property name and the number of components associated with this name (e.g. 1 for scalar properties, n for n-dimensional vectors).
Implemented in aspect::Particle::Property::IntegratorProperties< dim >, aspect::Particle::Property::ElasticTensorDecomposition< dim >, aspect::Particle::Property::CrystalPreferredOrientation< dim >, aspect::Particle::Property::CpoBinghamAverage< dim >, aspect::Particle::Property::CpoElasticTensor< dim >, aspect::Particle::Property::PTPath< dim >, aspect::Particle::Property::GrainSize< dim >, aspect::Particle::Property::IntegratedStrain< dim >, aspect::Particle::Property::MeltParticle< dim >, aspect::Particle::Property::Composition< dim >, aspect::Particle::Property::IntegratedStrainInvariant< dim >, aspect::Particle::Property::StrainRate< dim >, aspect::Particle::Property::Velocity< dim >, aspect::Particle::Property::ViscoPlasticStrainInvariant< dim >, aspect::Particle::Property::ElasticStress< dim >, aspect::Particle::Property::Position< dim >, aspect::Particle::Property::ReferencePosition< dim >, aspect::Particle::Property::InitialComposition< dim >, aspect::Particle::Property::Function< dim >, and aspect::Particle::Property::InitialPosition< dim >.
|
virtual |
Set the position of this property in the particle property vector.
|
virtual |
Get the position of this property in the particle property vector.
|
protected |
Store the position of the particle property in the particle property vector. If the property has multiple components, the first component is stored and all other components are stored consecutively after the first one.
Definition at line 504 of file interface.h.