axisym_poroelastic_fsi_face_elements.h

Go to the documentation of this file.

// LIC// ====================================================================
// LIC// This file forms part of oomph-lib, the object-oriented,
// LIC// multi-physics finite-element library, available
// LIC// at http://www.oomph-lib.org.
// LIC//
// LIC// Copyright (C) 2006-2022 Matthias Heil and Andrew Hazel
// LIC//
// LIC// This library is free software; you can redistribute it and/or
// LIC// modify it under the terms of the GNU Lesser General Public
// LIC// License as published by the Free Software Foundation; either
// LIC// version 2.1 of the License, or (at your option) any later version.
// LIC//
// LIC// This library is distributed in the hope that it will be useful,
// LIC// but WITHOUT ANY WARRANTY; without even the implied warranty of
// LIC// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// LIC// Lesser General Public License for more details.
// LIC//
// LIC// You should have received a copy of the GNU Lesser General Public
// LIC// License along with this library; if not, write to the Free Software
// LIC// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
// LIC// 02110-1301  USA.
// LIC//
// LIC// The authors may be contacted at oomph-lib@maths.man.ac.uk.
// LIC//
// LIC//====================================================================
// Header file for elements that are used to integrate fluid tractions
#ifndef OOMPH_AXISYM_POROELASTIC_FSI_TRACTION_ELEMENTS_HEADER
#define OOMPH_AXISYM_POROELASTIC_FSI_TRACTION_ELEMENTS_HEADER
 
// Config header generated by autoconfig
#ifdef HAVE_CONFIG_H
#include <oomph-lib-config.h>
#endif
 
 
// OOMPH-LIB headers
#include "../generic/shape.h"
#include "../generic/elements.h"
#include "../generic/element_with_external_element.h"
 
#include "axisym_poroelasticity_elements.h"
 
 
namespace oomph
{
  //=======================================================================
  //=======================================================================
  namespace LinearisedAxisymPoroelasticBJS_FSIHelper
  {
    double Default_strouhal_number = 1.0;
 
