FluidSource Custom Task - Revision history

Nairnj: /* Introduction */

2023-01-14T16:07:18Z

Introduction

← Older revision		Revision as of 16:07, 14 January 2023
Line 3:		Line 3:
	== Introduction ==		== Introduction ==

	The <tt>FluidSource</tt> custom task injects particles at a specified rate from a defined inlet ~~(currently in [[OSParticulas]] only)~~. Its main use of for injecting [[#Hyperelastic Materials\|liquid or liquid-like particles]] such as a [[Tait Liquid Material\|Tait liquid]]. While it can be used with other materials, the injection process does not work well unless the injected material clears out of the inlet region in time for the next injected particles.		The <tt>FluidSource</tt> custom task injects particles at a specified rate from a defined inlet. Its main use of for injecting [[#Hyperelastic Materials\|liquid or liquid-like particles]] such as a [[Tait Liquid Material\|Tait liquid]]. While it can be used with other materials, the injection process does not work well unless the injected material clears out of the inlet region in time for the next injected particles.

	== Task Scheduling ==		== Task Scheduling ==

Nairnj: /* Task Action */

2021-07-22T19:34:47Z

Task Action

← Older revision		Revision as of 19:34, 22 July 2021
Line 88:		Line 88:
	Each time step checks the injection location and current flow rate. If enough time has passed since the last row of particles was injected, a new row of particles is injected into the simulation.		Each time step checks the injection location and current flow rate. If enough time has passed since the last row of particles was injected, a new row of particles is injected into the simulation.

	In addition, this simulation will check for any particles in a region ahead of the pipe with the same cross-sectional area as the pipe and a length normal to the pipe of one grid cell. Any particle in that region will have their velocities set equal to the current flow rate. This action is effectively providing a velocity boundary condition to a small region ahead of the pipe. Once out of that region, the particles are within the simulation. If ~~particle~~ get blocked once leaving that region, the injection process might ~~get clogged~~.		In addition, this simulation will check for any particles in a region ahead of the pipe with the same cross-sectional area as the pipe and a length normal to the pipe of one grid cell. Any particle in that region will have their velocities set equal to the current flow rate. This action is effectively providing a velocity boundary condition to a small region ahead of the pipe. Once out of that region, the particles are within the simulation. If particles get blocked once leaving that region, the injection process might not work well.

	== Notes ==		== Notes ==

Nairnj: /* Task Action */

2021-07-22T19:34:03Z

Task Action

← Older revision		Revision as of 19:34, 22 July 2021
Line 88:		Line 88:
	Each time step checks the injection location and current flow rate. If enough time has passed since the last row of particles was injected, a new row of particles is injected into the simulation.		Each time step checks the injection location and current flow rate. If enough time has passed since the last row of particles was injected, a new row of particles is injected into the simulation.

	In addition, this simulation will check for any particles in a region ahead of the pipe with the same cross-~~section~~ area as the pipe and a length normal to the pipe of one grid cell. Any particle in that region will have their velocities set equal to the current flow rate. This action is effectively providing a velocity boundary condition to a small region ahead of the pipe. Once out of that region, the particles are within the simulation. If particle get blocked once leaving that region, the injection process might get clogged.		In addition, this simulation will check for any particles in a region ahead of the pipe with the same cross-sectional area as the pipe and a length normal to the pipe of one grid cell. Any particle in that region will have their velocities set equal to the current flow rate. This action is effectively providing a velocity boundary condition to a small region ahead of the pipe. Once out of that region, the particles are within the simulation. If particle get blocked once leaving that region, the injection process might get clogged.

	== Notes ==		== Notes ==

Nairnj: /* Injected Particle Size */

2021-07-22T19:33:41Z

Injected Particle Size

← Older revision		Revision as of 19:33, 22 July 2021
Line 82:		Line 82:
	where		where

	* <tt>(scaleSize)</tt> - specifies relative particle size compared to the ~~simulations number of~~ particle per cell (default is 1).		* <tt>(scaleSize)</tt> - specifies relative particle size compared to the simulation's default particle per cell (default is 1).

	== Task Action ==		== Task Action ==

Nairnj: /* Injected Particle Size */

2021-07-22T19:33:00Z

Injected Particle Size

← Older revision		Revision as of 19:33, 22 July 2021
Line 72:		Line 72:
	=== Injected Particle Size ===		=== Injected Particle Size ===

	By default, the injected particle size will be the same as the default particle size for the current simulation (~~see~~ [[MPM Methods and Simulation Timing#Input Commands\|<tt>PtsPerElement</tt> command]]). If desired, that size can be changed with the following addition to scripted files		By default, the injected particle size will be the same as the default particle size for the current simulation (as set using the [[MPM Methods and Simulation Timing#Input Commands\|<tt>PtsPerElement</tt> command]]). If desired, that size can be changed with the following addition to scripted files

	Parameter particle_scale,(scaleSize)		Parameter particle_scale,(scaleSize)

Nairnj: /* Defining the Injection Pipe */

2021-07-22T17:56:16Z

Defining the Injection Pipe

← Older revision		Revision as of 17:56, 22 July 2021
Line 68:		Line 68:

	* <tt>(xSrc),(ySrc),(zSrc)</tt> - specify a point at the center of the pipe (only x and y coordinates needed in 2D).		* <tt>(xSrc),(ySrc),(zSrc)</tt> - specify a point at the center of the pipe (only x and y coordinates needed in 2D).
	* <tt>(width)</tt> and <tt>(depth)</tt> - specifies the cross-~~section~~ area of the rectangular pipe. In 2D, only <tt>(wdith)</tt> is needed and the depth of the pipe is the thickness of the 2D simulation. In 3D, the rectangle axes are aligned with the non-normal axes (''e.g.'', for flow in x direction, width and depth are in the y and z directions, ''etc.'').		* <tt>(width)</tt> and <tt>(depth)</tt> - specifies the cross-sectional area of the rectangular pipe. In 2D, only <tt>(wdith)</tt> is needed and the depth of the pipe is the thickness of the 2D simulation. In 3D, the rectangle axes are aligned with the non-normal axes (''e.g.'', for flow in x direction, width and depth are in the y and z directions, ''etc.'').

	=== Injected Particle Size ===		=== Injected Particle Size ===

Nairnj: /* Defining the Injection Pipe */

2021-07-22T17:55:59Z

Defining the Injection Pipe

← Older revision		Revision as of 17:55, 22 July 2021
Line 68:		Line 68:

	* <tt>(xSrc),(ySrc),(zSrc)</tt> - specify a point at the center of the pipe (only x and y coordinates needed in 2D).		* <tt>(xSrc),(ySrc),(zSrc)</tt> - specify a point at the center of the pipe (only x and y coordinates needed in 2D).
	* <tt>(width)</tt> and <tt>(depth)</tt> - ~~specify~~ the cross-section area of the rectangular pipe. In 2D, only <tt>(wdith)</tt> is needed and the depth of the pipe is the thickness of the 2D simulation. In 3D, the rectangle axes are aligned with the non-normal axes (''e.g.'', for flow in x direction, width and depth are in the y and z directions, ''etc.'').		* <tt>(width)</tt> and <tt>(depth)</tt> - specifies the cross-section area of the rectangular pipe. In 2D, only <tt>(wdith)</tt> is needed and the depth of the pipe is the thickness of the 2D simulation. In 3D, the rectangle axes are aligned with the non-normal axes (''e.g.'', for flow in x direction, width and depth are in the y and z directions, ''etc.'').

	=== Injected Particle Size ===		=== Injected Particle Size ===

Nairnj: /* Defining the Injection Pipe */

2021-07-22T17:55:46Z

Defining the Injection Pipe

← Older revision		Revision as of 17:55, 22 July 2021
Line 67:		Line 67:
	where		where

	* <tt>(xSrc),(ySrc),(zSrc)</tt> - specify a point at the center of the pipe (or x and y coordinates needed in 2D).		* <tt>(xSrc),(ySrc),(zSrc)</tt> - specify a point at the center of the pipe (only x and y coordinates needed in 2D).
	* <tt>(width)</tt> and <tt>(depth)</tt> - specify the cross-section area of the rectangular pipe. In 2D, only <tt>(wdith)</tt> is needed and the depth of the pipe is the thickness of the 2D simulation. In 3D, the rectangle axes are aligned with the non-normal axes (''e.g.'', for flow in x direction, width and depth are in the y and z directions, ''etc.'').		* <tt>(width)</tt> and <tt>(depth)</tt> - specify the cross-section area of the rectangular pipe. In 2D, only <tt>(wdith)</tt> is needed and the depth of the pipe is the thickness of the 2D simulation. In 3D, the rectangle axes are aligned with the non-normal axes (''e.g.'', for flow in x direction, width and depth are in the y and z directions, ''etc.'').

Nairnj: /* Setting Injection Rate */

2021-07-22T17:55:00Z

Setting Injection Rate

← Older revision		Revision as of 17:55, 22 July 2021
Line 45:		Line 45:

	* <tt>(rate)</tt> or <tt>(rateFxn)</tt> - specifies the inject rate in [[ConsistentUnits Command#Legacy and Consistent Units\|(length units)<sup>3</sup>]] per [[ConsistentUnits Command#Legacy and Consistent Units\|time unit]]. The <tt>(rate)</tt> option specifies a fixed and constant rate while <tt>(rateFxn)</tt> can provide a variable rate as a [[User Defined Functions\|user-defined function]] of time. If both are provided, the <tt>(rateFxn)</tt> takes precedence.		* <tt>(rate)</tt> or <tt>(rateFxn)</tt> - specifies the inject rate in [[ConsistentUnits Command#Legacy and Consistent Units\|(length units)<sup>3</sup>]] per [[ConsistentUnits Command#Legacy and Consistent Units\|time unit]]. The <tt>(rate)</tt> option specifies a fixed and constant rate while <tt>(rateFxn)</tt> can provide a variable rate as a [[User Defined Functions\|user-defined function]] of time. If both are provided, the <tt>(rateFxn)</tt> takes precedence.
	* <tt>(xNorm),(yNorm),(zNorm)</tt> - provide three components to a normal vector in the direction of flow (the vector need not be normalized). In 2D, <tt>(xNorm)</tt> and <tt>(yNorm)</tt> can be in any direction. In 3D, the injection is currently limited being along the x, y, or z axis, which means only one component can be nonzero (all components default to zero, so just specify one non-zero value; if none are specified, 3D injection is in the z direction).		* <tt>(xNorm),(yNorm),(zNorm)</tt> - provide three components to a normal vector in the direction of flow (the vector need not be normalized). In 2D, <tt>(xNorm)</tt> and <tt>(yNorm)</tt> can be in any direction. In 3D, the injection is currently limited being along the x, y, or z axis, which means only one component can be nonzero (all components default to zero, so just specify the one non-zero value; if none are specified, 3D injection will be in the z direction).

	=== Defining the Injection Pipe ===		=== Defining the Injection Pipe ===

Nairnj: /* Setting Injection Rate */

2021-07-22T17:54:06Z

Setting Injection Rate

← Older revision		Revision as of 17:54, 22 July 2021
Line 44:		Line 44:
	where		where

	* <tt>(rate)</tt> or <tt>(rateFxn)</tt> - specifies the inject ~~rates~~ in [[ConsistentUnits Command#Legacy and Consistent Units\|(length units)<sup>3</sup>]] per [[ConsistentUnits Command#Legacy and Consistent Units\|time unit]]. The <tt>(rate)</tt> option specifies a fixed and constant rate while <tt>(rateFxn)</tt> can provide a variable rate as a [[User Defined Functions\|user-defined function]] of time. If both are provided, the <tt>(rateFxn)</tt> takes precedence.		* <tt>(rate)</tt> or <tt>(rateFxn)</tt> - specifies the inject rate in [[ConsistentUnits Command#Legacy and Consistent Units\|(length units)<sup>3</sup>]] per [[ConsistentUnits Command#Legacy and Consistent Units\|time unit]]. The <tt>(rate)</tt> option specifies a fixed and constant rate while <tt>(rateFxn)</tt> can provide a variable rate as a [[User Defined Functions\|user-defined function]] of time. If both are provided, the <tt>(rateFxn)</tt> takes precedence.
	* <tt>(xNorm),(yNorm),(zNorm)</tt> - provide three components to a normal vector in the direction of flow (the vector need not be normalized). In 2D, <tt>(xNorm)</tt> and <tt>(yNorm)</tt> can be in any direction. In 3D, the injection is currently limited being along the x, y, or z axis, which means only one component can be nonzero (all components default to zero, so just specify one non-zero value; if none are specified, 3D injection is in the z direction).		* <tt>(xNorm),(yNorm),(zNorm)</tt> - provide three components to a normal vector in the direction of flow (the vector need not be normalized). In 2D, <tt>(xNorm)</tt> and <tt>(yNorm)</tt> can be in any direction. In 3D, the injection is currently limited being along the x, y, or z axis, which means only one component can be nonzero (all components default to zero, so just specify one non-zero value; if none are specified, 3D injection is in the z direction).