Introduction

Dilute pyroclastic density currents (hereafter DPDCs) are turbulent multiphase gravity flows that can occur during explosive volcanic eruptions. While the process that generates DPDCs can vary significantly, spanning from the collapse of an ash cloud to a direct lateral blast related to a volcanic dome collapse (Dellino et al. 2014; Sulpizio et al. 2014; Dufek 2016), their motion is mainly controlled by the density contrast with the surrounding atmosphere and topography (Sulpizio and Dellino 2008; Jenkins et al. 2013; Mele et al. 2015). In particular, DPDCs represent the low-particle concentration type of pyroclastic density currents (Valentine 1987; Burgisser and Bergantz 2002; Sulpizio et al. 2007; Dellino et al. 2008; Sulpizio and Dellino 2008; Sulpizio et al. 2014; Breard et al. 2015; Dufek 2016). In a DPDC, while particles are transported mainly by the mechanism of turbulent suspension, inter-particle collisions and fluidization phenomena play a negligible role and are mainly restricted to a thin basal layer (Fig. 1a). On the other hand, in a high-particle concentration type of pyroclastic flows, particle-particle collisions and frictional contacts are the dominant mechanism (Fig. 1a) (Iverson and Vallance 2001; Dellino et al. 2008; Sulpizio and Dellino 2008; Roche 2012; Sulpizio et al. 2014; Dufek 2016). Due to their mobility and capability to transport dangerous amounts of hot volcanic ash and gases, DPDCs represent a source of hazard for human life, activities, and infrastructure in the potentially affected areas (Neri et al. 2015a). In particular, their potential impact can be attributed to flow velocity, density, and temperature (Baxter et al. 1998; Neri et al. 2007; Dellino et al. 2008; Caricchi et al. 2014). The dynamic impact of DPDCs on obstacles aligned at right angles to their direction of motion (e.g., walls) is usually quantified by the dynamic pressure, Pdyn = 0.5ρfu2, where ρf is the flow density and u is the velocity along the flow direction. Additionally, DPDCs are also responsible for the transport of ash over long distances, which can be dangerous for people’s health even at very low particle volumetric concentration, C (Horwell and Baxter 2006). Finally, forecasting the occurrence, the path, and the potential distance traveled by future DPDCs is currently challenging and subject to significant uncertainties (Neri et al. 2015b), which are further complicated by their ability to delaminate and/or surmount large topographic obstacles (e.g., Baxter et al. 2005; Charbonnier et al. 2013; Jenkins et al. 2013).

Fig. 1
figure 1

a Scheme of a DPDC deposit on an inclined slope of angle α. The reference level z0, the shear flow thickness zsf, and the total flow thickness ztot are shown, together with the concentration profile C(z) and average velocity profile u(z). b Picture of a typical complete DPDC deposit, with the layer of coarse lapilli and bombs (A), the laminated layer (B), and the massive thin ash layer (C). Reprinted from Computer and Geosciences, 66, Fabio Dioguardi, Pierfrancesco Dellino, PYFLOW: A computer code for the calculation of the impact parameters of Dilute Pyroclastic Density Currents (DPDC) based on field data., 200–210, Copyright (2014), with permission from Elsevier

The fluid dynamic behavior of PDCs in general has been extensively investigated theoretically (e.g., Branney and Kokelaar 2002; Nield and Woods 2003; Doronzo 2012), numerically (e.g., Valentine 1987; Neri et al. 2003, 2007; Esposti Ongaro et al. 2007; Doronzo and Dellino 2011; Bevilacqua et al. 2015; Engwell et al. 2016), and experimentally (e.g., Wilson 1980; Woods and Bursik 1994; Leeder et al. 2005; Dellino et al. 2007, 2010a, b; Roche 2012; Lube et al. 2015; Breard et al. 2016; Sulpizio et al. 2016). However, the analysis of the facies architecture of DPDCs’ deposits has also proved to be a powerful tool for understanding the fluid dynamic properties and the sedimentation processes of these flows (e.g., Brown et al. 2007; Sulpizio et al. 2007) and developing “reverse engineering” (Dellino et al. 2008) or inverse modeling approaches, i.e., starting from the result (the deposit) to infer the process (the flow) (Chough and Sohn 1990; Dellino et al. 2000, 2004; Dioguardi and Dellino 2014; Mele et al. 2015). In fact, DPDC deposits are characterized by peculiar properties, in particular concerning their stratigraphy: the typical bedset starts from the base with a layer made of coarse particles (generally lapilli, layer A in Fig. 1b). These particles could be already present on the ground during the passage of the DPDC, or represent particles falling into the flow and that were too coarse to be transported in turbulent suspension. Typically, layer A can be observed in proximal areas (Dellino et al. 2008; Mele et al. 2015). The sequence continues upwards with the main signatures of DPDC deposits, i.e., a level characterized by internal laminations, often with cross lamination and wavy structures, usually composed of ash and fine lapilli (layer B in Fig. 1b). This part is generally attributed to the particles settling from turbulent suspension (Branney and Kokelaar 2002; Dellino et al. 2004, 2008; Sulpizio and Dellino 2008; Sulpizio et al. 2016). A layer of thin massive ash generally closes the sequence on top: this is formed by the fine ash slowly settling in the waning stage of the flow (layer C in Fig. 1b).

