Representation¶

Particula Index / Particula / Particles / Representation

Auto-generated documentation for particula.particles.representation module.

ParticleRepresentation¶

Everything needed to represent a particle or a collection of particles.

Represents a particle or a collection of particles, encapsulating the strategy for calculating mass, radius, and total mass based on a specified particle distribution, density, and concentration. This class allows for flexibility in representing particles.

Attributes¶

strategy - The computation strategy for particle representations.
activity - The activity strategy for the partial pressure calculations.
surface - The surface strategy for surface tension and Kelvin effect.
distribution - The distribution data for the particles, which could represent sizes, masses, or another relevant metric.
density - The density of the material from which the particles are made.
concentration - The concentration of particles within the distribution.
charge - The charge on each particle.
volume - The air volume for simulation of particles in the air, default is 1 m^3. This is only used in ParticleResolved Strategies.

Signature¶

class ParticleRepresentation:
    def __init__(
        self,
        strategy: DistributionStrategy,
        activity: ActivityStrategy,
        surface: SurfaceStrategy,
        distribution: NDArray[np.float64],
        density: NDArray[np.float64],
        concentration: NDArray[np.float64],
        charge: NDArray[np.float64],
        volume: float = 1,
    ): ...

ParticleRepresentation().str¶

Show source in representation.py:61

Returns a string representation of the particle representation.

Returns¶

str - A string representation of the particle representation.

Signature¶

def __str__(self) -> str: ...

ParticleRepresentation().add_concentration¶

Show source in representation.py:312

Adds concentration to the particle distribution.

Arguments¶

added_concentration - The concentration to be added per distribution bin.

Signature¶

def add_concentration(
    self,
    added_concentration: NDArray[np.float64],
    added_distribution: Optional[NDArray[np.float64]] = None,
) -> None: ...

ParticleRepresentation().add_mass¶

Show source in representation.py:297

Adds mass to the particle distribution, and updates parameters.

Arguments¶

added_mass - The mass to be added per distribution bin.

Signature¶

def add_mass(self, added_mass: NDArray[np.float64]) -> None: ...

ParticleRepresentation().collide_pairs¶

Show source in representation.py:338

Collide pairs of indices, used for ParticleResolved Strategies.

Arguments¶

indices - The indices to collide.

Signature¶

def collide_pairs(self, indices: NDArray[np.int64]) -> None: ...

ParticleRepresentation().get_activity¶

Show source in representation.py:99

Returns the activity strategy used for partial pressure calculations.

Arguments¶

clone - If True, then return a deepcopy of the activity strategy.

Returns¶

The activity strategy used for partial pressure calculations.

Signature¶

def get_activity(self, clone: bool = False) -> ActivityStrategy: ...

ParticleRepresentation().get_activity_name¶

Show source in representation.py:113

Returns the name of the activity strategy used for partial pressure calculations.

Returns¶

The name of the activity strategy used for partial pressure calculations.

Signature¶

def get_activity_name(self) -> str: ...

ParticleRepresentation().get_charge¶

Show source in representation.py:201

Returns the charge per particle.

Arguments¶

clone - If True, then return a copy of the charge array.

Returns¶

The charge of the particles.

Signature¶

