# Initial Conditions

The following inputs are defined using the prefix `ic`:

| Description | Type | Default
--- | --- | --- | ---
regions | Regions used to define initial conditions. | String | None
allow_regions_overlap | Flag for allowing the user to decide whether particles will be generated/initialized more than once on the areas where the IC regions have an intersection | Bool | 1 (yes)
ranking_type | IC regions are sorted during initialization. This input lets the user decide the ranking criterion, which can be one of the following: inputs – the order in the inputs file volume – the volume of each IC region priority – the priority value provided by the user in the inputs | String | Inputs

## Fluid settings

For each initial condition region, the fluid inputs are defined using the compound prefix `ic.[region].[fluid]`:

| Description | Type | Default
--- | --- | --- | ---
volfrac | Volume fraction [required] | Real | 0
density | Fluid density | Real | 0
temperature | Fluid temperature | Real | 0
velocity | Velocity components | Reals | 0 0 0
species.[species0] | Mass fraction of ‘species0’ | Reals | 0 0 0

## Solids settings

For each initial condition region, general solids inputs are defined using the compound prefix `ic.[region]`:

| Description | Type | Default
--- | --- | --- | ---
solids | Name of solid type in IC region – only one solid is allowed in an IC region. | String | None
packing | Specifies how auto-generated particles are placed in the IC region: hcp – hex-centered packing pseudo_random – random packing using a fixed random seed random – random packing (not repeatable) oneper – one particle per cell eightper – eight particles per cell n-cube – n^3 particles per cell where n is an integer (NOTE: oneper is equivalent to 1-cube and eightper to 2-cube) | String | None
priority | Priority value for IC regions ranking as described above | Int | Max

For each initial condition region, the solid inputs are defined using the compound prefix `ic.[region].[solid]`: Note that diameter distributions must define a weighting type, please refer to ReferenceParticleDistributions.

| Description | Type | Default
--- | --- | --- | ---
volfrac | Volume fraction | Real | 0
temperature | temperature | Real | 0
species.[species0] | Mass fraction of ‘species0’ | Real | 0
velocity | Velocity components | Reals | 0 0 0
diameter | Method to specify particle diameter in the IC region. This is only used for auto-generated particles. Available options include: ‘constant’ – specified constant ‘uniform’ – uniform distribution ‘normal’ – normal distribution ‘custom’ – user defined distribution | String | None
type | distribution weighting: `number-weighted` or `volume-weighted` | string | N/A
bins | Number of bins used when discretizing the distribution to approximate the number of particles within an initial condition region. | int | 64
diameter.constant | Monodisperse (single valued) particle diameter. Required for `constant` distributions. | Real | 0
diameter.mean | Distribution mean. Required for `normal` distributions. | Real | 0
diameter.std | Distribution standard deviation. Required for `normal` distributions. | Real | 0
diameter.min | Minimum diameter to clip distribution. Required for `normal` distributions and `uniform` distributions. | Real | 0
diameter.max | Maximum diameter to clip distribution. Required for `normal` distributions and `uniform` distributions. | Real | 0
diameter.custom | File name that specifies either the cumulative or probability distribution. Required for `custom` distributions. | String | None
density | Method to specify particle density in the IC region. This is only used for auto-generated particles. Available options include: ‘constant’ – specified constant ‘uniform’ – uniform distribution ‘normal’ – normal distribution ‘custom’ – user defined distribution | String | None
density.constant | Monodisperse (single valued) particle density. Required for `constant` distributions. | Real | 0
density.mean | Distribution mean. Required for `normal` distributions. | Real | 0
density.std | Distribution standard deviation. Required for `normal` distributions. | Real | 0
density.min | Minimum diameter to clip distribution. Required for `normal` distributions and `uniform` distributions. | Real | 0
density.max | Maximum diameter to clip distribution. Required for `normal` distributions and `uniform` distributions. | Real | 0
density.custom | File name that specifies either the cumulative or probability distribution. Required for `custom` distributions. | String | None

The following inputs must be preceded by `mfix`:

| Description | Type | Default
--- | --- | --- | ---
particle_init_type | How do we initialize the particles? “Auto” vs AsciiFile | String | AsciiFile

The following inputs must be preceded by `particles`:

| Description | Type | Default
--- | --- | --- | ---
removeOutOfRange | Flag to remove particles at initialization that are touching a wall | Int | 1

Below is an example for specifying an initial condition for a fluid (`fluid`) and one solid (`solid0`).

    mfix.particle_init_type = Auto

    particles.removeOutOfRange = 1

    ic.regions  = bed0  bed1

    ic.bed0.fluid.volfrac   =  0.725
    ic.bed0.fluid.density   =  1.0
    ic.bed0.fluid.velocity  =  0.015  0.00  0.00
    ic.bed0.fluid.temperature =  383.0
    ic.bed0.fluid.species.CO  =  0.3
    ic.bed0.fluid.species.CO2 =  0.2
    ic.bed0.fluid.species.O2  =  0.5

    ic.bed0.solids  = my_solid0

    ic.bed0.packing = pseudo_random

    ic.bed0.my_solid0.volfrac  =  0.275
    ic.bed0.my_solid0.temperature  =  400.0
    ic.bed0.my_solid0.species.Fe2O3 =  0.4
    ic.bed0.my_solid0.species.FeO   =  0.6

    ic.bed0.my_solid0.velocity =  0.00  0.00  0.00

    ic.bed0.my_solid0.diameter = constant
    ic.bed0.my_solid0.diameter.constant =  100.0e-6

    ic.bed0.my_solid0.density  = constant
    ic.bed0.my_solid0.density.constant  = 1000.0

    ic.bed1.fluid.volfrac   =  0.925
    ic.bed1.fluid.density   =  1.0
    ic.bed1.fluid.velocity  =  0.015  0.00  0.00
    ic.bed1.fluid.temperature =  383.0
    ic.bed1.fluid.species.CO  =  0.5
    ic.bed1.fluid.species.CO2 =  0.5
    ic.bed1.fluid.species.O2  =  0.0

    ic.bed1.solids  = solid0
    ic.bed1.packing = pseudo_random

    ic.bed1.solid0.volfrac  =  0.075
    ic.bed1.solid0.temperature  =  450.0
    ic.bed1.solid0.species.Fe2O3 =  0.0
    ic.bed1.solid0.species.FeO   =  1.0

    ic.bed1.solid0.velocity =  0.10  0.00  0.00

    ic.bed1.solid0.diameter = uniform
    ic.bed1.solid0.diameter.type = number-weighted
    ic.bed1.solid0.diameter.bins = 20
    ic.bed1.solid0.diameter.min =   90.0e-6
    ic.bed1.solid0.diameter.max =  110.0e-6

    ic.bed1.solid0.density  = normal
    ic.bed1.solid0.density.mean  = 900.0
    ic.bed1.solid0.density.std  =   30.0
    ic.bed1.solid0.density.min  =  800.0
    ic.bed1.solid0.density.max  = 1000.0