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 ///////////////////////////////////////////////////////////////////////////////
36 #include <iostream>
37 #include <tinyxml.h>
38 
39 namespace Nektar
40 {
41 std::string StimulusCirc::className =
43  "StimulusCirc", StimulusCirc::create, "Circular stimulus.");
44 
45 /**
46  * @class StimulusCirc
47  *
48  * The Stimulus class and derived classes implement a range of stimuli.
49  * The stimulus contains input stimuli that can be applied throughout the
50  * domain, on specified regions determined by the derived classes of
51  * Stimulus, at specified frequencies determined by the derived classes of
52  * Protocol.
53  */
54 
55 /**
56  * Stimulus base class constructor.
57  */
59  const MultiRegions::ExpListSharedPtr &pField,
60  const TiXmlElement *pXml)
61  : Stimulus(pSession, pField, pXml)
62 {
63  m_session = pSession;
64  m_field = pField;
65  m_nq = pField->GetTotPoints();
67  m_session->GetParameter("chi") * m_session->GetParameter("Cm");
68 
69  if (!pXml)
70  {
71  return;
72  }
73 
74  const TiXmlElement *pXmlparameter;
75 
76  pXmlparameter = pXml->FirstChildElement("p_x1");
77  m_px1 = atof(pXmlparameter->GetText());
78 
79  pXmlparameter = pXml->FirstChildElement("p_y1");
80  m_py1 = atof(pXmlparameter->GetText());
81 
82  pXmlparameter = pXml->FirstChildElement("p_z1");
83  m_pz1 = atof(pXmlparameter->GetText());
84 
85  pXmlparameter = pXml->FirstChildElement("p_r1");
86  m_pr1 = atof(pXmlparameter->GetText());
87 
88  pXmlparameter = pXml->FirstChildElement("p_is");
89  m_pis = atof(pXmlparameter->GetText());
90 
91  pXmlparameter = pXml->FirstChildElement("p_strength");
92  m_strength = atof(pXmlparameter->GetText());
93 }
94 
95 /**
96  * Initialise the stimulus. Allocate workspace and variable storage.
97  */
99 {
100 }
101 
102 /**
103  *
104  */
106  const NekDouble time)
107 {
108  // Get the dimension of the expansion
109  int dim = m_field->GetCoordim(0);
110 
111  // Retrieve coodrinates of quadrature points
112  int nq = m_field->GetNpoints();
113  Array<OneD, NekDouble> x0(nq);
114  Array<OneD, NekDouble> x1(nq);
115  Array<OneD, NekDouble> x2(nq);
116 
117  // Get the protocol amplitude
118  NekDouble v_amp = m_Protocol->GetAmplitude(time) * m_strength;
119 
120  // get the coordinates
121  m_field->GetCoords(x0, x1, x2);
122 
123  switch (dim)
124  {
125  case 1:
126  for (int j = 0; j < nq; j++)
127  {
128  outarray[0][j] +=
129  v_amp * (-tanh((m_pis * x0[j] - m_px1 + m_pr1) *
130  (m_pis * x0[j] - m_px1 - m_pr1)) /
131  2.0 +
132  0.5);
133  }
134  break;
135  case 2:
136  for (int j = 0; j < nq; j++)
137  {
138  outarray[0][j] +=
139  v_amp * (-tanh((m_pis * x0[j] - m_px1 + m_pr1) *
140  (m_pis * x0[j] - m_px1 - m_pr1) +
141  (m_pis * x1[j] - m_py1 + m_pr1) *
142  (m_pis * x1[j] - m_py1 - m_pr1)) /
143  2.0 +
144  0.5);
145  }
146  break;
147  case 3:
148  for (int j = 0; j < nq; j++)
149  {
150  outarray[0][j] +=
151  v_amp * (-tanh((m_pis * x0[j] - m_px1 + m_pr1) *
152  (m_pis * x0[j] - m_px1 - m_pr1) +
153  (m_pis * x1[j] - m_py1 + m_pr1) *
154  (m_pis * x1[j] - m_py1 - m_pr1) +
155  (m_pis * x2[j] - m_pz1 + m_pr1) *
156  (m_pis * x2[j] - m_pz1 - m_pr1)) /
157  2.0 +
158  0.5);
159  }
160  break;
161  }
162 }
163 
164 /**
165  *
166  */
168 {
169  boost::ignore_unused(s);
170 }
171 } // namespace Nektar
tKey RegisterCreatorFunction(tKey idKey, CreatorFunction classCreator, std::string pDesc="")
Register a class with the factory.
Definition: NekFactory.hpp:198
void Initialise()
Initialise the protocol storage and set initial conditions.
virtual void v_Update(Array< OneD, Array< OneD, NekDouble >> &outarray, const NekDouble time) override
StimulusCirc(const LibUtilities::SessionReaderSharedPtr &pSession, const MultiRegions::ExpListSharedPtr &pField, const TiXmlElement *pXml)
static StimulusSharedPtr create(const LibUtilities::SessionReaderSharedPtr &pSession, const MultiRegions::ExpListSharedPtr &pField, const TiXmlElement *pXml)
Creates an instance of this class.
virtual void v_GenerateSummary(SolverUtils::SummaryList &s) override
NekDouble m_chiCapMembrane
static std::string className
Name of class.
Stimulus base class.
Definition: Stimulus.h:65
MultiRegions::ExpListSharedPtr m_field
Transmembrane potential field from PDE system.
Definition: Stimulus.h:95
ProtocolSharedPtr m_Protocol
Stimulus protocol to apply.
Definition: Stimulus.h:99
int m_nq
Number of physical points.
Definition: Stimulus.h:97
LibUtilities::SessionReaderSharedPtr m_session
Session.
Definition: Stimulus.h:93
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:48
The above copyright notice and this permission notice shall be included.
Definition: CoupledSolver.h:2
StimulusFactory & GetStimulusFactory()
Definition: Stimulus.cpp:44
double NekDouble