From the early 2000s, volcanologists started to work on the development of sedimentological models that linked the deposit architecture and properties described above to the flow characteristics (Dellino and La Volpe 2000; Dellino et al. 2004). In the first pioneering studies, a similarity between DPDCs and turbulent boundary layer shear flows (TBLSF, Furbish 1997; Schlichting and Gersten 2000; Pope 2000), which form when a turbulent fluid moves over a solid boundary, was hypothesized and proven. Subsequent improvements and refinements led to an initial sedimentological model allowing calculation of some of the impact parameters (dynamic pressure and particle volumetric concentration) of DPDCs starting from deposit data (Gurioli et al. 2002; Dellino et al. 2008). The model was later validated by means of large-scale experiments (Dellino et al. 2010b) and implemented in the first version of PYFLOW in order to simplify and speed up the calculation procedure (Dioguardi and Dellino 2014).

In this paper, a new version of PYFLOW (version 2.0) is presented, together with two applications showing the capabilities of the software. Version 2.0 is significantly improved over the initial version both in terms of the sedimentological modeling (the implementation of different shape-dependent drag laws and of a new model for calculating the deposition rate and time) and in the informatics (with faster numerical routines and a user-friendly input data method). The software and user’s manual are given in the electronic supporting material linked to the paper (Electronic Supplementary Material: Folder = PYFLOW_2.0).

Model

In this section, the sedimentological model for calculating flow properties (e.g., bulk density, velocity, and dynamic pressure) is briefly described. A more detailed description, including the computational methods, can be found in the user’s manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf) included in the software package available in the electronic supporting material linked to the paper (Electronic Supplementary Material: Folder = PYFLOW_2.0). The software is also available at https://vhub.org/resources/4234. In the following, we will mainly focus on the new modeling features introduced in the code, where all symbols and notations are defined in Table 1.

Table 1 Symbol notation

TBLSF as an approximation of DPDCs

The analogy between TBLSFs and turbulent dilute geophysical surface flows has been proposed for many decades, in particular for the transport and deposition of sediments in particle-laden turbulent flows (Middleton and Southard 1984), and applied in the volcanic context to calculate average velocity and density of DPDCs of some past explosive eruptions at Vulcano, Aeolian Islands (Dellino and La Volpe 2000) and Campi Flegrei (Dellino et al. 2004). A complete sedimentological model based on this analogy was presented in Dellino et al. (2008), experimentally validated in Dellino et al. (2010b) and included in a first preliminary version of the presented software (Dioguardi and Dellino 2014).

In a DPDC, solid particles, which usually show a wide range of size (from fine ash to coarse lapilli) and componentry (pumice, crystals, lithic fragments, etc.), are held in suspension by the effect of the carrier fluid turbulence, since the vertical component of the velocity fluctuations that are directed upward contrasts with the downward particles’ settling velocity (Dellino et al. 2008). Indeed, as it follows from Prandtl’s assumption (Furbish 1997; Schlichting and Gersten 2000), the shear stress at the base of the current is \( {\tau}_0={\rho}_{\mathrm{f}}{u}_{\ast}^2=-{\rho}_{\mathrm{f}}\overline{u^{\prime }{w}^{\prime }} \), where u is the shear velocity and \( \overline{u^{\prime }{w}^{\prime }} \) is the covariance of the fluctuating velocities in the stream (x) and upward (z) directions.

A peculiar characteristic of turbulent dilute gravity currents like DPDCs is the vertical particle concentration stratification resulting from the combined action of gravity and the diffusive effect of the gas turbulence over the particles transported in turbulent suspension. The vertical concentration profile was first described by the Rouse equation (Rouse 1939), which quantifies the maximum load of particles (expressed as particle volumetric concentration C) that can be transported in turbulent suspension by a turbulent flow:

$$ C(z)={C}_0{\left(\frac{z_0}{z_{\mathrm{tot}}-{z}_0}\frac{z_{\mathrm{tot}}-z}{z}\right)}^{P_n} $$
(1)

where C0 is the particle volumetric concentration at the reference level z0 and ztot is the total flow thickness (Fig. 1a). Here, z0 is the base level at which the particles are being settled from suspension, i.e., where C(z) approaches the maximum packing limit typical of the very thin bedload at the base of a sediment current (0.75 in Dellino et al. 2008). In this equation, an important role is played by the Rouse number P n , a dimensionless parameter defined as

$$ {P}_n=\frac{w}{k{u}_{\ast }} $$
(2)

where w is the particle settling velocity and k is Von Karman’s constant (equal to 0.4). It is straightforward to infer from (2) that P n describes the tendency of particles to be transported by a turbulent flow. When P n  > 2.5, a particle is at settling conditions, whereas when P n  < 2.5, it can be held in suspension (Middleton and Southard 1984). In a DPDC, the solid phase is represented by a population of particles, each one characterized by different size, density, drag, hence different settling velocity w. The Rouse number P n therefore represents an average value of the population of particles transported in the turbulent flow.

The particle concentration profile controls the flow density profile, as it results from the definition of fluid bulk density ρf in the multiphase framework:

$$ {\rho}_{\mathrm{f}}(z)=\left(1-C(z)\right){\rho}_{\mathrm{g}}+C(z){\rho}_{\mathrm{s}} $$
(3)

