Nektar++
StimulusCircle.cpp
Go to the documentation of this file.
1 ///////////////////////////////////////////////////////////////////////////////
2 //
3 // File StimulusCircle.cpp
4 //
5 // For more information, please see: http://www.nektar.info
6 //
7 // The MIT License
8 //
9 // Copyright (c) 2006 Division of Applied Mathematics, Brown University (USA),
10 // Department of Aeronautics, Imperial College London (UK), and Scientific
11 // Computing and Imaging Institute, University of Utah (USA).
12 //
13 // Permission is hereby granted, free of charge, to any person obtaining a
14 // copy of this software and associated documentation files (the "Software"),
15 // to deal in the Software without restriction, including without limitation
16 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
17 // and/or sell copies of the Software, and to permit persons to whom the
18 // Software is furnished to do so, subject to the following conditions:
19 //
20 // The above copyright notice and this permission notice shall be included
21 // in all copies or substantial portions of the Software.
22 //
23 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
24 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
26 // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
28 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
29 // DEALINGS IN THE SOFTWARE.
30 //
31 // Description: Circular stimulus file.
32 //
33 ///////////////////////////////////////////////////////////////////////////////
34 #include <iostream>
35 #include <tinyxml.h>
38 
39 namespace Nektar
40 {
41  std::string StimulusCirc::className
43  "StimulusCirc",
45  "Circular stimulus.");
46 
47  /**
48  * @class StimulusCirc
49  *
50  * The Stimulus class and derived classes implement a range of stimuli.
51  * The stimulus contains input stimuli that can be applied throughout the
52  * domain, on specified regions determined by the derived classes of
53  * Stimulus, at specified frequencies determined by the derived classes of
54  * Protocol.
55  */
56 
57  /**
58  * Stimulus base class constructor.
59  */
62  const MultiRegions::ExpListSharedPtr& pField,
63  const TiXmlElement* pXml)
64  : Stimulus(pSession, pField, pXml)
65  {
66  m_session = pSession;
67  m_field = pField;
68  m_nq = pField->GetTotPoints();
69  m_chiCapMembrane = m_session->GetParameter("chi")
70  * m_session->GetParameter("Cm");
71 
72  if (!pXml)
73  {
74  return;
75  }
76 
77  const TiXmlElement *pXmlparameter;
78 
79  pXmlparameter = pXml->FirstChildElement("p_x1");
80  m_px1 = atof(pXmlparameter->GetText());
81 
82  pXmlparameter = pXml->FirstChildElement("p_y1");
83  m_py1 = atof(pXmlparameter->GetText());
84 
85  pXmlparameter = pXml->FirstChildElement("p_z1");
86  m_pz1 = atof(pXmlparameter->GetText());
87 
88  pXmlparameter = pXml->FirstChildElement("p_r1");
89  m_pr1 = atof(pXmlparameter->GetText());
90 
91  pXmlparameter = pXml->FirstChildElement("p_is");
92  m_pis = atof(pXmlparameter->GetText());
93 
94  pXmlparameter = pXml->FirstChildElement("p_strength");
95  m_strength = atof(pXmlparameter->GetText());
96  }
97 
98 
99  /**
100  * Initialise the stimulus. Allocate workspace and variable storage.
101  */
103  {
104  }
105 
106 
107  /**
108  *
109  */
111  const NekDouble time)
112  {
113  // Get the dimension of the expansion
114  int dim = m_field->GetCoordim(0);
115 
116  //Retrieve coodrinates of quadrature points
117  int nq = m_field->GetNpoints();
118  Array<OneD,NekDouble> x0(nq);
119  Array<OneD,NekDouble> x1(nq);
120  Array<OneD,NekDouble> x2(nq);
121 
122  // Get the protocol amplitude
123  NekDouble v_amp = m_Protocol->GetAmplitude(time) * m_strength;
124 
125  // get the coordinates
126  m_field->GetCoords(x0,x1,x2);
127 
128  switch (dim)
129  {
130  case 1:
131  for(int j=0; j<nq; j++)
132  {
133  outarray[0][j] += v_amp
134  * ( -tanh( (m_pis * x0[j] - m_px1 + m_pr1)
135  * (m_pis * x0[j] - m_px1 - m_pr1)
136  ) / 2.0 + 0.5 );
137  }
138  break;
139  case 2:
140  for(int j=0; j<nq; j++)
141  {
142  outarray[0][j] += v_amp
143  * ( -tanh( (m_pis * x0[j] - m_px1+m_pr1)
144  * (m_pis * x0[j] - m_px1-m_pr1)
145  + (m_pis * x1[j] - m_py1+m_pr1)
146  * (m_pis * x1[j] - m_py1-m_pr1)
147  ) / 2.0 + 0.5 );
148  }
149  break;
150  case 3:
151  for(int j=0; j<nq; j++)
152  {
153  outarray[0][j] += v_amp
154  * ( -tanh( (m_pis * x0[j] - m_px1+m_pr1)
155  * (m_pis * x0[j] - m_px1-m_pr1)
156  + (m_pis * x1[j] - m_py1+m_pr1)
157  * (m_pis * x1[j] - m_py1-m_pr1)
158  + (m_pis * x2[j] - m_pz1+m_pr1)
159  * (m_pis * x2[j] - m_pz1-m_pr1)
160  ) / 2.0 + 0.5 );
161  }
162  break;
163  }
164  }
165 
166 
167  /**
168  *
169  */
171  {
172  }
173 }
tKey RegisterCreatorFunction(tKey idKey, CreatorFunction classCreator, std::string pDesc="")
Register a class with the factory.
Definition: NekFactory.hpp:200
void Initialise()
Initialise the protocol storage and set initial conditions.
virtual void v_GenerateSummary(SolverUtils::SummaryList &s)
StimulusCirc(const LibUtilities::SessionReaderSharedPtr &pSession, const MultiRegions::ExpListSharedPtr &pField, const TiXmlElement *pXml)
virtual void v_Update(Array< OneD, Array< OneD, NekDouble > > &outarray, const NekDouble time)
static StimulusSharedPtr create(const LibUtilities::SessionReaderSharedPtr &pSession, const MultiRegions::ExpListSharedPtr &pField, const TiXmlElement *pXml)
Creates an instance of this class.
NekDouble m_chiCapMembrane
static std::string className
Name of class.
Stimulus base class.
Definition: Stimulus.h:66
MultiRegions::ExpListSharedPtr m_field
Transmembrane potential field from PDE system.
Definition: Stimulus.h:94
ProtocolSharedPtr m_Protocol
Stimulus protocol to apply.
Definition: Stimulus.h:98
int m_nq
Number of physical points.
Definition: Stimulus.h:96
LibUtilities::SessionReaderSharedPtr m_session
Session.
Definition: Stimulus.h:92
std::shared_ptr< SessionReader > SessionReaderSharedPtr
std::shared_ptr< ExpList > ExpListSharedPtr
Shared pointer to an ExpList object.
std::vector< std::pair< std::string, std::string > > SummaryList
Definition: Misc.h:46
The above copyright notice and this permission notice shall be included.
Definition: CoupledSolver.h:1
StimulusFactory & GetStimulusFactory()
Definition: Stimulus.cpp:44
double NekDouble