insertion mode spray_nozzle command

Purpose

insertion mode spray_nozzle is used to generate a spray nozzles that emit lagrangian particles (examples).

Syntax

insertion mode spray_nozzle keyword value

General insertion keywords are documented here. This document only describes the specific keywords for the insertion of a lagrangian spray.

Return to the insertion documentation.

Keywords

Description

target_mass
desired mass to insert
range: (0,∞); units: [mass]

nozzle_shape
obligatory, shape through which the particles should be inserted, allowed values are: cone, cylinder
pyramid, elliptic_cylinder, elliptic_cone
The nozzle_shape keyword requires arguments that depend on its value, details please see here.

center_of_nozzle
obligatory vector with center coordinates of the nozzle
units: [length]

massrate
mass insertion rate
range: (0,∞); units: [mass/time]

spray_temperature
temperature of spray to insert; if not provided the initial temperature set in enable_heat_transfer is used
range: (0,∞); units: [temperature]

duration_time
duration of each insertion moment (insert_every_time) in time units
range: (0,`insert_every_time`); units: [time]

volume_limit
minimal volume of the insertion region used for sanity checks
range: (0,∞); units: [distance^3]

Examples

insertion mode spray_nozzle particle_distribution sprayDist massrate 0.1  velocity constant (0.3, 0, -1.5) &
     nozzle_shape cylinder outer_nozzle_radius 2e-3 center_of_nozzle (0, 0, 0)

insertion mode spray_nozzle particle_distribution sprayDist massrate 0.1 velocity constant (0.1, 0, -1) &
     nozzle_shape cone outer_cone_angle 120 outer_nozzle_radius 3e-2 center_of_nozzle (-0.2, 0, -0.1)

insertion mode spray_nozzle particle_distribution sprayDist target_mass 1 massrate 0.1 &
     insert_every_time 1e-2 velocity constant (0.1, 0, -1) nozzle_shape cone outer_cone_angle 90 &
     inner_cone_angle 40 outer_nozzle_radius 3e-2 inner_nozzle_radius 1e-2 center_of_nozzle (-0.2, 0, -0.1)

insertion mode spray_nozzle particle_distribution sprayDist massrate 1e-5 spray_temperature 500 &
     velocity constant (0.5, 0, -0.5) nozzle_shape cone outer_cone_angle 90 &
     inner_cone_angle 40 outer_nozzle_radius 3e-2 inner_nozzle_radius 1e-2 center_of_nozzle (-0.2, 0, -0.1) id insSpray

insertion mode spray_nozzle particle_distribution sprayDist massrate 0.1 velocity constant (0.1, 0, -1) &
     nozzle_shape pyramid pyramid_x_axis (1, 0, 0) pyramid_x_length 0.1 pyramid_y_length 0.2 &
     pyramid_x_angle 45 pyramid_y_angle 0 center_of_nozzle (-0.2, 0, -0.1)

insertion mode spray_nozzle particle_distribution sprayDist massrate 2e-3 velocity constant (0, -1, -1) &
     nozzle_shape elliptic_cylinder ellipsoid_x_axis (1, 0, 1) center_of_nozzle (-0.2, 0, -0.1) &
     outer_nozzle_x_radius 2.5e-2 outer_nozzle_y_radius 1.3e-2

insertion mode spray_nozzle particle_distribution sprayDist target_mass 1 massrate 0.1 &
     insert_every_time 1e-2 velocity constant (0.1, 0, -1) nozzle_shape elliptic_cone &
     ellipsoid_x_axis (1, 0, 1) center_of_nozzle (-0.2, 0, -0.1) outer_cone_x_angle 90 inner_cone_x_angle 40 &
     outer_cone_y_angle 20 inner_cone_y_angle 0 outer_nozzle_x_radius 4e-2 inner_nozzle_x_radius 1e-2 &
     outer_nozzle_y_radius 3e-2 inner_nozzle_y_radius 1e-2

variable myMassrate equal ramp(0.1,0.15)
insertion mode spray_nozzle particle_distribution sprayDist massrate v_myMassrate velocity constant (0.1, 0, -1) &
     nozzle_shape cone outer_cone_angle 90 outer_nozzle_radius 3e-2 center_of_nozzle (0, 0, 0)

insertion mode spray_nozzle particle_distribution sprayDist massrate 0.1  insert_every_time 1e-2 &
     velocity constant (0.3, 0, -1.5) nozzle_shape cylinder outer_nozzle_radius 2e-3 center_of_nozzle (0, 0, 0) &
     duration_time 5e-3

insertion mode spray_nozzle particle_distribution sprayDist massrate 0.1 velocity constant (0.3, 0, -1.5) &
     nozzle_shape cylinder outer_nozzle_radius 2e-3 center_of_nozzle (0, 0, 0) volume_limit 1e-18

insertion mode spray_nozzle particle_distribution sprayDist massrate 0.1 velocity constant (0.3, 0, -1.5) &
     nozzle_shape cylinder outer_nozzle_radius 2e-3 center_of_nozzle (0, 0, 0) id sprayIns
mesh_module motion id moveNozzle linear velocity (1, 0, 0) meshes {insertion_face_sprayIns}

Description

The spray_nozzle insertion command generates a stream of lagrangian droplets. The used material and its properties have to be defined in a specific way, please have a look at the droplet material tutorial for more details.

The insertion face is represented by a nozzle having a center set by the center_of_nozzle keyword and orientation set by the velocity keyword. Information about available nozzle_shape types and their keywords can be found here. The internally generated insertion face gets the id “insertion_face_${insertion_command_id}”. For generating moving nozzles just apply a mesh motion module to this face.

The keyword target_mass can be used to set the total material amount that is inserted. Once the defined mass is reached, the spray stops. The mass rate is specified via the mass_rate keyword.

It is possible to define the duration of each insertion moment (length of insertion moment is defined by insert_every_time) via the duration_time keyword. This also requires an explicit definition of the insert_every_time keyword. The duration_time value must be lower than the insert_every_time value. This results in a pulsed instead of a continuous stream.

The particle property that counts the number of tags of a particular material is called “f_” + id + “_tag”, and similarly id + “_tag” for the mesh element property, which can be used in the mesh_properties list of the output_settings command command.