Excreta module#

Functions to compute the amount of excreta (urine or feces) generated by a human population over a certain amount of time.

Content#

Collection()

feces_from_population(pop, duration[, wet, ci])

Mass of feces generated by a given population over a certain duration from the excretions.csv database.

urine_from_population(pop, duration[, ci])

Amount of urine generated by a given population over a certain duration from the excretions.csv database.

Details#

class orgmatt.excreta.Collection#
orgmatt.excreta.feces_from_population(pop: float | Collection, duration, wet: bool = True, ci: int = 0, **kwargs)[source]#

Mass of feces generated by a given population over a certain duration from the excretions.csv database.

Parameters:

  • pop (float or list-like object) – Number of inhabitants.

  • duration (float [time]) – Time interval over which the nitrogen is excreted.

  • wet (bool (optional, default: True)) – Whether to compute the mass of wet feces (default) or dry solids.

  • ci (int (optional, default: 0)) – Confidence interval (CI). If non-zero, the function will also return the low and high expected values corresponding to that CI.

Returns:

feces – Mass of excreted feces if ci is 0, otherwise one (low, mean, high) result per entry in pop, giving the expected masses for the requested confidence interval.

Return type:

float or array of size 3 or (len(pop), 3) [mass]

orgmatt.excreta.urine_from_population(pop: float | Collection, duration, ci: int = 0, **kwargs)[source]#

Amount of urine generated by a given population over a certain duration from the excretions.csv database.

Parameters:

  • pop (float or list-like object) – Number of inhabitants.

  • duration (float [time]) – Time interval over which the nitrogen is excreted.

  • ci (int (optional, default: 0)) – Confidence interval (CI). If non-zero, the function will also return the low and high expected values corresponding to that CI.

  • **kwargs (arguments to use a subset of the database) – Additional arguments can be use to restrict the results to a subset of the full database. E.g. one can add region=”Europe” to use only values obtained from studies in European countries.

Returns:

urine – Volume of excreted urine if ci is 0, otherwise one (low, mean, high) result per pop entry, giving the volumes expected for the requested confidence interval.

Return type:

float or array of size 3 or (len(pop), 3) [length]**3