    double Default_inverse_slip_rate_coefficient = 0.0;
  } // namespace LinearisedAxisymPoroelasticBJS_FSIHelper
 
 
  //======================================================================
  //======================================================================
  template<class FLUID_BULK_ELEMENT, class POROELASTICITY_BULK_ELEMENT>
  class LinearisedAxisymPoroelasticBJS_FSIElement
    : public virtual FaceGeometry<FLUID_BULK_ELEMENT>,
      public virtual FaceElement,
      public virtual ElementWithExternalElement
  {
  public:
    LinearisedAxisymPoroelasticBJS_FSIElement(FiniteElement* const& bulk_el_pt,
                                              const int& face_index,
                                              const unsigned& id = 0);
 
    LinearisedAxisymPoroelasticBJS_FSIElement() {}
 
    LinearisedAxisymPoroelasticBJS_FSIElement(
      const LinearisedAxisymPoroelasticBJS_FSIElement& dummy) = delete;
 
    void operator=(const LinearisedAxisymPoroelasticBJS_FSIElement&) = delete;
 
    double*& st_pt()
    {
      return St_pt;
    }
 
    double st() const
    {
      return *St_pt;
    }
 
    double inverse_slip_rate_coefficient() const
    {
      return *Inverse_slip_rate_coeff_pt;
    }
 
 
    double*& inverse_slip_rate_coefficient_pt()
    {
      return Inverse_slip_rate_coeff_pt;
    }
 
 
    void fill_in_contribution_to_residuals(Vector<double>& residuals)
    {
      // Call the generic residuals function with flag set to 0
      // using a dummy matrix argument
      fill_in_generic_residual_contribution_axisym_poroelastic_fsi(
        residuals, GeneralisedElement::Dummy_matrix, 0);
    }
 
 
    // hieher need to add derivs w.r.t external data (the
    // bulk velocity dofs
    /* /// Add the element's contribution to its residual vector and its
     */
    /* /// Jacobian matrix */
    /* void fill_in_contribution_to_jacobian( */
    /*   Vector<double> &residuals, */
    /*   DenseMatrix<double> &jacobian) */
    /*  { */
    /*   //Call the generic routine with the flag set to 1 */
    /*   fill_in_generic_residual_contribution_fpsi_bjs_axisym */
    /*    (residuals,jacobian,1); */
 
    /*   //Derivatives w.r.t. external data */
    /*   fill_in_jacobian_from_external_interaction_by_fd(residuals,jacobian);
     */
    /*  } */
 
 
    double contribution_to_enclosed_volume()
    {
      // Initialise
      double vol = 0.0;
 
      // Find out how many nodes there are
      const unsigned n_node = this->nnode();
 
      // Set up memeory for the shape functions
      Shape psi(n_node);
      DShape dpsids(n_node, 1);
 
      // Set the value of n_intpt
      const unsigned n_intpt = this->integral_pt()->nweight();
 
      // Storage for the local coordinate
      Vector<double> s(1);
 
      // Loop over the integration points
      for (unsigned ipt = 0; ipt < n_intpt; ipt++)
      {
        // Get the local coordinate at the integration point
        s[0] = this->integral_pt()->knot(ipt, 0);
 
        // Get the integral weight
        double W = this->integral_pt()->weight(ipt);
 
        // Call the derivatives of the shape function at the knot point
        this->dshape_local_at_knot(ipt, psi, dpsids);
 
        // Get position and tangent vector
        Vector<double> interpolated_t1(2, 0.0);
        Vector<double> interpolated_x(2, 0.0);
        for (unsigned l = 0; l < n_node; l++)
        {
          // Loop over directional components
          for (unsigned i = 0; i < 2; i++)
          {
            interpolated_x[i] += this->nodal_position(l, i) * psi(l);
            interpolated_t1[i] += this->nodal_position(l, i) * dpsids(l, 0);
          }
        }
 
        // Calculate the length of the tangent Vector
        double tlength = interpolated_t1[0] * interpolated_t1[0] +
                         interpolated_t1[1] * interpolated_t1[1];
 
        // Set the Jacobian of the line element
        double J = sqrt(tlength) * interpolated_x[0];
 
        // Now calculate the normal Vector
        Vector<double> interpolated_n(2);
        this->outer_unit_normal(ipt, interpolated_n);
 
        // Assemble dot product
        double dot = 0.0;
        for (unsigned k = 0; k < 2; k++)
        {
          dot += interpolated_x[k] * interpolated_n[k];
        }
 
        // Add to volume with sign chosen so that...
 
        // Factor of 1/3 comes from div trick
        vol += 2.0 * MathematicalConstants::Pi * dot * W * J / 3.0;
      }
 
      return vol;
    }
 
 
    void output(std::ostream& outfile)
    {
      // Dummy
      unsigned nplot = 0;
      output(outfile, nplot);
    }
 
    void output(std::ostream& outfile, const unsigned& n_plot)
    {
      // Find out how many nodes there are
      unsigned n_node = nnode();
 
      // Get the value of Nintpt
      const unsigned n_intpt = integral_pt()->nweight();
 
      // Tecplot header info
      outfile << this->tecplot_zone_string(n_intpt);
 
      // Set the Vector to hold local coordinates
      Vector<double> s(Dim - 1);
      Vector<double> x_bulk(Dim);
      Shape psi(n_node);
      DShape dpsids(n_node, Dim - 1);
 
      // Cache the Strouhal number
      const double local_st = st();
 
      // Cache the slip rate coefficient
      const double local_inverse_slip_rate_coeff =
        inverse_slip_rate_coefficient();
 
      // Loop over the integration points
      for (unsigned ipt = 0; ipt < n_intpt; ipt++)
      {
        // Assign values of s
        for (unsigned i = 0; i < (Dim - 1); i++)
        {
          s[i] = integral_pt()->knot(ipt, i);
        }
 
        // Get the outer unit normal
        Vector<double> interpolated_normal(Dim);
        outer_unit_normal(ipt, interpolated_normal);
 
        // Calculate the unit tangent vector
        Vector<double> interpolated_tangent(Dim);
        interpolated_tangent[0] = -interpolated_normal[1];
        interpolated_tangent[1] = interpolated_normal[0];
 
        // Get solid velocity and porous flux from adjacent solid
        POROELASTICITY_BULK_ELEMENT* ext_el_pt =
          dynamic_cast<POROELASTICITY_BULK_ELEMENT*>(
            external_element_pt(0, ipt));
        Vector<double> s_ext(external_element_local_coord(0, ipt));
        Vector<double> du_dt(3);
        Vector<double> q(2);
        ext_el_pt->interpolated_du_dt(s_ext, du_dt);
        ext_el_pt->interpolated_q(s_ext, q);
        x_bulk[0] = ext_el_pt->interpolated_x(s_ext, 0);
        x_bulk[1] = ext_el_pt->interpolated_x(s_ext, 1);
 
        // Get own coordinates:
        Vector<double> x(Dim);
        this->interpolated_x(s, x);
 
#ifdef PARANOID
        if (!AxisymmetricPoroelasticityTractionElementHelper::Allow_gap_in_FSI)
        {
          double error = sqrt((x[0] - x_bulk[0]) * (x[0] - x_bulk[0]) +
                              (x[1] - x_bulk[1]) * (x[1] - x_bulk[1]));
          double tol = 1.0e-10;
          if (error > tol)
          {
            std::stringstream junk;
            junk << "Gap between external and face element coordinate\n"
                 << "is suspiciously large: " << error
                 << "\nBulk/external at: " << x_bulk[0] << " " << x_bulk[1]
                 << "\n"
                 << "Face at: " << x[0] << " " << x[1] << "\n";
            OomphLibWarning(
              junk.str(), OOMPH_CURRENT_FUNCTION, OOMPH_EXCEPTION_LOCATION);
          }
        }
#endif
 
        // Get permeability from the bulk poroelasticity element
        const double permeability = ext_el_pt->permeability();
        const double local_permeability_ratio = ext_el_pt->permeability_ratio();
 
        // Local coordinate in bulk element
        Vector<double> s_bulk(Dim);
        s_bulk = local_coordinate_in_bulk(s);
 
        // Get the fluid traction from the NSt bulk element
        Vector<double> traction_nst(3);
        dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_element_pt())
          ->traction(s_bulk, interpolated_normal, traction_nst);
 
        // Get fluid velocity from bulk element
        Vector<double> fluid_veloc(Dim + 1, 0.0);
        dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_element_pt())
          ->interpolated_u_axi_nst(s_bulk, fluid_veloc);
 
        // Get fluid pressure from bulk element
        double p_fluid = dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_element_pt())
                           ->interpolated_p_axi_nst(s_bulk);
 