where ρg and ρs are the gas and solid particle density, respectively. Given the vertical density stratification and that the fluid phase is a mixture of hot gas and entrained atmospheric air that is less dense than the surrounding atmosphere (Engwell et al. 2016), DPDCs develop a basal part with a density greater than the atmospheric density and a top part, which is buoyant (Fig. 1a). The basal portion is the shear current that is responsible for the majority of the dynamic impact of the flow in the direction of motion (dynamic pressure). This is the part of the DPDC that can be described according to the TBLSF theory (Dellino et al. 2008); hence, the time-averaged (over a time interval short enough to capture the main flow field variations but long enough to smooth the velocity fluctuations over) velocity profile of the current can be calculated by the “law of the wall”:

$$ \frac{\overline{u}(z)}{u_{\ast }}=\frac{1}{k}\ln \frac{z}{k_{\mathrm{s}}}+8.5 $$
(4)

where ks is the roughness parameter of the substrate, which is proportional to the height of the roughness elements of the substrate (Schlichting and Gersten 2000; Dellino et al. 2008). The top part of the current, which sometimes is also referred to as the co-ignimbrite ash cloud or ash-cloud surge (Branney and Kokelaar 2002), is of high relevance too since it is responsible for the transport of fine ash, which has residence times in the atmosphere that are significantly longer than the particles in the basal part. Additionally, fine ash can have consequences on the health of humans and animals (Horwell and Baxter 2006). Hence, this part needs to be taken into consideration too in order to quantify the whole range of potential impacts of DPDCs, from the lateral impact on building to the fine ash in the atmosphere.

The combination of flow density and velocity profiles leads to the dynamic pressure profile:

$$ {P}_{\mathrm{dyn}}(z)=\frac{1}{2}{\rho}_{\mathrm{f}}(z)\overline{u}{(z)}^2 $$
(5)

which can be spatially averaged over a height (flow thickness) relevant for hazard assessment purposes.

In the dense basal part of the DPDC, particles settle down from suspension and form the bed load. The combination of the stress exerted from the overlying shear flow on the bed load and the continuous sedimentation of particles from suspension results in a progressive aggradation of sediment to form thin traction laminae, which are one of the most distinguishing features of DPDC deposits (Branney and Kokelaar 2002; Sulpizio and Dellino 2008; Dellino et al. 2008). Particles from the overriding dilute portion of the flow, on the other hand, settle during the waning stage of the flow, thus resulting in a fine-grained massive layer that caps the typical stratigraphic sequence that can be attributed to a DPDC.

If the stratigraphic sequence of Fig. 1b is observed in the field and characterized quantitatively in detail by measuring its thickness, grainsize distributions, componentry, particle density, and shape, it is possible to use PYFLOW to invert deposit data and define the fluid dynamic characteristics of the parent current. The values calculated by PYFLOW represent the flow characteristics at the particular location where the deposit has been recognized in the field. When deposits of the same flow unit of a DPDC are found in different outcrops, the variation of the DPDC behavior and impact in its direction of propagation can be approximated using PYFLOW (Mele et al. 2015). Since the model is based on the TBLSF approximation of DPDCs, it is expected to give reasonable results only in the case of dilute turbulent particle-laden currents (Dellino et al. 2008). In some cases, one cannot be completely confident that a deposit in the field is actually the final product of a turbulent DPDC. For this reason, PYFLOW always performs a Student t test in the computation stage in order to check the validity of the assumptions in the particular case under investigation.

Based on the observed deposit architecture, it is possible to use two different but complementary approaches for calculating the flow properties using PYFLOW_2.0: the Shield and the suspension-sedimentation criterions.

Shield and suspension-sedimentation criterions

A DPDC can carry particles that are never transported in suspension but that can be moved over the substrate by the current shear stress. Examples can be particles in the flow with P n  > > 2.5 (e.g., coarse particles transported in the proximal locations or falling into the flow from a simultaneous eruptive column) or loose particles on the ground before the DPDC passage. This phenomenon can be quantified by means of the Shield parameter (Miller et al. 1977), which is defined as the ratio between the flow shear stress and the buoyancy force per unit area of the particle in the flow and defines the initiation of motion of particles laying on the substrate:

$$ \theta =\frac{\rho_{\mathrm{f}}{u_{\ast}}^2}{\left({\rho}_{\mathrm{s}1}-{\rho}_{\mathrm{f}}\right)g{d}_1} $$
(6)

where g is gravity acceleration and ρs1 and d1 the density and diameter of the entrained particle, respectively; θ is a parameter depending on the particle shear Reynolds number Re* (Re = ρfud1/η where η is the fluid viscosity), which decreases as Re* increases (particles are more likely to be moved by the flow) and becomes equal to 0.015 for a Re* number greater than 1000 (Miller et al. 1977).

On the other hand, at the limit of transportation by turbulent suspension, when P n  = 2.5, from (2) and since k = 0.4, it follows that

$$ w={u}_{\ast } $$
(7)

This is the suspension-sedimentation criterion (Middleton and Southard 1984), which means that particles stay suspended in the flow until their settling velocity is less than the flow shear velocity. In other words, particles in the deposit that settle from suspension (the laminae-forming bed load) give an indication of the flow shear velocity at the time of deposition, once their terminal velocity is defined. Particle settling velocity w can be calculated by the so-called Newton impact law (Dellino et al. 2005):

$$ w=\sqrt{\frac{4 gd\left({\rho}_{\mathrm{s}}-{\rho}_{\mathrm{f}}\right)}{3{C}_{\mathrm{d}}{\rho}_{\mathrm{f}}}} $$
(8)