def get_charge(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_concentration¶

Show source in representation.py:173

Returns the volume concentration of the particles.

For ParticleResolved Strategies, the concentration is the number of particles per self.volume to get concentration/m^3. For other Strategies, the concentration is the already per 1/m^3.

Arguments¶

clone - If True, then return a copy of the concentration array.

Returns¶

The concentration of the particles.

Signature¶

def get_concentration(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_density¶

Show source in representation.py:160

Returns the density of the particles.

Arguments¶

clone - If True, then return a copy of the density array.

Returns¶

The density of the particles.

Signature¶

def get_density(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_distribution¶

Show source in representation.py:147

Returns the distribution of the particles.

Arguments¶

clone - If True, then return a copy of the distribution array.

Returns¶

The distribution of the particles.

Signature¶

def get_distribution(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_mass¶

Show source in representation.py:242

Returns the mass of the particles as calculated by the strategy.

Arguments¶

clone - If True, then return a copy of the mass array.

Returns¶

The mass of the particles.

Signature¶

def get_mass(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_mass_concentration¶

Show source in representation.py:257

Returns the total mass / volume simulated.

The mass concentration is as calculated by the strategy, taking into account the distribution and concentration.

Arguments¶

clone - If True, then return a copy of the mass concentration.

Returns¶

np.float64 - The mass concentration of the particles, kg/m^3.

Signature¶

def get_mass_concentration(self, clone: bool = False) -> np.float64: ...

ParticleRepresentation().get_radius¶

Show source in representation.py:283

Returns the radius of the particles as calculated by the strategy.

Arguments¶

clone - If True, then return a copy of the radius array

Returns¶

The radius of the particles.

Signature¶

def get_radius(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_species_mass¶

Show source in representation.py:227

Returns the masses per species in the particles.

Arguments¶

clone - If True, then return a copy of the mass array.

Returns¶

The mass of the particles per species.

Signature¶

def get_species_mass(self, clone: bool = False) -> NDArray[np.float64]: ...

ParticleRepresentation().get_strategy¶

Show source in representation.py:78

Returns the strategy used for particle representation.

Arguments¶

clone - If True, then return a deepcopy of the strategy.

Returns¶

The strategy used for particle representation.

Signature¶

def get_strategy(self, clone: bool = False) -> DistributionStrategy: ...

ParticleRepresentation().get_strategy_name¶

Show source in representation.py:91

Returns the name of the strategy used for particle representation.

Returns¶

The name of the strategy used for particle representation.

Signature¶

def get_strategy_name(self) -> str: ...

ParticleRepresentation().get_surface¶

Show source in representation.py:123

Returns the surface strategy used for surface tension and Kelvin effect.

Arguments¶

clone - If True, then return a deepcopy of the surface strategy.

Returns¶

The surface strategy used for surface tension and Kelvin effect.

Signature¶

def get_surface(self, clone: bool = False) -> SurfaceStrategy: ...

ParticleRepresentation().get_surface_name¶

Show source in representation.py:137

Returns the name of the surface strategy used for surface tension and Kelvin effect.

Returns¶

The name of the surface strategy used for surface tension and Kelvin effect.

Signature¶

def get_surface_name(self) -> str: ...

ParticleRepresentation().get_total_concentration¶

Show source in representation.py:190

Returns the total concentration of the particles.

Arguments¶

clone - If True, then return a copy of the concentration array.

Returns¶

The concentration of the particles.

Signature¶

def get_total_concentration(self, clone: bool = False) -> np.float64: ...

ParticleRepresentation().get_volume¶

Show source in representation.py:214

Returns the volume of the particles.

Arguments¶

clone - If True, then return a copy of the volume array.

Returns¶

The volume of the particles.

Signature¶

def get_volume(self, clone: bool = False) -> float: ...

Representation¶

ParticleRepresentation¶

Attributes¶

Signature¶

See also¶

ParticleRepresentation().str¶

Returns¶

Signature¶

ParticleRepresentation().add_concentration¶

Arguments¶

Signature¶

ParticleRepresentation().add_mass¶

Arguments¶

Signature¶

ParticleRepresentation().collide_pairs¶

Arguments¶

Signature¶

ParticleRepresentation().get_activity¶

Arguments¶

Returns¶

Signature¶

See also¶

ParticleRepresentation().get_activity_name¶

Returns¶

Signature¶

ParticleRepresentation().get_charge¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_concentration¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_density¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_distribution¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_mass¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_mass_concentration¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_radius¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_species_mass¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_strategy¶

Arguments¶

Returns¶

Signature¶

See also¶

ParticleRepresentation().get_strategy_name¶

Returns¶

Signature¶

ParticleRepresentation().get_surface¶

Arguments¶

Returns¶

Signature¶

See also¶

ParticleRepresentation().get_surface_name¶

Returns¶

Signature¶

ParticleRepresentation().get_total_concentration¶

Arguments¶

Returns¶

Signature¶

ParticleRepresentation().get_volume¶

Arguments¶

Returns¶