        // Calculate the normal components
        double scaled_normal_wall_veloc = 0.0;
        double scaled_normal_poro_veloc = 0.0;
        double scaled_tangential_wall_veloc = 0.0;
        double scaled_tangential_poro_veloc = 0.0;
        double normal_nst_veloc = 0.0;
        for (unsigned i = 0; i < Dim; i++)
        {
          scaled_normal_wall_veloc +=
            local_st * du_dt[i] * interpolated_normal[i];
 
          scaled_normal_poro_veloc +=
            local_st * permeability * q[i] * interpolated_normal[i];
 
          scaled_tangential_wall_veloc +=
            local_st * du_dt[i] * interpolated_tangent[i];
 
          scaled_tangential_poro_veloc +=
            -traction_nst[i] * sqrt(local_permeability_ratio) *
            local_inverse_slip_rate_coeff * interpolated_tangent[i];
 
          normal_nst_veloc += fluid_veloc[i] * interpolated_normal[i];
        }
 
        // Calculate the combined poroelasticity "velocity" (RHS of BJS BC).
        double total_poro_normal_component =
          scaled_normal_wall_veloc + scaled_normal_poro_veloc;
        double total_poro_tangential_component =
          scaled_tangential_wall_veloc + scaled_tangential_poro_veloc;
        Vector<double> poro_veloc(2, 0.0);
        for (unsigned i = 0; i < Dim; i++)
        {
          poro_veloc[i] +=
            total_poro_normal_component * interpolated_normal[i] +
            total_poro_tangential_component * interpolated_tangent[i];
        }
 
 
        // Call the derivatives of the shape function at the knot point
        this->dshape_local_at_knot(ipt, psi, dpsids);
 
        // Get tangent vector
        Vector<double> interpolated_t1(2, 0.0);
        for (unsigned l = 0; l < n_node; l++)
        {
          // Loop over directional components
          for (unsigned i = 0; i < 2; i++)
          {
            interpolated_t1[i] += this->nodal_position(l, i) * dpsids(l, 0);
          }
        }
 
        // Set the Jacobian of the line element
        double J = sqrt(1.0 + (interpolated_t1[0] * interpolated_t1[0]) /
                                (interpolated_t1[1] * interpolated_t1[1])) *
                   x[0];
 
 
        // Default geometry; evaluate everything in deformed (Nst) config.
        double lagrangian_eulerian_translation_factor = 1.0;
 
        // Get pointer to associated face element to get geometric information
        // from (if set up)
        FSILinearisedAxisymPoroelasticTractionElement<
          POROELASTICITY_BULK_ELEMENT,
          FLUID_BULK_ELEMENT>* ext_face_el_pt =
          dynamic_cast<FSILinearisedAxisymPoroelasticTractionElement<
            POROELASTICITY_BULK_ELEMENT,
            FLUID_BULK_ELEMENT>*>(external_element_pt(1, ipt));
 