where d is the particle equivalent diameter (i.e., the diameter of the sphere having the same volume of the settling particle) and Cd is the drag coefficient. Upon combining (7) and (8), it follows that

$$ {u_{\ast}}^2=\frac{4 gd\left({\rho}_{\mathrm{s}}-{\rho}_{\mathrm{f}}\right)}{3{C}_{\mathrm{d}}{\rho}_{\mathrm{f}}} $$
(9)

The squared shear velocity coincides with the shear stress at the base of the current normalized by the flow density:

$$ \tau ={\rho}_{\mathrm{f}}{u_{\ast}}^2 $$
(10)

When the complete stratigraphic sequence described in the previous section is recognized in the field (Fig. 1b), it is possible to apply both the Shield and the suspension-sedimentation criteria for calculating the flow parameters. In PYFLOW, this approach is named “two layers model.” However, the layer of entrained coarse lapilli or bombs, which is typical of proximal locations around the eruptive vent, is often missing in distal outcrops, thus preventing the use of the Shield criterion. In such a case, an alternative method based on the hydraulic equivalence of particles can be used, which in PYFLOW is named the “two components model.” The reader can find details on the two approaches in Dellino et al. (2008), Dioguardi and Dellino (2014), and the user manual provided here (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf). In the next sections, we will focus on the new sedimentological models implemented in PYFLOW_2.0.

Necessary input data

In order to use equations (6) through (10) and to solve for the flow shear velocity and density, it is necessary to provide as input, besides layer properties (layer thickness zlam, substrate roughness ks), the physical properties of the particles representing the laminated layer and possibly the basal coarse layer. In particular, for the aforementioned two models, the following data are necessary:

  • For the “two layers model”: density ρs1 and representative dimension d1 of the selected particle in the coarse layer; density ρs, the representative dimension d, and shape of the particles deposited in the laminated layer; this can be for a selected component (e.g., juvenile glassy particles or crystals).

  • For the “two components model”: density ρs, representative dimension d, and shape of the particle deposited in the laminated layer of two selected components.

The selection of components for the calculations depends on different factors. As a general guidance, it is advised to select the components based on the relative abundance in the deposit and on the shape of their grainsize distribution, with a unimodal Gaussian distribution to be preferred since it can be interpreted as the result of deposition from turbulent suspension (Dellino et al. 2008). Further details on how to obtain these and other relevant data can be found in the user’s manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf) and in Dellino et al. (2000, 2004, 2008, 2010b) and Mele et al. (2015).

Shape-dependent drag laws

In the new version presented here, it is possible to choose among nine shape-dependent drag formulas. Volcanic particles cannot be approximated by spheres, especially in the fluid dynamic regimes typical of DPDCs. It is well known, in fact, that the influence of particle shape increases as the particle Reynolds number Re increases (Ganser 1993; Dioguardi et al. 2014; Dioguardi and Mele 2015; Bagheri and Bonadonna 2016; Dioguardi et al. 2017). Therefore, in order to obtain realistic estimates of DPDC impact parameters, it is essential to use shape-dependent drag formulas. These drag formulas are generally a function of Re and one or more particle shape descriptors. Table 2 summarizes the possible choices, the needed shape descriptors, the appropriate reference, and the drag law equations. If the user desires, the code allows calculating the drag assuming spherical particles; in this case, the drag is calculated by using the formula of Clift and Gauvin (1971). The drag law selection can significantly influence the solution, as will be shown in the application examples. This is due to the fact that the sedimentological model is highly sensitive to the variations of the calculated fluid-particle drag. Therefore, we recommend running PYFLOW selecting different drag laws based on the available shape descriptors (e.g., Dellino et al. (2005) and Dioguardi and Mele (2015) if the value of the shape factor Ψ is known).

Table 2 List of shape-dependent drag laws available in PYFLOW_2.0. The indexes i and j refer to the component and the grainsize class, respectively

Particle density and grainsize

In this new version, PYFLOW offers greater flexibility when providing particle density in the laminated layer. In this model, the deposition rates of each grainsize class of each component constituting the deposit, which are directly proportional to particle density (11), are calculated and then summed to obtain the total deposition rate. For juvenile vesiculated particles, density can change significantly with size (Houghton and Wilson (1989); Dellino et al. (2005); Beckett et al. (2015)). Hence, in this new version, PYFLOW offers the possibility to either specify a constant or a size-dependent density, in the latter case either by indicating the density of each grainsize class or using built-in density-versus-size functions, which were obtained by available data from previous studies (e.g., Dellino et al. 2008). Table 3 gives the available size-dependent density laws, while commands for activating them are presented in the user manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf).

Table 3 List of available empirical laws for calculating the size-dependent density of juvenile vesiculated particles

Additionally, PYFLOW can automatically perform grainsize distribution analysis for the two components used in the sedimentological model in order to calculate the median Md ϕ and sorting σ φ . Optionally, a χ2 test for checking if the distributions are significantly different from normal Gaussian distribution can be performed. If the depositional model is also activated, the program will perform grainsize analysis by default for all the components considered for this model, since the user will be forced to provide grainsize and density distribution data.

Deposition model

The deposition model calculates the deposition rate and time from the DPDC based on the flow (e.g., flow density, shear velocity, etc.) and deposit properties (componentry, grainsize distributions, etc.). Flow properties required to execute the deposition model (namely density ρf, thickness ztot, shear velocity u) can either come from the solution of the sedimentological model presented above or be provided in input. The deposition model, in fact, can run as a standalone program provided all the needed flow and particle properties are given in input.

