Material Point Reservoir - Revision history

Nairnj at 16:21, 14 January 2023

2023-01-14T16:21:05Z

← Older revision		Revision as of 16:21, 14 January 2023
Line 4:		Line 4:
	Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.		Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.

	The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles at some fixed rate at a predetermined location. The development of new reservoir features can be done by [[Writing a Custom Task\|writing new custom tasks]] and using [[#Adding Reservoir Methods to a Custom Task\|~~reservioud metods~~ defined below]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.		The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles at some fixed rate at a predetermined location. The development of new reservoir features can be done by [[Writing a Custom Task\|writing new custom tasks]] and using [[#Adding Reservoir Methods to a Custom Task\|reservoir methods defined below]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.

	== Deleting Particles ==		== Deleting Particles ==

Nairnj at 16:20, 14 January 2023

2023-01-14T16:20:42Z

← Older revision		Revision as of 16:20, 14 January 2023
Line 4:		Line 4:
	Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.		Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.

	The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles at some fixed rate at a predetermined location. The development of new reservoir features can be done by [[Writing a Custom Task\|writing new custom tasks]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.		The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles at some fixed rate at a predetermined location. The development of new reservoir features can be done by [[Writing a Custom Task\|writing new custom tasks]] and using [[#Adding Reservoir Methods to a Custom Task\|reservioud metods defined below]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.

	== Deleting Particles ==		== Deleting Particles ==

Nairnj: /* Introduction */

2023-01-14T16:18:49Z

Introduction

← Older revision		Revision as of 16:18, 14 January 2023
Line 4:		Line 4:
	Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.		Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.

	The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles ~~are~~ some fixed rate ~~and~~ a predetermined location. The development of new reservoir features can be done by ~~writing new~~ [[~~MPM_Input_Files#~~Custom ~~Tasks~~\|custom tasks]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.		The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles at some fixed rate at a predetermined location. The development of new reservoir features can be done by [[Writing a Custom Task\|writing new custom tasks]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.

	== Deleting Particles ==		== Deleting Particles ==

Nairnj: /* Introduction */

2023-01-14T16:17:33Z

Introduction

← Older revision		Revision as of 16:17, 14 January 2023
Line 4:		Line 4:
	Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.		Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.

	The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). ~~For most simulations, the~~ reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other ~~features~~ are ~~typcially~~ implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource]] ~~custom tasks~~ can inject particles are some fixed rate. The development of new features can be done by writing new [[MPM_Input_Files#Custom Tasks\|custom tasks]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.		The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). The reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other reservour options are typically implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource Custom Task]] can inject particles are some fixed rate and a predetermined location. The development of new reservoir features can be done by writing new [[MPM_Input_Files#Custom Tasks\|custom tasks]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.

	== Deleting Particles ==		== Deleting Particles ==

Nairnj: /* Introduction */

2023-01-14T16:15:51Z

Introduction

← Older revision		Revision as of 16:15, 14 January 2023
Line 4:		Line 4:
	Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.		Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.

	The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). For most simulations, the reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. ~~Some~~ features ~~(which currently~~ are ~~only~~ in [[MPM_Input_Files#Custom Tasks\|custom tasks]]) can inject particles ~~into the simulation~~. ~~To use any such~~ custom tasks, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles type needed for that task.		The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). For most simulations, the reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Other features are typcially implemented in [[MPM_Input_Files#Custom Tasks\|custom tasks]]. For example the [[FluidSource]] custom tasks can inject particles are some fixed rate. The development of new features can be done by writing new [[MPM_Input_Files#Custom Tasks\|custom tasks]]. When a [[MPM_Input_Files#Custom Tasks\|custom task]] might inject particles, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles of the type needed for that task.

	== Deleting Particles ==		== Deleting Particles ==

Nairnj: /* Introduction */

2023-01-14T16:13:14Z

Introduction

← Older revision		Revision as of 16:13, 14 January 2023
Line 2:		Line 2:
	== Introduction ==		== Introduction ==

	~~Simulations~~ in NairnMPM ~~are currently~~ limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points~~. This reservoir is currently only implemented in [[OSParticulas]] but will be moved to NairnMPM soon~~.		Standard simulations in NairnMPM ar limited to a fixed number of particles. To allow for simulation options that delete particles or inject particles, the code implements a reservoir of material points.

	The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). For most simulations, the reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Some features (which currently are only in [[MPM_Input_Files#Custom Tasks\|custom tasks]]) can inject particles into the simulation. To use any such custom tasks, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles type needed for that task.		The reservoir is created automatically for all simulations (unless you are using an [[Explicit FEA Mesh Generation#Explicit MPM Grid\|unstructured grid]], which is uncommon because many features are lost for such grids). For most simulations, the reservoir handles all options that might [[#Deleting Particles\|delete particles]] and happens automatically without your input commands needing extra commands to set reservoir properties. Some features (which currently are only in [[MPM_Input_Files#Custom Tasks\|custom tasks]]) can inject particles into the simulation. To use any such custom tasks, your input commands should [[#Fill the Reservoir\|pre-fill the reservoir]] with particles type needed for that task.

Nairnj: /* Changing a Particle Size */

2022-01-01T00:33:43Z

Changing a Particle Size

← Older revision		Revision as of 00:33, 1 January 2022
Line 112:		Line 112:

	where <tt>mptr</tt> is pointer to the material point and <tt>lpart</tt> is the new absolute size. The reason to use this method is to change size without changing other material point properties. This method handles re-scaling of the mass, changing the size, and writing information to the <tt>PtDims.txt</tt> results file. Your custom task is responsible for determining that the size change does not cause numerical artifacts. For example, the size change might need to go along with changes to other particle properties. '''Warning''': Although this method can be used in any type of parallel block, to avoid potential race conditions saving information about particle size changes, it should be called in an OpenMP critical block:		where <tt>mptr</tt> is pointer to the material point and <tt>lpart</tt> is the new absolute size. The reason to use this method is to change size without changing other material point properties. This method handles re-scaling of the mass, changing the size, and writing information to the <tt>PtDims.txt</tt> results file. Your custom task is responsible for determining that the size change does not cause numerical artifacts. For example, the size change might need to go along with changes to other particle properties. '''Warning''': Although this method can be used in any type of parallel block, to avoid potential race conditions saving information about particle size changes, it should be called in an OpenMP critical block:

			// Change size only in single thread
			#pragma omp critical (reservoir)
			{
			mpmReservoir->ChangeParticleSize(mptr,&lp);
			}

Nairnj: /* Changing a Particle Size */

2022-01-01T00:32:55Z

Changing a Particle Size

← Older revision		Revision as of 00:32, 1 January 2022
Line 111:		Line 111:
	mpmReservoir->ChangeParticleSize(MPMBase mptr,Vector lpart)		mpmReservoir->ChangeParticleSize(MPMBase mptr,Vector lpart)

	where <tt>mptr</tt> is pointer to the material point and <tt>lpart</tt> is the new absolute size. The reason to use this method is to change size without changing other material point properties. This method handles re-scaling of the mass, changing the size, and writing information to the <tt>PtDims.txt</tt> results file. Your custom task is responsible for determining that the size change does not cause numerical artifacts. For example, the size change might need to go along with changes to other particle properties. ~~This~~ method ~~is thread safe.~~		where <tt>mptr</tt> is pointer to the material point and <tt>lpart</tt> is the new absolute size. The reason to use this method is to change size without changing other material point properties. This method handles re-scaling of the mass, changing the size, and writing information to the <tt>PtDims.txt</tt> results file. Your custom task is responsible for determining that the size change does not cause numerical artifacts. For example, the size change might need to go along with changes to other particle properties. '''Warning''': Although this method can be used in any type of parallel block, to avoid potential race conditions saving information about particle size changes, it should be called in an OpenMP critical block:

Nairnj: /* Changing a Particle Size */

2022-01-01T00:30:06Z

Changing a Particle Size

← Older revision		Revision as of 00:30, 1 January 2022
Line 111:		Line 111:
	mpmReservoir->ChangeParticleSize(MPMBase mptr,Vector lpart)		mpmReservoir->ChangeParticleSize(MPMBase mptr,Vector lpart)

	where <tt>mptr</tt> is pointer to the material point and <tt>lpart</tt> is the new absolute size. The reason to use this method is to change size without changing other material point properties. This method handles re-scaling of the mass, changing the size, and writing information to the <tt>PtDims.txt</tt> results file. Your custom task is responsible for determining that the size change does not cause numerical artifacts. For example, the size change might need to go along with changes to other particle properties.		where <tt>mptr</tt> is pointer to the material point and <tt>lpart</tt> is the new absolute size. The reason to use this method is to change size without changing other material point properties. This method handles re-scaling of the mass, changing the size, and writing information to the <tt>PtDims.txt</tt> results file. Your custom task is responsible for determining that the size change does not cause numerical artifacts. For example, the size change might need to go along with changes to other particle properties. This method is thread safe.

Nairnj: /* Delete a Particle */

2022-01-01T00:29:39Z

Delete a Particle

← Older revision		Revision as of 00:29, 1 January 2022
Line 85:		Line 85:
	mpmReservoir->DeleteParticle(MPMBase *mpmptr)		mpmReservoir->DeleteParticle(MPMBase *mpmptr)

	where <tt>mpmptr</tt> is pointer to material point to be deleted. All properties of the particle will be reset to initial conditions. If needed, the particle size will be changed to match size for a list in the reservoir. If size is changed, the mass will be rescaled and information will be written to the <tt>PtDims.txt</tt> results file. Warning: see instructions on [[#Parallel Coding\|parallel coding]] when this method is needed in a block of parallel code.		where <tt>mpmptr</tt> is pointer to material point to be deleted. All properties of the particle will be reset to initial conditions. If needed, the particle size will be changed to match size for a list in the reservoir. If size is changed, the mass will be rescaled and information will be written to the <tt>PtDims.txt</tt> results file. '''Warning''': see instructions on [[#Parallel Coding\|parallel coding]] when this method is needed in a block of parallel code.

	=== Parallel Coding ===		=== Parallel Coding ===