fix insert/stream/regionfill command

Warning

This command is deprecated, please use the insertion command instead.

Syntax

fix ID group-ID insert/stream/regionfill seed seed_value distributiontemplate dist-ID general_keywords general_values stream_keywords stream_values regionfill_keywords regionfill_values  ...

• ID, group-ID are documented in fix command

• insert/stream/regionfill = style name of this fix command

• seed, seed_value are documented in fix insert/stream command

• distributiontemplate, dist-ID are documented in fix insert/stream command

• one or more general keyword/value pairs can be appended

• general_keywords / general values are documented in fix insert/stream command

• stream_keywords / stream_values are documented in fix insert/stream command

• following the stream keyword/value section, one or more regionfill keyword/value pairs can be appended for the fix insert/stream command

• stream_keywords = duration or parallel or insertion_face or extrude_length

region value = region-ID
  region-ID = ID of the region where filling should be obtained
volumefraction_region values = vol
  vol =  desired volume fraction for the region (positive float, 0 < vol < 1)
particles_in_region values = np
  np =  desired number of particles in the region (positive integer)
mass_in_region values = m
  m =  desired mass in the region (positive float, m > 0)
ntry_mc values = n
  n = number of Monte-Carlo steps for calculating the region's volume  (positive integer)

Examples

fix ins nve_group insert/stream/regionfill seed 123457 distributiontemplate pdd1 maxattempt 100 mass 30. massrate 30. overlapcheck yes vel constant 0. 0. -1.0 insertion_face inface extrude_length 0.1          region fillreg particles_in_region 10

Description

Insert particles into a granular run either once or every few timesteps within a specified region until either np particles have been inserted or the desired particle mass (mp) has been reached.

This command is a variant of the fix insert/stream command. Additionally, fix insert/stream/regionfill will stop insertion as soon as a certain insertion target within a region is reached. The target can be either a region volume fraction (keyword volumefraction_region), the total number of particles in the region (keyword particles_in_region), or the total particle mass in the region (keyword mass_in_region). Exactly one out of the keywords volumefraction_region, particles_in_region, mass_in_region must be defined.

Warning

The above-mentioned keyword particles_in_region, does apply to the number of particle templates / particle conglomerates in case of using multisphere of multiplespheres templates, not to single spheres.

If this target is met, no insertion takes place. Additionally, all particles which have been inserted by this fix after the “oldest” particle within the target region insert by this fix, is deleted.

The ntry_mc keyword is used to control the number of MC tries that are used for the volume calculation.

Restart, fix_modify, output, run start/stop

Information about this fix is written to binary restart files. This means you can restart a simulation simulation while inserting particles, when the restart file was written during the insertion operation.

None of the fix_modify options are relevant to this fix. A global vector is stored by this fix for access by various output commands. The first component of the vector is the number of particles already inserted, the second component is the mass of particles already inserted. No parameter of this fix can be used with the start/stop keywords of the run command.

Restrictions

Only one fix insert/stream can be used if this fix is used Other restrictions documented in fix insert/stream command

Related commands

fix_insert_pack, fix_insert_rate_region

Default

Documented in fix insert/stream command