In this model, by neglecting the possible effect of resuspension and/or erosion, the deposition rate R of the jth grainsize class of a component i forming the deposit is given by (Stow and Bowen 1980)

$$ {R}_{i,j}={\rho}_{s,i,j}{w}_{i,j}{C}_{i,j} $$
(11)

where C i,j is the particle volumetric concentration of each grainsize class j in the flow. Since particle density ρ s,i,j is an input parameter and the terminal velocity w i,j can be readily calculated from (8), C i,j needs to be evaluated at this stage. To do so, it is assumed that the ratio between the sedimentation rates of the jth and j + 1th classes in the flow, taking all the \( N={\sum}_{i=1}^{n_{\mathrm{comp}}}{n}_{\mathrm{classes},i} \) grainsize classes in the deposit together (ncomp is the number of components constituting the deposit and considered in the calculation, nclasses is the number of grainsize classes for each component), is equal to the ratio of the weight fractions ps of the same classes in the deposit formed by that flow:

$$ \frac{p_{s,j}}{p_{s,j+1}}=\frac{R_j}{R_{j+1}}=\frac{\rho_{s,j}{w}_j{C}_j}{\rho_{s,j+1}{w}_{j+1}{C}_{j+1}} $$
(12)

This equation is solved for each grainsize class, thus forming a system of N equations:

$$ \left\{\begin{array}{c}\begin{array}{c}{C}_j=\frac{p_{s,j}{\rho}_{s,j+1}{w}_{j+1}{C}_{j+1}}{p_{s,j+1}{\rho}_{s,j}{w}_j}\\ {}{C}_{j+1}=\frac{p_{s,j+1}{\rho}_{s,j+2}{w}_{j+2}{C}_{j+2}}{p_{s,j+2}{\rho}_{s,j+1}{w}_{j+1}}\end{array}\\ {}\vdots \\ {}\begin{array}{c}{C}_{N-1}=\frac{p_{s,N-1}{\rho}_{s,N}{w}_N{C}_N}{p_{s,N}{\rho}_{s,N-1}{w}_{N-1}}\\ {}{C}_N={C}_{\mathrm{tot}}-\sum \limits_{j=1}^{N-1}{C}_j\end{array}\end{array}\right. $$
(13)

where Ctot is the total particle volumetric concentration in the flow. This is obtained by the bulk flow density ρf and weight-averaging the particle density of all the grainsize classes:

$$ {C}_{\mathrm{tot}}=\frac{\rho_{\mathrm{f}}-{\rho}_{\mathrm{g}}}{\sum_{j=1}^N{\rho}_{s,j}{p}_{s,j}} $$
(14)

In this model, particles are classified as either constituting the turbulent suspension or the wash load categories based on their Rouse number P n,i,j (Rouse 1939; Middleton and Southard 1984):

  • Wash-load: P n,i,j  < 0.8

  • Turbulent suspension: 0.8 < P n,i,j  < 5.0

  • Fall: P n,i,j  > 5.0

Particles whose Rouse number is less than 0.8 constitute the wash load, i.e., particles that are uniformly distributed throughout the flow and mainly settle in the waning stage of the flow. If a fine massive layer is observed in the deposit (level C in Fig. 1b), PYFLOW can calculate the deposition rate and time contributions of this layer if the layer thickness is provided (zlam,massive). In the current version, PYFLOW automatically assumes this layer is formed by particles of the laminated layer that can be attributed to the wash-load (P n,i,i  < 0.8). For these particles, the volumetric concentration is calculated by multiplying their weight fraction with the ratio between the fine massive layer thickness and the flow thickness. If a grainsize and componentry analysis of this specific layer is carried out, it is possible to calculate the deposition rate and time of this layer separately thanks to the capability of PYFLOW to run this module as a standalone. Additionally, particles with a Rouse number greater than five can be optionally discarded, since these particles can be considered to fall in the deposit without being influenced by the turbulent flow. This threshold is approximate, but important for excluding these particles from the calculation to prevent an overestimation of the deposition rate and an underestimation of the deposition time. We choose the critical value of five as a safe approximation, which is double the value of 2.5 that describes when particles start to settle in the turbulent DPDC (since w = u*) to form the bedload (Rouse 1939; Middleton and Southard 1984). PYFLOW2.0 allows the user to avoid this cutoff or change this critical value. After the system of equations given in (13) has been solved for the particle concentrations C j (details on the calculation procedure are neglected here; the reader can refer to the supplied user manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf)), the total deposition rate and time of both the laminated layer and the fine massive layer (if present and/or considered) are calculated:

$$ {R}_{\mathrm{tot},\mathrm{susp}}=\sum \limits_{i=1}^{n_{\mathrm{comp}}}\sum \limits_{j={j}_{\mathrm{wash},i}+1}^{n_{\mathrm{classes},i}}{\rho}_{s,i,j}{w}_{i,j}{C}_{i,j}=\sum \limits_{i=1}^{n_{\mathrm{comp}}}\sum \limits_{j={j}_{\mathrm{wash}}+1}^{n_{\mathrm{classes},i}}{R}_{i,j,\mathrm{susp}} $$
(15)
$$ {R}_{\mathrm{tot},\mathrm{massive}}=\sum \limits_{i=1}^{n_{\mathrm{comp}}}\sum \limits_{j=1}^{j_{\mathrm{wash},i}}{\rho}_{s,i,j}{w}_{i,j}{C}_{i,j}=\sum \limits_{i=1}^{n_{\mathrm{comp}}}\sum \limits_{j=1}^{j_{\mathrm{wash},i}}{R}_{i,j,\mathrm{massive}} $$
(16)
$$ {R}_{\mathrm{tot}}={R}_{\mathrm{tot},\mathrm{susp}}+{R}_{\mathrm{tot},\mathrm{massive}} $$
(17)
$$ {t}_{\mathrm{dep},\mathrm{susp}}=\frac{z_{\mathrm{lam},\mathrm{susp}}{C}_0{\sum}_{i=1}^{n_{\mathrm{comp}}}{\sum}_{j={j}_{\mathrm{wash},i}+1}^{n_{\mathrm{classes},i}}{\rho}_{s,i,j}{p}_{s,i,j}}{R_{\mathrm{tot},\mathrm{susp}}} $$
(18)
$$ {t}_{\mathrm{dep},\mathrm{massive}}=\frac{z_{\mathrm{lam},\mathrm{massive}}{C}_0{\sum}_{i=1}^{n_{\mathrm{comp}}}{\sum}_{j=1}^{j_{\mathrm{wash},i}}{\rho}_{s,i,j}{p}_{s,i,j}}{R_{\mathrm{tot},\mathrm{massive}}} $$
(19)
$$ {t}_{\mathrm{dep},\mathrm{tot}}={t}_{\mathrm{dep},\mathrm{susp}}+{t}_{\mathrm{dep},\mathrm{massive}} $$
(20)

where jwash,i is the index of the coarsest grainsize class constituting the wash load of the component i and the subscripts susp and massive refer to the laminated and the fine massive layer, respectively.

For the total deposition rate Rtot and deposition time tdep,tot, the average, maximum, and minimum solutions are calculated, since Rtot (and hence tdep,tot) depends on the flow bulk density, for which the three solutions were calculated in the previous steps.

Application examples

Two application examples are described in this section. The test cases are designed to cover the largest possible range of applications and commands. It is straightforward to run other cases by simply amending the input files of the provided test cases (Electronic Supplementary Material: Folder = PYFLOW_2.0/Test_cases).

The application examples build on field data collected from laminated pyroclastic density current deposits of the Pollena Subplinian eruption (AD 472; Vesuvius, Italy). In particular, we examined deposits of S2 (sample vs 2_3) and S3 units (sample vs 26_1), which were emplaced by a dilute pyroclastic current during the second and third phase of the eruption, respectively (Sulpizio et al. 2005; 2007). Their deposits consist of ash with lenses of lapilli that form low-amplitude, meter-spaced dunes with internal cross stratification (Fig. 2). At a few locations, the deposits show the bedset that reflects the fining upward sequence described in Fig. 1b. From the bottom, the outcrops start with a basal layer made of inversely graded coarse lapilli presenting a preferential orientation that can be attributed to the overlying flow. This layer is followed by a laminated layer with cross stratification of fine lapilli/coarse ash and finally topped by a massive fine-ash layer.

Fig. 2
figure 2

Photos of the outcrops used for the application examples. Left picture: Pollena VS2. Right picture: Pollena VS26 (hammer length: 28 cm). The black solid lines delimit the outcrop area sampled for the calculations

The input and result files can be found in the folders “Pollena/2-3” and “Pollena/26-1” (Electronic Supplementary Material: Folder = PYFLOW_2.0/Test_cases). Details on the field and laboratory analyses carried out for obtaining input parameters can be found in the Electronic Supplementary Material (PYFLOW_2.0/Sampling and laboratory analyses.docx).

Pollena VS2-3

In this case, we use the “two layers” method described previously. Detailed explanations on how to create the input file are provided in the user manual, where the same test cases are described (Electronic Supplementary Material: Folder = PYFLOW_2.0/Manual/Manual.pdf).

From the basal layer (A in Fig. 1b), we selected a particle with a diameter of 0.08 m and a density of 2570 kg m−3. From the laminated layer (B in Fig. 1b), we selected the juvenile particles (median grainsize and density 1.286 mm and 1750 kg m−3, respectively). In Table 4, input data for the physical variables needed in the calculation are summarized together with the corresponding entries in the input file.

Table 4 Input parameters and corresponding commands of the Pollena 2-3 application example

Results of this test case are summarized in results.dat (Electronic Supplementary Material: Folder = Test_cases/Pollena/2-3), whose screenshots are shown in the user manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf). The file is organized as follows: in the first part (“Data summary”), input data for the sedimentological model (Table 4) are summarized for both components; results for the main flow properties (average, maximum, and minimum solutions) are subsequently written, followed by a summary of the Student t test. The file continues with all the user-requested outputs, in this case the average specific dynamic pressure at 5 and 2 m height from the base of the current. The following section contains results from the probability density function routine (symmetrization exponent, median μsimm and standard deviation σsimm) for all the considered impact parameters and the values of the impact parameters at the user-requested percentile.

