Nektar::Utilities::ProcessWSS Class Reference

This processing module calculates the wall shear stress and adds it as an extra-field to the output file, and writes it to a surface output file. More...

#include <ProcessWSS.h>

Inheritance diagram for Nektar::Utilities::ProcessWSS:

Collaboration diagram for Nektar::Utilities::ProcessWSS:

Public Member Functions
	ProcessWSS (FieldSharedPtr f)
virtual	~ProcessWSS ()
virtual void	Process (po::variables_map &vm)
	Write mesh to output file. More...
virtual std::string	GetModuleName ()
Public Member Functions inherited from Nektar::Utilities::ProcessModule
	ProcessModule ()
	ProcessModule (FieldSharedPtr p_f)
	ProcessModule (MeshSharedPtr p_m)
Public Member Functions inherited from Nektar::Utilities::Module
	Module (FieldSharedPtr p_f)
void	RegisterConfig (string key, string value)
	Register a configuration option with a module. More...
void	PrintConfig ()
	Print out all configuration options for a module. More...
void	SetDefaults ()
	Sets default configuration options for those which have not been set. More...
bool	GetRequireEquiSpaced (void)
void	SetRequireEquiSpaced (bool pVal)
void	EvaluateTriFieldAtEquiSpacedPts (LocalRegions::ExpansionSharedPtr &exp, const Array< OneD, const NekDouble > &infield, Array< OneD, NekDouble > &outfield)
	Module (MeshSharedPtr p_m)
virtual void	Process ()=0
void	RegisterConfig (std::string key, std::string value)
void	PrintConfig ()
void	SetDefaults ()
MeshSharedPtr	GetMesh ()
virtual void	ProcessVertices ()
	Extract element vertices. More...
virtual void	ProcessEdges (bool ReprocessEdges=true)
	Extract element edges. More...
virtual void	ProcessFaces (bool ReprocessFaces=true)
	Extract element faces. More...
virtual void	ProcessElements ()
	Generate element IDs. More...
virtual void	ProcessComposites ()
	Generate composites. More...
virtual void	ClearElementLinks ()

Static Public Member Functions
static boost::shared_ptr< Module >	create (FieldSharedPtr f)
	Creates an instance of this class. More...

Static Public Attributes
static ModuleKey	className

Additional Inherited Members
Protected Member Functions inherited from Nektar::Utilities::Module
	Module ()
void	ReorderPrisms (PerMap &perFaces)
	Reorder node IDs so that prisms and tetrahedra are aligned correctly. More...
void	PrismLines (int prism, PerMap &perFaces, std::set< int > &prismsDone, std::vector< ElementSharedPtr > &line)
Protected Attributes inherited from Nektar::Utilities::Module
FieldSharedPtr	m_f
	Field object. More...
map< string, ConfigOption >	m_config
	List of configuration values. More...
bool	m_requireEquiSpaced
MeshSharedPtr	m_mesh
	Mesh object. More...
std::map< std::string, ConfigOption >	m_config
	List of configuration values. More...

Detailed Description

This processing module calculates the wall shear stress and adds it as an extra-field to the output file, and writes it to a surface output file.

Definition at line 50 of file ProcessWSS.h.

Constructor & Destructor Documentation

Nektar::Utilities::ProcessWSS::ProcessWSS

(

FieldSharedPtr

f

)

Definition at line 56 of file ProcessWSS.cpp.

References Nektar::Utilities::Module::m_config, and Nektar::Utilities::Module::m_f.

                                       : ProcessModule(f)
{
    m_config["bnd"] = ConfigOption(false,"All","Boundary to be extracted");
    m_config["addnormals"] = ConfigOption(true,"NotSet","Add normals to output");
    f->m_writeBndFld = true;
    f->m_declareExpansionAsContField = true;
    f->m_requireBoundaryExpansion = true;
    m_f->m_fldToBnd = false;
}

Nektar::Utilities::ProcessWSS::~ProcessWSS ( )

virtual

Definition at line 66 of file ProcessWSS.cpp.

{
}

Member Function Documentation

static boost::shared_ptr<Module> Nektar::Utilities::ProcessWSS::create ( FieldSharedPtr  f )

inlinestatic

Creates an instance of this class.

Definition at line 54 of file ProcessWSS.h.

References Nektar::MemoryManager< DataType >::AllocateSharedPtr().

                                                                {
            return MemoryManager<ProcessWSS>::AllocateSharedPtr(f);
        }

virtual std::string Nektar::Utilities::ProcessWSS::GetModuleName ( )

inlinevirtual

Implements Nektar::Utilities::Module.

Definition at line 65 of file ProcessWSS.h.

        {
            return "ProcessWSS";
        }

void Nektar::Utilities::ProcessWSS::Process ( po::variables_map &  vm )

virtual

Write mesh to output file.

Implements Nektar::Utilities::Module.

Definition at line 70 of file ProcessWSS.cpp.