        // Update geometry
        if (ext_face_el_pt != 0)
        {
          Vector<double> s_ext_face(external_element_local_coord(1, ipt));
 
          // Get correction factor for geometry
          lagrangian_eulerian_translation_factor =
            ext_face_el_pt->lagrangian_eulerian_translation_factor(s_ext_face);
        }
 
 
        // Output
        outfile << x_bulk[0] << " " // column 1
                << x_bulk[1] << " " // column 2
                << fluid_veloc[0] << " " // column 3
                << fluid_veloc[1] << " " // column 4
                << poro_veloc[0] << " " // column 5
                << poro_veloc[1] << " " // column 6
                << normal_nst_veloc * interpolated_normal[0] << " " // column 7
                << normal_nst_veloc * interpolated_normal[1] << " " // column 8
                << total_poro_normal_component * interpolated_normal[0]
                << " " // column 9
                << total_poro_normal_component * interpolated_normal[1]
                << "  " // column 10
                << scaled_normal_wall_veloc * interpolated_normal[0]
                << " " // column 11
                << scaled_normal_wall_veloc * interpolated_normal[1]
                << " " // column 12
                << scaled_normal_poro_veloc * interpolated_normal[0]
                << " " // column 13
                << scaled_normal_poro_veloc * interpolated_normal[1]
                << " " // column 14
                << p_fluid << " " // column 15
                << du_dt[0] << " " // column 16
                << du_dt[1] << " " // column 17
                << J << " " // column 18
                << lagrangian_eulerian_translation_factor << " " // column 19
                << std::endl;
      }
    }
 
 
    void contribution_to_total_porous_flux(double& skeleton_flux_contrib,
                                           double& seepage_flux_contrib,
                                           double& nst_flux_contrib)
    {
      // Get the value of Nintpt
      const unsigned n_intpt = integral_pt()->nweight();
 
      // Set the Vector to hold local coordinates
      Vector<double> s(Dim - 1);
      Vector<double> x_bulk(Dim);
 
      // Find out how many nodes there are
      const unsigned n_node = this->nnode();
 
      // Set up memeory for the shape functions
      Shape psi(n_node);
      DShape dpsids(n_node, 1);
 
      // Loop over the integration points
      skeleton_flux_contrib = 0.0;
      seepage_flux_contrib = 0.0;
      nst_flux_contrib = 0.0;
      for (unsigned ipt = 0; ipt < n_intpt; ipt++)
      {
        // Assign values of s
        for (unsigned i = 0; i < (Dim - 1); i++)
        {
          s[i] = integral_pt()->knot(ipt, i);
        }
 
        // Get the outer unit normal
        Vector<double> interpolated_normal(Dim);
        outer_unit_normal(ipt, interpolated_normal);
 
        // Get the integral weight
        double W = this->integral_pt()->weight(ipt);
 
        // Call the derivatives of the shape function at the knot point
        this->dshape_local_at_knot(ipt, psi, dpsids);
 
        // Get position and tangent vector
        Vector<double> interpolated_t1(2, 0.0);
        Vector<double> interpolated_x(2, 0.0);
        for (unsigned l = 0; l < n_node; l++)
        {
          // Loop over directional components
          for (unsigned i = 0; i < 2; i++)
          {
            interpolated_x[i] += this->nodal_position(l, i) * psi(l);
            interpolated_t1[i] += this->nodal_position(l, i) * dpsids(l, 0);
          }
        }
 
        // Calculate the length of the tangent Vector
        double tlength = interpolated_t1[0] * interpolated_t1[0] +
                         interpolated_t1[1] * interpolated_t1[1];
 
        // Set the Jacobian of the line element
        double J = sqrt(tlength) * interpolated_x[0];
 
        // Get solid velocity and porous flux from adjacent solid
        POROELASTICITY_BULK_ELEMENT* ext_el_pt =
          dynamic_cast<POROELASTICITY_BULK_ELEMENT*>(
            external_element_pt(0, ipt));
        Vector<double> s_ext(external_element_local_coord(0, ipt));
        Vector<double> du_dt(3);
        Vector<double> q(2);
        ext_el_pt->interpolated_du_dt(s_ext, du_dt);
        ext_el_pt->interpolated_q(s_ext, q);
        x_bulk[0] = ext_el_pt->interpolated_x(s_ext, 0);
        x_bulk[1] = ext_el_pt->interpolated_x(s_ext, 1);
 
 
#ifdef PARANOID
        if (!AxisymmetricPoroelasticityTractionElementHelper::Allow_gap_in_FSI)
        {
          // Get own coordinates:
          Vector<double> x(Dim);
          this->interpolated_x(s, x);
 
          double error = sqrt(
            (interpolated_x[0] - x_bulk[0]) * (interpolated_x[0] - x_bulk[0]) +
            (interpolated_x[1] - x_bulk[1]) * (interpolated_x[1] - x_bulk[1]));
          double tol = 1.0e-10;
          if (error > tol)
          {
            std::stringstream junk;
            junk << "Gap between external and face element coordinate\n"
                 << "is suspiciously large: " << error
                 << "\nBulk/external at: " << x_bulk[0] << " " << x_bulk[1]
                 << "\n"
                 << "Face at: " << x[0] << " " << x[1] << "\n";
            OomphLibWarning(
              junk.str(), OOMPH_CURRENT_FUNCTION, OOMPH_EXCEPTION_LOCATION);
          }
        }
#endif
 
 
        // Default geometry; evaluate everything in deformed (Nst) config.
        double lagrangian_eulerian_translation_factor = 1.0;
 
        // Get the outer unit normal for poro
        Vector<double> poro_normal(interpolated_normal);
 
 
        // Get pointer to associated face element to get geometric information
        // from (if set up)
        FSILinearisedAxisymPoroelasticTractionElement<
          POROELASTICITY_BULK_ELEMENT,
          FLUID_BULK_ELEMENT>* ext_face_el_pt =
          dynamic_cast<FSILinearisedAxisymPoroelasticTractionElement<
            POROELASTICITY_BULK_ELEMENT,
            FLUID_BULK_ELEMENT>*>(external_element_pt(1, ipt));
 
        // Update geometry
        if (ext_face_el_pt != 0)
        {
          Vector<double> s_ext_face(external_element_local_coord(1, ipt));
 
#ifdef PARANOID
 
          Vector<double> x_face(2);
          x_face[0] = ext_face_el_pt->interpolated_x(s_ext_face, 0);
          x_face[1] = ext_face_el_pt->interpolated_x(s_ext_face, 1);
 
          double tol = 1.0e-10;
          double error =
            std::fabs(x_bulk[0] - x_face[0]) + std::fabs(x_bulk[1] - x_face[1]);
          if (error > tol)
          {
            std::stringstream junk;
            junk << "Difference in Eulerian coordinates: " << error
                 << " is suspiciously large: "
                 << "Bulk: " << x_bulk[0] << " " << x_bulk[1] << " "
                 << "Face: " << x_face[0] << " " << x_face[1] << "\n";
            OomphLibWarning(
              junk.str(), OOMPH_CURRENT_FUNCTION, OOMPH_EXCEPTION_LOCATION);
          }
 
#endif
 
          // Get correction factor for geometry
          lagrangian_eulerian_translation_factor =
            ext_face_el_pt->lagrangian_eulerian_translation_factor(s_ext_face);
 
          // Get the outer unit normal
          ext_face_el_pt->outer_unit_normal(s_ext_face, poro_normal);
          poro_normal[0] = -poro_normal[0];
          poro_normal[1] = -poro_normal[1];
        }
 
        // Get permeability from the bulk poroelasticity element
        const double permeability = ext_el_pt->permeability();
 
        // Local coordinate in bulk element
        Vector<double> s_bulk(Dim);
        s_bulk = local_coordinate_in_bulk(s);
 
        // Get fluid velocity from bulk element
        Vector<double> fluid_veloc(Dim + 1, 0.0);
        dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_element_pt())
          ->interpolated_u_axi_nst(s_bulk, fluid_veloc);
 
        // Get net flux through boundary
        double q_flux = 0.0;
        double dudt_flux = 0.0;
        double nst_flux = 0.0;
        for (unsigned i = 0; i < 2; i++)
        {
          q_flux += permeability * q[i] * poro_normal[i];
          dudt_flux += du_dt[i] * interpolated_normal[i];
          nst_flux += fluid_veloc[i] * interpolated_normal[i];
        }
 
        // Add
        seepage_flux_contrib += 2.0 * MathematicalConstants::Pi * q_flux *
                                lagrangian_eulerian_translation_factor * W * J;
        skeleton_flux_contrib +=
          2.0 * MathematicalConstants::Pi * dudt_flux * W * J;
        nst_flux_contrib += 2.0 * MathematicalConstants::Pi * nst_flux * W * J;
      }
    }
 
 
    void output(FILE* file_pt)
    {
      FaceGeometry<FLUID_BULK_ELEMENT>::output(file_pt);
    }
 
    void output(FILE* file_pt, const unsigned& n_plot)
    {
      FaceGeometry<FLUID_BULK_ELEMENT>::output(file_pt, n_plot);
    }
 
 
  protected:
    double shape_and_test(const Vector<double>& s,
                          Shape& psi,
                          Shape& test) const
    {
      // Find number of nodes
      unsigned n_node = nnode();
 
      // Get the shape functions
      shape(s, psi);
 
      // Set the test functions to be the same as the shape functions
      for (unsigned i = 0; i < n_node; i++)
      {
        test[i] = psi[i];
      }
 
      // Return the value of the jacobian
      return J_eulerian(s);
    }
 
 
    double shape_and_test_at_knot(const unsigned& ipt,
                                  Shape& psi,
                                  Shape& test) const
    {
      // Find number of nodes
      unsigned n_node = nnode();
 
      // Get the shape functions
      shape_at_knot(ipt, psi);
 
      // Set the test functions to be the same as the shape functions
      for (unsigned i = 0; i < n_node; i++)
      {
        test[i] = psi[i];
      }
 
      // Return the value of the jacobian
      return J_eulerian_at_knot(ipt);
    }
 
  private:
    void fill_in_generic_residual_contribution_axisym_poroelastic_fsi(
      Vector<double>& residuals,
      DenseMatrix<double>& jacobian,
      const unsigned& flag);
 
    unsigned Dim;
 
    Vector<unsigned> U_index_axisym_poroelastic_fsi;
 
    unsigned Id;
 
    double* St_pt;
 
    double* Inverse_slip_rate_coeff_pt;
  };
 
 
 
  //===========================================================================
  //===========================================================================
  template<class FLUID_BULK_ELEMENT, class POROELASTICITY_BULK_ELEMENT>
  LinearisedAxisymPoroelasticBJS_FSIElement<FLUID_BULK_ELEMENT,
                                            POROELASTICITY_BULK_ELEMENT>::
    LinearisedAxisymPoroelasticBJS_FSIElement(FiniteElement* const& bulk_el_pt,
                                              const int& face_index,
                                              const unsigned& id)
    : FaceGeometry<FLUID_BULK_ELEMENT>(), FaceElement()
  {
    // Set source element storage: one interaction with an external element
    // that provides the velocity of the adjacent linear elasticity
    // element; one with the associated face element that provides
    // the geometric normalisation.
    this->set_ninteraction(2);
 
    //  Store the ID of the FaceElement -- this is used to distinguish
    // it from any others
    Id = id;
 
    // Initialise pointer to fluid Strouhal number. Defaults to 1
    St_pt = &LinearisedAxisymPoroelasticBJS_FSIHelper::Default_strouhal_number;
 
    // Initialise pointer to inverse slip rate coefficient. Defaults to 0 (no
    // slip)
    Inverse_slip_rate_coeff_pt = &LinearisedAxisymPoroelasticBJS_FSIHelper::
                                   Default_inverse_slip_rate_coefficient;
 
    // Let the bulk element build the FaceElement, i.e. setup the pointers
    // to its nodes (by referring to the appropriate nodes in the bulk
    // element), etc.
    bulk_el_pt->build_face_element(face_index, this);
 
    // Extract the dimension of the problem from the dimension of
    // the first node
    Dim = this->node_pt(0)->ndim();
 
    // Upcast pointer to bulk element
    FLUID_BULK_ELEMENT* cast_bulk_el_pt =
      dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_el_pt);
 
    // Read the index from the (cast) bulk element.
    U_index_axisym_poroelastic_fsi.resize(3);
    for (unsigned i = 0; i < 3; i++)
    {
      U_index_axisym_poroelastic_fsi[i] = cast_bulk_el_pt->u_index_axi_nst(i);
    }
 
    // The velocities in the bulk affect the shear stress acting
    // here so we must include them as external data
    unsigned n = cast_bulk_el_pt->nnode();
    for (unsigned j = 0; j < n; j++)
    {
      Node* nod_pt = cast_bulk_el_pt->node_pt(j);
      bool do_it = true;
      unsigned nn = nnode();
      for (unsigned jj = 0; jj < nn; jj++)
      {
        if (nod_pt == node_pt(jj))
        {
          do_it = false;
          break;
        }
      }
      if (do_it) add_external_data(cast_bulk_el_pt->node_pt(j));
    }
 
    // We need Dim+1 additional values for each FaceElement node to store the
    // Lagrange multipliers.
    Vector<unsigned> n_additional_values(nnode(), Dim + 1);
 
    // Now add storage for Lagrange multipliers and set the map containing the
    // position of the first entry of this face element's additional values.
    add_additional_values(n_additional_values, id);
  }
 
  //===========================================================================
  //===========================================================================
  template<class FLUID_BULK_ELEMENT, class POROELASTICITY_BULK_ELEMENT>
  void LinearisedAxisymPoroelasticBJS_FSIElement<FLUID_BULK_ELEMENT,
                                                 POROELASTICITY_BULK_ELEMENT>::
    fill_in_generic_residual_contribution_axisym_poroelastic_fsi(
      Vector<double>& residuals,
      DenseMatrix<double>& jacobian,
      const unsigned& flag)
  {
    // Find out how many nodes there are
    const unsigned n_node = nnode();
 
    // Set up memory for the shape and test functions
    Shape psif(n_node), testf(n_node);
 
    // Set the value of Nintpt
    const unsigned n_intpt = integral_pt()->nweight();
 
    // Set the Vector to hold local coordinates
    Vector<double> s(Dim - 1);
 
    // Cache the Strouhal number
    const double local_st = st();
 
    // Cache the slip rate coefficient
    const double local_inverse_slip_rate_coeff =
      inverse_slip_rate_coefficient();
 
    // Integers to hold the local equation and unknown numbers
    int local_eqn = 0;
 
    // Loop over the integration points
    // --------------------------------
    for (unsigned ipt = 0; ipt < n_intpt; ipt++)
    {
      // Assign values of s
      for (unsigned i = 0; i < (Dim - 1); i++)
      {
        s[i] = integral_pt()->knot(ipt, i);
      }
 
      // Get the integral weight
      double w = integral_pt()->weight(ipt);
 
      // Find the shape and test functions and return the Jacobian
      // of the mapping
      double J = shape_and_test(s, psif, testf);
 
      // Calculate the coordinates
      double interpolated_r = 0;
 
      // Premultiply the weights and the Jacobian
      double W = w * J;
 
      // Calculate the Lagrange multiplier and the fluid veloc
      Vector<double> lambda(Dim + 1, 0.0);
      Vector<double> fluid_veloc(Dim + 1, 0.0);
 
      // Loop over nodes
      for (unsigned j = 0; j < n_node; j++)
      {
        Node* nod_pt = node_pt(j);
 
        // Cast to a boundary node
        BoundaryNodeBase* bnod_pt = dynamic_cast<BoundaryNodeBase*>(node_pt(j));
 
        // Get the index of the first nodal value associated with
        // this FaceElement
        unsigned first_index =
          bnod_pt->index_of_first_value_assigned_by_face_element(Id);
 
        // Work out radius
        interpolated_r += nodal_position(j, 0) * psif(j);
 
        // Assemble
        for (unsigned i = 0; i < Dim + 1; i++)
        {
          lambda[i] += nod_pt->value(first_index + i) * psif(j);
          fluid_veloc[i] +=
            nod_pt->value(U_index_axisym_poroelastic_fsi[i]) * psif(j);
        }
      }
 
      // Local coordinate in bulk element
      Vector<double> s_bulk(Dim);
      s_bulk = local_coordinate_in_bulk(s);
 
#ifdef PARANOID
      {
        // Get fluid velocity from bulk element
        Vector<double> fluid_veloc_from_bulk(Dim + 1, 0.0);
        dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_element_pt())
          ->interpolated_u_axi_nst(s_bulk, fluid_veloc_from_bulk);
 
        double error = 0.0;
        for (unsigned i = 0; i < Dim + 1; i++)
        {
          error += (fluid_veloc[i] - fluid_veloc_from_bulk[i]) *
                   (fluid_veloc[i] - fluid_veloc_from_bulk[i]);
        }
        error = sqrt(error);
        double tol = 1.0e-15;
        if (error > tol)
        {
          std::stringstream junk;
          junk << "Difference in Navier-Stokes velocities\n"
               << "is suspiciously large: " << error
               << "\nVeloc from bulk: " << fluid_veloc_from_bulk[0] << " "
               << fluid_veloc_from_bulk[1] << "\n"
               << "Veloc from face: " << fluid_veloc[0] << " " << fluid_veloc[1]
               << "\n";
          OomphLibWarning(
            junk.str(), OOMPH_CURRENT_FUNCTION, OOMPH_EXCEPTION_LOCATION);
        }
      }
#endif
 
      // Get solid velocity from adjacent solid
      POROELASTICITY_BULK_ELEMENT* ext_el_pt =
        dynamic_cast<POROELASTICITY_BULK_ELEMENT*>(external_element_pt(0, ipt));
      Vector<double> s_ext(external_element_local_coord(0, ipt));
      Vector<double> du_dt(2), q(2);
      ext_el_pt->interpolated_du_dt(s_ext, du_dt);
      ext_el_pt->interpolated_q(s_ext, q);
 
      // Get the outer unit normal
      Vector<double> interpolated_normal(Dim);
      outer_unit_normal(ipt, interpolated_normal);
 
      // Calculate the unit tangent vector
      Vector<double> interpolated_tangent(Dim);
      interpolated_tangent[0] = -interpolated_normal[1];
      interpolated_tangent[1] = interpolated_normal[0];
 
      // Normal for poroelastic solid
      Vector<double> poro_normal(interpolated_normal);
 
      // Default geometry; evaluate everything in deformed (Nst) config.
      double lagrangian_eulerian_translation_factor = 1.0;
 
      // Get pointer to associated face element to get geometric information
      // from (if set up)
      FSILinearisedAxisymPoroelasticTractionElement<POROELASTICITY_BULK_ELEMENT,
                                                    FLUID_BULK_ELEMENT>*
        ext_face_el_pt =
          dynamic_cast<FSILinearisedAxisymPoroelasticTractionElement<
            POROELASTICITY_BULK_ELEMENT,
            FLUID_BULK_ELEMENT>*>(external_element_pt(1, ipt));
 
      // Update geometry
      if (ext_face_el_pt != 0)
      {
        Vector<double> s_ext_face(external_element_local_coord(1, ipt));
 
        /* #ifdef PARANOID */
 
        /*      Vector<double> x_face(2); */
        /*      x_face[0]=ext_face_el_pt->interpolated_x(s_ext_face,0); */
        /*      x_face[1]=ext_face_el_pt->interpolated_x(s_ext_face,1); */
 
        /*      Vector<double> x_bulk(2); */
        /*      x_bulk[0]=this->interpolated_x(s,0); */
        /*      x_bulk[1]=this->interpolated_x(s,1); */
 
        /*      double tol=1.0e-10; */
        /*      double
         * error=std::fabs(x_bulk[0]-x_face[0])+std::fabs(x_bulk[1]-x_face[1]);
         */
        /*      if (error>tol) */
        /*       { */
        /*        std::stringstream junk; */
        /*        junk  */
        /*         << "Difference in Eulerian coordinates: " << error  */
        /*         << " is suspiciously large: " */
        /*         << "Bulk: " <<  x_bulk[0] << " " << x_bulk[1] << " "  */
        /*         << "Face: " << x_face[0] << " " << x_face[1] << "\n";  */
        /*        OomphLibWarning(junk.str(), */
        /*                        OOMPH_CURRENT_FUNCTION, */
        /*                        OOMPH_EXCEPTION_LOCATION); */
        /*       } */
 
        /* #endif */
 
        // Get correction factor for geometry
        lagrangian_eulerian_translation_factor =
          ext_face_el_pt->lagrangian_eulerian_translation_factor(s_ext_face);
 
        // Get the outer unit normal
        ext_face_el_pt->outer_unit_normal(s_ext_face, poro_normal);
        poro_normal[0] = -poro_normal[0];
        poro_normal[1] = -poro_normal[1];
      }
 
 
      // Get permeability from the bulk poroelasticity element
      const double permeability = ext_el_pt->permeability();
      const double local_permeability_ratio = ext_el_pt->permeability_ratio();
 
      // We are given the normal and tangential components of the combined
      // poroelasticity "velocity" at the boundary from the BJS condition ---
      // calculate the vector in r-z coords from these
      double poro_normal_component = 0.0;
      double poro_tangential_component = 0.0;
 
      // Get the fluid traction from the NSt bulk element
      Vector<double> traction_nst(3);
      dynamic_cast<FLUID_BULK_ELEMENT*>(bulk_element_pt())
        ->traction(s_bulk, interpolated_normal, traction_nst);
 
      // Calculate the normal and tangential components
      for (unsigned i = 0; i < Dim; i++)
      {
        // Normal component computed with scaling factor for mass conservation
        poro_normal_component +=
          local_st *
          (du_dt[i] * interpolated_normal[i] +
           permeability * q[i] * lagrangian_eulerian_translation_factor *
             poro_normal[i]);
 
        // Leave this one alone... There isn't really much point
        // in trying to correct this.
        poro_tangential_component +=
          (local_st * du_dt[i] - traction_nst[i] *
                                   sqrt(local_permeability_ratio) *
                                   local_inverse_slip_rate_coeff) *
          interpolated_tangent[i];
      }
 
      // Get the normal and tangential nst components
      double nst_normal_component = 0.0;
      double nst_tangential_component = 0.0;
      for (unsigned i = 0; i < Dim; i++)
      {
        nst_normal_component += fluid_veloc[i] * interpolated_normal[i];
        nst_tangential_component += fluid_veloc[i] * interpolated_tangent[i];
      }
 
      // Setup bjs terms
      Vector<double> bjs_term(2);
      bjs_term[0] = nst_normal_component - poro_normal_component;
      bjs_term[1] = nst_tangential_component - poro_tangential_component;
 
      // Now add to the appropriate equations
 
      // Loop over the test functions
      for (unsigned l = 0; l < n_node; l++)
      {
        // Loop over directions
        for (unsigned i = 0; i < Dim + 1; i++)
        {
          // Add contribution to bulk Navier Stokes equations where
          // ------------------------------------------------------
          // the Lagrange multiplier acts as a traction
          // ------------------------------------------
          local_eqn = nodal_local_eqn(l, U_index_axisym_poroelastic_fsi[i]);
 
          /*IF it's not a boundary condition*/
          if (local_eqn >= 0)
          {
            // Add the Lagrange multiplier "traction" to the bulk
            residuals[local_eqn] -= lambda[i] * testf[l] * interpolated_r * W;
 
            // Jacobian entries
            if (flag)
            {
              throw OomphLibError("Jacobian not done yet",
                                  OOMPH_CURRENT_FUNCTION,
                                  OOMPH_EXCEPTION_LOCATION);
 
              // Loop over the lagrange multiplier unknowns
              for (unsigned l2 = 0; l2 < n_node; l2++)
              {
                // Cast to a boundary node
                BoundaryNodeBase* bnod_pt =
                  dynamic_cast<BoundaryNodeBase*>(node_pt(l2));
 
                // Local unknown
                int local_unknown = nodal_local_eqn(
                  l2,
                  bnod_pt->index_of_first_value_assigned_by_face_element(Id) +
                    i);
 
                // If it's not pinned
                if (local_unknown >= 0)
                {
                  jacobian(local_eqn, local_unknown) -=
                    psif[l2] * testf[l] * interpolated_r * W;
                }
              }
            }
          }
 
          // Now do the Lagrange multiplier equations
          //-----------------------------------------
          // Cast to a boundary node
          BoundaryNodeBase* bnod_pt =
            dynamic_cast<BoundaryNodeBase*>(node_pt(l));
 
          // Local eqn number:
          int local_eqn = nodal_local_eqn(
            l, bnod_pt->index_of_first_value_assigned_by_face_element(Id) + i);
 
          // If it's not pinned
          if (local_eqn >= 0)
          {
#ifdef PARANOID
            if (i == Dim)
            {
              std::stringstream junk;
              junk << "Elements have not been validated for nonzero swirl!\n";
              OomphLibWarning(
                junk.str(), OOMPH_CURRENT_FUNCTION, OOMPH_EXCEPTION_LOCATION);
            }
#endif
 
            residuals[local_eqn] += bjs_term[i] * testf(l) * interpolated_r * W;
 
            // Jacobian entries
            if (flag)
            {
              throw OomphLibError("Jacobian not done yet",
                                  OOMPH_CURRENT_FUNCTION,
                                  OOMPH_EXCEPTION_LOCATION);
 
              // Loop over the velocity unknowns [derivs w.r.t. to
              // wall velocity taken care of by fd-ing
              for (unsigned l2 = 0; l2 < n_node; l2++)
              {
                int local_unknown =
                  nodal_local_eqn(l2, U_index_axisym_poroelastic_fsi[i]);
 
                /*IF it's not a boundary condition*/
                if (local_unknown >= 0)
                {
                  jacobian(local_eqn, local_unknown) -=
                    psif[l2] * testf[l] * interpolated_r * W;
                }
              }
            }
          }
        }
      }
    }
  }
 
} // namespace oomph
 
 
#endif