Figure 3 shows plots of the vertical profiles of the flow variables as plotted by opening the files conc_profile.dat, dens_profile.dat, vel_profile.dat, pdyn_profile.dat (Electronic Supplementary Material: Folder = Test_cases/Pollena/2-3/main) with Excel. The calculated flow properties are typical of a DPDC that could exert a significant impact, with an average dynamic pressure over the first 10 m of 3 kPa, which becomes 4.15 kPa over the first 5 m and 6.2 kPa over the first 2 m. These values of dynamic pressure can potentially cause damage that can be classified as moderate to heavy (Baxter et al. 2005), mainly consisting of the failure of doors and windows. If one considers the maximum solution with an exceedance probability of 5%, calculated values significantly increase reaching 12.1 kPa over the first 2 m height, a value that can potentially cause heavy damage to partial devastation (Baxter et al. 2005), with walls starting to be affected. This reflects the strong vertical stratification of these currents, which can be further appreciated by looking at the profiles of Fig. 3. The particle concentration, hence flow density, shows particularly steep gradients which, combined with the gentler velocity gradient, results in a parabolic-like dynamic pressure vertical profile.

Fig. 3
figure 3

Plots of the vertical profiles of the calculated flow field variables for the Pollena VS2-3 application example. Dotted, solid, and dashed black lines represent the solutions at 16th percentile, 50th percentile, and 84th percentile, respectively. a Particle volumetric concentration C. b Flow density ρf. c Flow velocity u. d Flow dynamic pressure Pdyn

Finally, we analyze the influence of the shape-dependent drag laws on the solution (Electronic Supplementary Material: Folder = Test_cases/Pollena/2-3/drag_laws). For the examined deposit, in particular for the juvenile component taken under consideration, particle sphericity φ is available alongside the shape factor Ψ: 0.727. This allowed performing the calculation with five different drag laws: Dellino et al. (2005) and Dioguardi and Mele (2015) (shape factor Ψ); Haider and Levenspiel (1989), Ganser (1993), and Chien (1994) (sphericity φ). Figure 4 shows the vertical profile of dynamic pressure corresponding to the maximum solution as calculated by PYFLOW by default (16% exceedance probability) for the five considered drag laws. The curves follow the same trend, but some differences can be noted, with the laws of Chien (1994) and Dellino et al. (2005) generating the maximum values, while with Dioguardi and Mele (2015) and Ganser (1993) dynamic pressure values are the lowest; finally, the solution with Haider and Levenspiel (1989) lies between the other four curves. Although the difference between the calculated values is not very high, it is not negligible (maximum values about 15%) meaning that, if different shape descriptors are available, it is recommended to run PYFLOW with as many drag laws as possible and to assign an uncertainty (range of variation) to the solution. The influence of the selected drag law becomes even more evident when calculating the deposition rates and times, as discussed in the next section.

Fig. 4
figure 4

Eighty-fourth percentile solution of dynamic pressure Pdyn of Pollena VS2-3 application example calculated with different shape-dependent fluid-particle drag laws. Solid line: Dellino et al. (2005). Dashed-double-dotted line: Dioguardi and Mele (2015). Dashed-dotted: Ganser (1993). Dashed line: Chien (1994). Dotted line: Haider and Levenspiel (1989)

Pollena VS26-1

In this case, the “two components” method was used in conjunction with the depositional model. Table 5 summarizes the input data relevant for running the two components model. A screenshot of the results.dat (Electronic Supplementary Material: Folder = Test_cases/Pollena/26-1/main) file is shown in the user manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf), in particular the section related to the deposition rate and time calculations. Since, as already stated, the deposition model can run as standalone, the user can run it for up to six separate simulations with different input flow field parameters, results are then organized under headers identifying the solution number without the attributes “average,” “maximum,” or “minimum.” In this example, PYFLOW calculated the three solutions by default starting from the three flow solutions of the “two components” model; in particular, “solution 1” corresponds with the average, “solution 2” with the maximum (84th percentile), and “solution 3” with the minimum (16th percentile) solution. The deposition rate is minimum at solution 2 (~ 0.85 kg m−2 s−1), since it strongly depends on the flow density, which is minimum at the 84th percentile solution of the sedimentological model. It follows that the deposition time takes its maximum value at this percentile (~ 1250 s, corresponding to 21 min) and ranges from few to 21 min, values that are compatible with other pyroclastic flows that were directly observed (e.g., Brand et al. 2016). The deposition time corresponds to the time in which volcanic ash is in the air settling from the turbulent basal part and the co-ignimbrite ash cloud in the waning stage and can be potentially inhaled by human beings and animals. In Fig. 5, the deposition rates of all the grainsize classes for all the four components (vesiculated juveniles, pyroxenes, lithic fragments, and sialic crystals) are displayed as a function of the grainsize for each solution. These plots were drawn by opening the file deposition_summary.dat (Electronic Supplementary Material: Folder = Test_cases/Pollena/26-1/main) with Microsoft Excel, which includes also the grainsize, terminal velocity, Rouse number, particle density, and volumetric concentration for all the components and all the solutions. The deposition rates of the grainsize classes unavoidably reflect the grainsize distribution in the deposit. This can be further verified by comparing the curves with the histograms in Fig. 6, in which the grainsize distributions for all the components for solution 1 are shown. Note that the grainsize distributions are cut towards the coarsest grainsizes; this is the result of PYFLOW neglecting the particles with P n  > 5. In this test case (Electronic Supplementary Material: Folder = Test_cases/Pollena/26-1/no_pn-cut), grainsize distribution is characterized by relatively low fractions of coarse particles with P n  > 5; this results in very similar values of deposition rates (range 0.867–5.38 kg m−2 s−1) and times (range 201–1250 s) calculated if these particles are not discarded from the calculation.