References ASSERTL0, Nektar::ParseUtils::GenerateOrderedVector(), Nektar::SpatialDomains::BoundaryConditions::GetBoundaryRegions(), Nektar::Utilities::Module::m_config, Nektar::Utilities::Module::m_f, Vmath::Neg(), Vmath::Smul(), Vmath::Vadd(), Vmath::Vsqrt(), Vmath::Vvtvp(), and Vmath::Zero().

{
    if (m_f->m_verbose)
    {
        if(m_f->m_comm->TreatAsRankZero())
        {
            cout << "ProcessWSS: Calculating wall shear stress..." << endl;
        }
    }

    m_f->m_addNormals = m_config["addnormals"].m_beenSet;

    // Set up Field options to output boundary fld
    string bvalues =  m_config["bnd"].as<string>();

    if(bvalues.compare("All") == 0)
    {
        Array<OneD, const MultiRegions::ExpListSharedPtr>
            BndExp = m_f->m_exp[0]->GetBndCondExpansions();

        for(int i = 0; i < BndExp.num_elements(); ++i)
        {
            m_f->m_bndRegionsToWrite.push_back(i);
        }
    }
    else
    {
        ASSERTL0(ParseUtils::GenerateOrderedVector(bvalues.c_str(),
                                                   m_f->m_bndRegionsToWrite),"Failed to interpret range string");
    }

    NekDouble kinvis = m_f->m_session->GetParameter("Kinvis");

    int i, j;
    int spacedim  = m_f->m_graph->GetSpaceDimension();
    if ((m_f->m_fielddef[0]->m_numHomogeneousDir) == 1 ||
        (m_f->m_fielddef[0]->m_numHomogeneousDir) == 2)
    {
        spacedim += m_f->m_fielddef[0]->m_numHomogeneousDir;
    }

    int nfields = m_f->m_fielddef[0]->m_fields.size();
    ASSERTL0(m_f->m_fielddef[0]->m_fields[0] == "u","Implicit assumption that input is in incompressible format of (u,v,p) or (u,v,w,p)");

    if (spacedim == 1)
    {
        ASSERTL0(false, "Error: wss for a 1D problem cannot "
                 "be computed");
    }

    int newfields = spacedim + 1;
    int nshear    = spacedim + 1;
    int nstress   = spacedim*spacedim;
    int ngrad     = spacedim*spacedim;

    Array<OneD, Array<OneD, NekDouble> > velocity(nfields), grad(ngrad), fgrad(ngrad);
    Array<OneD, Array<OneD, NekDouble> > stress(nstress), fstress(nstress);
    Array<OneD, Array<OneD, NekDouble> > fshear(nshear);
    
    Array<OneD, MultiRegions::ExpListSharedPtr> BndExp(newfields);
    Array<OneD, MultiRegions::ExpListSharedPtr> BndElmtExp(spacedim);
    
    // Extract original fields to boundary (for output)
    for (int i = 0; i < m_f->m_exp.size(); ++i)
    {
        m_f->m_exp[i]->FillBndCondFromField();
    }

    m_f->m_exp.resize(nfields + newfields);
    string var = "u";
    for(i = 0; i < newfields; ++i)
    {
        m_f->m_exp[nfields + i] = m_f->AppendExpList(m_f->m_fielddef[0]->m_numHomogeneousDir, var);
    }

    if(spacedim == 2)
    {
        m_f->m_fielddef[0]->m_fields.push_back("Shear_x");
        m_f->m_fielddef[0]->m_fields.push_back("Shear_y");
        m_f->m_fielddef[0]->m_fields.push_back("Shear_mag");
    }
    else
    {
        m_f->m_fielddef[0]->m_fields.push_back("Shear_x");
        m_f->m_fielddef[0]->m_fields.push_back("Shear_y");
        m_f->m_fielddef[0]->m_fields.push_back("Shear_z");
        m_f->m_fielddef[0]->m_fields.push_back("Shear_mag");
    }

    // Create map of boundary ids for partitioned domains
    SpatialDomains::BoundaryConditions bcs(m_f->m_session,
                                           m_f->m_exp[0]->GetGraph());
    const SpatialDomains::BoundaryRegionCollection bregions  =
                                                bcs.GetBoundaryRegions();
    SpatialDomains::BoundaryRegionCollection::const_iterator breg_it;
    map<int,int> BndRegionMap;
    int cnt =0;
    for(breg_it = bregions.begin(); breg_it != bregions.end();
            ++breg_it, ++cnt)
    {
        BndRegionMap[breg_it->first] = cnt;
    }
    // Loop over boundaries to Write
    for(int b = 0; b < m_f->m_bndRegionsToWrite.size(); ++b)
    {
        if(BndRegionMap.count(m_f->m_bndRegionsToWrite[b]) == 1)
        {
            int bnd = BndRegionMap[m_f->m_bndRegionsToWrite[b]];
            // Get expansion list for boundary and for elements containing this bnd
            for(i = 0; i < newfields; i++)
            {
                BndExp[i]   = m_f->m_exp[nfields + i]->UpdateBndCondExpansion(bnd);
            }
            for(i = 0; i < spacedim; i++)
            {
                m_f->m_exp[i]->GetBndElmtExpansion(bnd, BndElmtExp[i]);
            }

            // Get number of points in expansions
            int nqb = BndExp[0]->GetTotPoints();
            int nqe = BndElmtExp[0]->GetTotPoints();

            // Initialise local arrays for the velocity gradients, and stress components
            // size of total number of quadrature points for elements in this bnd
            for(i = 0; i < ngrad; ++i)
            {
                grad[i] = Array<OneD, NekDouble>(nqe);
            }

            for(i = 0; i < nstress; ++i)
            {
                stress[i] = Array<OneD, NekDouble>(nqe);
            }

            // initialise arrays in the boundary
            for(i = 0; i < nstress; ++i)
            {
                fstress[i] = Array<OneD, NekDouble>(nqb);
            }

            for(i = 0; i < ngrad; ++i)
            {
                fgrad[i] = Array<OneD, NekDouble>(nqb);
            }

            for(i = 0; i < nshear; ++i)
            {
                fshear[i] = Array<OneD, NekDouble>(nqb, 0.0);
            }

            //Extract Velocities
            for(i = 0; i < spacedim; ++i)
            {
                velocity[i] = BndElmtExp[i]->GetPhys();
            }

            //Compute gradients (velocity correction scheme method)
            for(i = 0; i < spacedim; ++i)
            {
                if (spacedim == 2)
                {
                    BndElmtExp[i]->PhysDeriv(velocity[i],grad[i*spacedim+0],
                                                         grad[i*spacedim+1]);
                }
                else
                {
                    BndElmtExp[i]->PhysDeriv(velocity[i],grad[i*spacedim+0],
                                                         grad[i*spacedim+1],
                                                         grad[i*spacedim+2]);
                }
            }

             //Compute stress component terms  tau_ij = mu*(u_i,j + u_j,i)
            for(i = 0; i < spacedim; ++i)
            {
                for(j = 0; j < spacedim; ++j)
                {
                    Vmath::Vadd(nqe, grad[i*spacedim+j], 1,
                                     grad[j*spacedim+i], 1,
                                     stress[i*spacedim+j], 1);

                    Vmath::Smul(nqe, kinvis, stress[i*spacedim+j], 1,
                                               stress[i*spacedim+j], 1);
                }
            }

            // Get boundary stress values.
            for(j = 0; j < nstress; ++j)
            {
                m_f->m_exp[0]->ExtractElmtToBndPhys(bnd, stress[j],fstress[j]);
            }

            //Get normals
            Array<OneD, Array<OneD, NekDouble> > normals; 
            m_f->m_exp[0]->GetBoundaryNormals(bnd, normals);
            // Reverse normals, to get correct orientation for the body
            for(i = 0; i < spacedim; ++i)
            {
                Vmath::Neg(nqb, normals[i], 1);
            }

            //calculate wss, and update coeffs in the boundary expansion
            // S = tau_ij * n_j
            for(i = 0; i < spacedim; ++i)
            {
                for(j = 0; j < spacedim; ++j)
                {
                    Vmath::Vvtvp(nqb,normals[j],1,fstress[i*spacedim+j],1,
                                                  fshear[i],1,
                                                  fshear[i],1);
                }
            }

            // T = S - (S.n)n
            for(i = 0; i < spacedim; ++i)
            {
                Vmath::Vvtvp(nqb,normals[i],1,fshear[i],1,
                                              fshear[nshear-1],1,
                                              fshear[nshear-1],1);
            }
            Vmath::Smul(nqb, -1.0, fshear[nshear-1], 1, fshear[nshear-1], 1);

            for (i = 0; i < spacedim; i++)
            {
                Vmath::Vvtvp(nqb,normals[i], 1, fshear[nshear-1], 1,
                                                fshear[i], 1,
                                                fshear[i], 1);
                BndExp[i]->FwdTrans(fshear[i], 
                                    BndExp[i]->UpdateCoeffs());
            }

            // Tw
            Vmath::Zero(nqb, fshear[nshear-1], 1);
            for(i = 0; i < spacedim; ++i)
            {
                Vmath::Vvtvp(nqb,fshear[i],1,fshear[i],1,
                                             fshear[nshear-1],1,
                                             fshear[nshear-1],1);
            }
            Vmath::Vsqrt(nqb, fshear[nshear-1], 1, fshear[nshear-1], 1);
            BndExp[nshear-1]->FwdTrans(fshear[nshear-1], 
                                     BndExp[nshear-1]->UpdateCoeffs());
        }
    }
}

Member Data Documentation

ModuleKey Nektar::Utilities::ProcessWSS::className

static

Initial value:

=
    GetModuleFactory().RegisterCreatorFunction(
        ModuleKey(eProcessModule, "wss"),
        ProcessWSS::create, "Computes wall shear stress field.")

Definition at line 57 of file ProcessWSS.h.