/home/runner/work/amr-wind/amr-wind/amr-wind/wind_energy/ABLBoundaryPlane.H Source File

AMR-Wind API: /home/runner/work/amr-wind/amr-wind/amr-wind/wind_energy/ABLBoundaryPlane.H Source File
AMR-Wind API v0.1.0
CFD solver for wind plant simulations
ABLBoundaryPlane.H
Go to the documentation of this file.
1#ifndef ABLBOUNDARYPLANE_H
2#define ABLBOUNDARYPLANE_H
3
5#include "amr-wind/CFDSim.H"
6#include "AMReX_Gpu.H"
9#include <AMReX_BndryRegister.H>
10
12class MultiBlockContainer;
13namespace amr_wind {
14
15enum struct io_mode { output, input, undefined };
16
18{
19 amrex::Gpu::ManagedVector<amrex::Real> data;
20 amrex::Vector<size_t> start{0, 0, 0, 0};
21 amrex::Vector<size_t> count{0, 0, 0, 0};
22};
23
31{
32 using PlaneVector = amrex::Vector<amrex::FArrayBox>;
33
34public:
35 InletData() = default;
36
37 void resize(const int /*size*/);
38
39 void define_plane(const amrex::Orientation /*ori*/);
40
42 const amrex::Orientation /*ori*/,
43 const amrex::Box& /*bx*/,
44 const size_t /*nc*/);
45
46#ifdef AMR_WIND_USE_NETCDF
47 void read_data(
48 ncutils::NCGroup& /*grp*/,
49 const amrex::Orientation /*ori*/,
50 const int /*lev*/,
51 const Field* /*fld*/,
52 const amrex::Real /*time*/,
53 const amrex::Vector<amrex::Real>& /*times*/);
54#endif
55
57 const amrex::OrientationIter oit,
58 amrex::BndryRegister& bndry_n,
59 amrex::BndryRegister& bndry_np1,
60 const int lev,
61 const Field* /*fld*/,
62 const amrex::Real time,
63 const amrex::Vector<amrex::Real>& /*times*/);
64
65 void interpolate(const amrex::Real /*time*/);
66 bool is_populated(amrex::Orientation /*ori*/) const;
67 const amrex::FArrayBox&
68 interpolate_data(const amrex::Orientation ori, const int lev) const
69 {
70 return (*m_data_interp[ori])[lev];
71 }
72
73 int& component(const int id) { return m_components[id]; }
74
75 int component(const int id) const { return m_components.at(id); }
76
77 int nlevels(const amrex::Orientation ori) const
78 {
79 return static_cast<int>((*m_data_interp[ori]).size());
80 }
81
82 amrex::Real tn() const { return m_tn; }
83 amrex::Real tnp1() const { return m_tnp1; }
84 amrex::Real tinterp() const { return m_tinterp; }
85
86private:
87 amrex::Vector<std::unique_ptr<PlaneVector>> m_data_n;
88 amrex::Vector<std::unique_ptr<PlaneVector>> m_data_np1;
89 amrex::Vector<std::unique_ptr<PlaneVector>> m_data_interp;
90
92 amrex::Real m_tn{-1.0};
93
95 amrex::Real m_tnp1{-1.0};
96
98 amrex::Real m_tinterp{-1.0};
99
101 std::unordered_map<int, int> m_components;
102};
103
113{
114 static_assert(AMREX_SPACEDIM == 3, "ABL requires 3 dimensional mesh");
115
116public:
117 explicit ABLBoundaryPlane(CFDSim& /*sim*/);
118
120 void post_init_actions();
121
122 void pre_advance_work();
123
124 void pre_predictor_work();
125
126 void post_advance_work();
127
128 void initialize_data();
129
130 void write_header();
131
132 void write_bndry_native_header(const std::string& chkname);
133
134 void write_file();
135
136 void read_header();
137
138 amrex::Vector<amrex::BoxArray> read_bndry_native_boxarrays(
139 const std::string& chkname, const Field& field) const;
140
141 void read_file(const bool /* nph_target_time*/);
142
143 void populate_data(
144 const int /*lev*/,
145 const amrex::Real /*time*/,
146 Field& /*fld*/,
147 amrex::MultiFab& /*mfab*/,
148 const int dcomp = 0,
149 const int orig_comp = 0) const;
150
151#ifdef AMR_WIND_USE_NETCDF
152 static void impl_buffer_field(
153 const amrex::Box& /*bx*/,
154 const int /*n1*/,
155 const int /*nc*/,
156 const amrex::GpuArray<int, 2>& /*perp*/,
157 const amrex::IntVect& /*v_offset*/,
158 const amrex::Array4<const amrex::Real>& /*fld*/,
159 amrex::Gpu::ManagedVector<amrex::Real>& /*buffer*/);
160#endif
161
162 bool is_initialized() const { return m_is_initialized; }
163
165 const amrex::Box& /*bx*/,
166 const int /*lev*/,
167 const amrex::Orientation /*ori*/) const;
168
169 bool is_data_newer_than(const amrex::Real time) const
170 {
171 return (m_in_data.tinterp() - time > 1e-12);
172 }
173
174 io_mode mode() const { return m_io_mode; }
175
176 MultiBlockContainer* mbc()
177 {
178 // Make sure that the double pointer m_mbc
179 // does not point to a nullptr
180 // before passing *m_mbc for use
181 if ((*m_mbc) == nullptr) {
182 amrex::Abort("Passing a null pointer for use!");
183 }
184 return *m_mbc;
185 }
186
187private:
190 const amrex::AmrCore& m_mesh;
191
192 // pointer to pointer : when ABL boundary plane gets initialized, amr-wind
193 // CFDsim does not yet have the up to date pointer to the mbc or the
194 // read_erf function, hence the use of double pointers
195 MultiBlockContainer** m_mbc;
197
198#ifdef AMR_WIND_USE_NETCDF
199 void write_data(
200 const ncutils::NCGroup& grp,
201 const amrex::Orientation /*ori*/,
202 const int /*lev*/,
203 const Field* /*fld*/);
204#endif
205 int boundary_native_file_levels() const;
206
207 std::string m_title{"ABL boundary planes"};
208
211
213 amrex::Vector<std::string> m_plane_names{"xlo", "ylo", "zlo",
214 "xhi", "yhi", "zhi"};
215
217 amrex::Vector<std::string> m_planes;
218
220 amrex::Real m_out_start_time{0.0};
221
222#ifdef AMR_WIND_USE_NETCDF
224 size_t m_out_counter{0};
225#endif
226
228 std::string m_filename;
229
231 std::string m_time_file;
232
234 amrex::Vector<std::string> m_var_names;
235
237 amrex::Vector<Field*> m_fields;
238
240 amrex::Vector<amrex::Real> m_in_times;
241 amrex::Vector<int> m_in_timesteps;
242
245
248
250 bool m_is_initialized{false};
251
253 const int m_in_rad = 1;
254 const int m_out_rad = 1;
255 const int m_extent_rad = 0;
256
258 std::string m_out_fmt{"native"};
259};
260
261} // namespace amr_wind
262
263#endif /* ABLBOUNDARYPLANE_H */
std::function< void( const amrex::Real time, amrex::Vector< amrex::Real > &, amr_wind::InletData &, const amrex::Vector< amr_wind::Field * > &, MultiBlockContainer *)> ReadERFFunction
Definition ABLReadERFFunction.H:10
Definition ABLBoundaryPlane.H:113
bool box_intersects_boundary(const amrex::Box &, const int, const amrex::Orientation) const
True if box intersects the boundary.
Definition ABLBoundaryPlane.cpp:1562
const int m_extent_rad
Definition ABLBoundaryPlane.H:255
void read_header()
Definition ABLBoundaryPlane.cpp:737
void write_bndry_native_header(const std::string &chkname)
Definition ABLBoundaryPlane.cpp:531
io_mode mode() const
Definition ABLBoundaryPlane.H:174
amrex::Vector< std::string > m_var_names
Variables for IO.
Definition ABLBoundaryPlane.H:234
std::string m_time_file
File name for Native time file.
Definition ABLBoundaryPlane.H:231
const int m_in_rad
controls extents on native bndry output
Definition ABLBoundaryPlane.H:253
void post_init_actions()
Execute initialization actions after mesh has been fully generated.
Definition ABLBoundaryPlane.cpp:341
std::string m_out_fmt
output format for bndry output
Definition ABLBoundaryPlane.H:258
InletData m_in_data
Inlet data.
Definition ABLBoundaryPlane.H:244
MultiBlockContainer ** m_mbc
Definition ABLBoundaryPlane.H:195
void pre_advance_work()
Definition ABLBoundaryPlane.cpp:353
size_t m_out_counter
NetCDF time output counter.
Definition ABLBoundaryPlane.H:224
amrex::Vector< Field * > m_fields
List of fields for IO.
Definition ABLBoundaryPlane.H:237
int m_write_frequency
Normal direction for the boundary plane.
Definition ABLBoundaryPlane.H:210
void post_advance_work()
Definition ABLBoundaryPlane.cpp:369
bool is_initialized() const
Definition ABLBoundaryPlane.H:162
io_mode m_io_mode
IO mode.
Definition ABLBoundaryPlane.H:247
const int m_out_rad
Definition ABLBoundaryPlane.H:254
amrex::Vector< std::string > m_planes
IO boundary planes.
Definition ABLBoundaryPlane.H:217
void populate_data(const int, const amrex::Real, Field &, amrex::MultiFab &, const int dcomp=0, const int orig_comp=0) const
Definition ABLBoundaryPlane.cpp:1302
void write_data(const ncutils::NCGroup &grp, const amrex::Orientation, const int, const Field *)
Definition ABLBoundaryPlane.cpp:1403
static void impl_buffer_field(const amrex::Box &, const int, const int, const amrex::GpuArray< int, 2 > &, const amrex::IntVect &, const amrex::Array4< const amrex::Real > &, amrex::Gpu::ManagedVector< amrex::Real > &)
Definition ABLBoundaryPlane.cpp:1522
int boundary_native_file_levels() const
Definition ABLBoundaryPlane.cpp:1545
ABLBoundaryPlane(CFDSim &)
Definition ABLBoundaryPlane.cpp:287
void pre_predictor_work()
Definition ABLBoundaryPlane.cpp:361
amrex::Vector< int > m_in_timesteps
Definition ABLBoundaryPlane.H:241
amrex::Vector< amrex::Real > m_in_times
NetCDF input level time.
Definition ABLBoundaryPlane.H:240
amrex::Vector< amrex::BoxArray > read_bndry_native_boxarrays(const std::string &chkname, const Field &field) const
Definition ABLBoundaryPlane.cpp:953
ReadERFFunction * m_read_erf
Definition ABLBoundaryPlane.H:196
const amrex::AmrCore & m_mesh
Definition ABLBoundaryPlane.H:190
const FieldRepo & m_repo
Definition ABLBoundaryPlane.H:189
void write_file()
Definition ABLBoundaryPlane.cpp:620
const amr_wind::SimTime & m_time
Definition ABLBoundaryPlane.H:188
std::string m_filename
File name for IO.
Definition ABLBoundaryPlane.H:228
void write_header()
Definition ABLBoundaryPlane.cpp:399
MultiBlockContainer * mbc()
Definition ABLBoundaryPlane.H:176
void initialize_data()
Definition ABLBoundaryPlane.cpp:377
amrex::Real m_out_start_time
Start outputting after this time.
Definition ABLBoundaryPlane.H:220
amrex::Vector< std::string > m_plane_names
Plane names.
Definition ABLBoundaryPlane.H:213
std::string m_title
Definition ABLBoundaryPlane.H:207
bool m_is_initialized
Flag indicating if this capability is available.
Definition ABLBoundaryPlane.H:250
bool is_data_newer_than(const amrex::Real time) const
Definition ABLBoundaryPlane.H:169
void read_file(const bool)
Definition ABLBoundaryPlane.cpp:1145
Definition CFDSim.H:54
Definition Field.H:116
Definition FieldRepo.H:86
Definition ABLBoundaryPlane.H:31
void read_data(ncutils::NCGroup &, const amrex::Orientation, const int, const Field *, const amrex::Real, const amrex::Vector< amrex::Real > &)
Definition ABLBoundaryPlane.cpp:70
void read_data_native(const amrex::OrientationIter oit, amrex::BndryRegister &bndry_n, amrex::BndryRegister &bndry_np1, const int lev, const Field *, const amrex::Real time, const amrex::Vector< amrex::Real > &)
Definition ABLBoundaryPlane.cpp:158
bool is_populated(amrex::Orientation) const
Definition ABLBoundaryPlane.cpp:282
amrex::Vector< std::unique_ptr< PlaneVector > > m_data_interp
Definition ABLBoundaryPlane.H:89
void interpolate(const amrex::Real)
Definition ABLBoundaryPlane.cpp:260
int & component(const int id)
Definition ABLBoundaryPlane.H:73
amrex::Real tn() const
Definition ABLBoundaryPlane.H:82
amrex::Real m_tnp1
Time for plane at n + 1.
Definition ABLBoundaryPlane.H:95
amrex::Real tnp1() const
Definition ABLBoundaryPlane.H:83
const amrex::FArrayBox & interpolate_data(const amrex::Orientation ori, const int lev) const
Definition ABLBoundaryPlane.H:68
amrex::Real m_tinterp
Time for plane at interpolation.
Definition ABLBoundaryPlane.H:98
int component(const int id) const
Definition ABLBoundaryPlane.H:75
void resize(const int)
Definition ABLBoundaryPlane.cpp:44
amrex::Real tinterp() const
Definition ABLBoundaryPlane.H:84
void define_level_data(const amrex::Orientation, const amrex::Box &, const size_t)
Definition ABLBoundaryPlane.cpp:58
std::unordered_map< int, int > m_components
Map of {variableId : component}
Definition ABLBoundaryPlane.H:101
amrex::Real m_tn
Time for plane at n.
Definition ABLBoundaryPlane.H:92
amrex::Vector< amrex::FArrayBox > PlaneVector
Definition ABLBoundaryPlane.H:32
int nlevels(const amrex::Orientation ori) const
Definition ABLBoundaryPlane.H:77
void define_plane(const amrex::Orientation)
Definition ABLBoundaryPlane.cpp:51
amrex::Vector< std::unique_ptr< PlaneVector > > m_data_n
Definition ABLBoundaryPlane.H:87
amrex::Vector< std::unique_ptr< PlaneVector > > m_data_np1
Definition ABLBoundaryPlane.H:88
Definition SimTime.H:30
Representation of a NetCDF group.
Definition nc_interface.H:166
Definition BCInterface.cpp:7
io_mode
Definition ABLBoundaryPlane.H:15
Definition ABLBoundaryPlane.H:18
amrex::Gpu::ManagedVector< amrex::Real > data
Definition ABLBoundaryPlane.H:19
amrex::Vector< size_t > start
Definition ABLBoundaryPlane.H:20
amrex::Vector< size_t > count
Definition ABLBoundaryPlane.H:21