Table 5 Input parameters and corresponding commands of the Pollena 26-1 application example (only input data for the two components model are shown)
Fig. 5
figure 5

Plots showing the deposition rate vs. particle size for the four components (dashed line: juvenile particles; solid line: pyroxenes; dotted line: lithic fragments; solid-dotted line: sialic crystals) of the Pollena 26-1 deposit. Solution 1, 2, and 3 correspond to the average, maximum, and minimum solution of PYFLOW, respectively

Fig. 6
figure 6

Histogram showing the grainsize distribution of the four components (dark grey: juvenile particles; black: pyroxenes; white: lithic fragments; light grey: sialic crystals) of the Pollena 26-1 deposit

Finally, in order to show the sensitivity of model results to the chosen drag law and changes of particle shape descriptors, we run this simulation first by fixing the drag law (Dioguardi and Mele 2015) and changing the value of the shape factor for all the components (Electronic Supplementary Material: Folder = Test_cases/Pollena/26-1/sensitivity_shape-factor) and then by using the original input data and changing the drag laws (Electronic Supplementary Material: Folder = Test_cases/Pollena/26-1/sensitivity_drag-law). Results from this analysis are listed in the Excel file “sensitivity_results.xlsx” ((Electronic Supplementary Material: Folder = Test_cases/Pollena/26-1). For the former test, the shape factor was varied ± 5 and ± 10% (over the possible range of variation of the shape factor 0–1), hence resulting in four additional simulations. For the latter test, we run four additional simulations by using other drag laws, namely Dellino et al. (2005), Haider and Levenspiel (1989), Ganser (1993), and Chien (1994). These drag laws were selected since they depend on shape descriptors (shape factor Ψ and sphericity φ) that were available for this test case (see Table 5).

Results are summarized in Table 6 and Fig. 7, the latter showing range of variation of the 50th percentile solutions only, to which we refer in the following. Results of the test on the shape factor variation (black bars in Fig. 7) show that, for an overall variation of the shape factor of 20% around the original values (which is quite a wide range of uncertainty for this shape descriptors; see Dellino et al. 2005 and Dioguardi and Mele 2015), the calculated dynamic pressures varied by ~ 65%, while deposition rates and times varied by ~ 30%. Deposition rates are less sensitive, but still the influence of the shape descriptor on the deposition rate and time is relatively high, since it directly affects the particle terminal velocity. Deposition rates are instead significantly more sensitive to the chosen drag law, with absolute range of variations of the different solutions of deposition rate and time between ~ 50 and ~ 73% (Fig. 7). This is not surprising, since terminal velocities are strongly dependent on the fluid-particle drag C d (8), which, in turn, changes significantly with the selected drag model. Results of the sensitivity tests confirm that it is recommended to run the model with different drag laws, if the needed shape parameters are available, in particular when calculating the deposition rate and time.

Table 6 Results of the analysis of the sensitivity of PYFLOW_2.0 to the shape factor Ψ variation and the selection of the different shape-dependent drag laws
Fig. 7
figure 7

Bar plot showing the range of variation of the solved parameters (pdyn, Rtot, and tdep) at 50th percentile from the sensitivity analysis of the shape factor Ψ and the drag laws. Black bars: results from the shape factor Ψ sensitivity analysis. Grey bars: results from the drag laws sensitivity analysis

Conclusions and future developments

In this paper, a new software for the quantification of the impact of dilute pyroclastic density currents based on field analysis data (e.g., grainsize, componentry, deposit thickness, etc.) is presented. The software is based on a first preliminary version of PYFLOW presented in the past few years, but it includes significant advances in both the functionalities and the physics. In particular, a new tool has been included for quantifying the deposition rate and time of the flow, hence providing a way to estimate the volcanic ash residence time in the air, which can have a significant impact on potentially exposed human beings and animals. The software is available in the electronic supporting material linked to the paper (Electronic Supplementary Material: Folder = PYFLOW_2.0) and comes with a detailed user manual (Electronic Supplementary Material: PYFLOW_2.0/Manual/Manual.pdf) and two meaningful test cases (Electronic Supplementary Material: Folder = PYFLOW_2.0/Test_cases) based on real data coming from PDC deposits of the Pollena eruption (Vesuvius, Italy), whose results are discussed in this paper. Results from the test case dedicated to the new deposition rate model demonstrate how even relatively weak (i.e., low dynamic pressure) pyroclastic density currents can have a significant impact on people’s health given the computed long deposition time (minutes to tens of minutes).

The program is in continuous development and minor modifications and additions are already planned and underway and these updates will be posted on VHUB and linked to this paper (https://vhub.org/resources/4234). Potential major modifications will consist of linking the PYFLOW output, which refers to a specific location along the runout path of a past DPDC, to a simplified 1D pyroclastic flow model. In particular, the flow field variables calculated by PYFLOW (vertical profiles of flow velocity and density) can be used as boundary conditions of 1D steady models (e.g., Bursik and Woods 1996), which can be run to obtain a continuous spatial evolution of the flow properties based on realistic boundary conditions. An example of a possible application of this capability could be the evaluation of the spatial evolution of the flow between two or more discrete points where the flow variables are computed by PYFLOW. This, coupled to a method to interpolate values of flow variables along different runout paths, has the potential to result in a new tool to create impact maps based on impact parameters constrained by real deposit data. Finally, major improvements will include the further modification of PYFLOW towards an even more user-friendly version with the implementation of a Graphic User Interface.