MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches

◆ make_duct_grid() [2/2]

MAYAFLUX_API std::expected< DuctGrid, DuctError > MayaFlux::Kinesis::Acoustics::make_duct_grid ( const DuctSpec & spec,
std::span< const double > radii )
nodiscard

Build a grid from radii sampled evenly along the bore.

Parameters
specLength, sample rate and air constants
radiiAt least two radii, evenly spaced from the start to the end of the bore. They are linearly interpolated to the half points.
Returns
The grid, or why none was built

The grid spacing is length / N with N the largest count keeping the Courant number at most one. A length that is not a whole number of intervals leaves it a little under one, which lowers the bandwidth.

Definition at line 90 of file DuctGrid.cpp.

91{
92 auto begun = detail::begin_duct_grid(spec);
93 if (!begun) {
94 return begun;
95 }
96
97 if (radii.size() < 2 || !std::ranges::all_of(radii, positive_finite)) {
98 return std::unexpected(DuctError::INVALID_PROFILE);
99 }
100
101 DuctGrid grid = std::move(*begun);
102 const double last = static_cast<double>(radii.size() - 1);
103 for (size_t l = 0; l < grid.intervals; ++l) {
104 const double position = (static_cast<double>(l) + 0.5) / static_cast<double>(grid.intervals) * last;
105 const size_t index = std::min(static_cast<size_t>(position), radii.size() - 2);
106 const double fraction = position - static_cast<double>(index);
107 const double r = radii[index] + fraction * (radii[index + 1] - radii[index]);
108 grid.area[l] = std::numbers::pi * r * r;
109 }
110 grid.start_radius = radii.front();
111 grid.end_radius = radii.back();
112
113 return detail::finish_duct_grid(std::move(grid), spec);
114}
std::expected< DuctGrid, DuctError > finish_duct_grid(DuctGrid grid, const DuctSpec &spec)
Definition DuctGrid.cpp:58
std::expected< DuctGrid, DuctError > begin_duct_grid(const DuctSpec &spec)
Definition DuctGrid.cpp:36

References MayaFlux::Kinesis::Acoustics::DuctGrid::area, MayaFlux::Kinesis::Acoustics::detail::begin_duct_grid(), MayaFlux::Kinesis::Acoustics::DuctGrid::end_radius, MayaFlux::Kinesis::Acoustics::detail::finish_duct_grid(), MayaFlux::Kinesis::Acoustics::DuctGrid::intervals, INVALID_PROFILE, and MayaFlux::Kinesis::Acoustics::DuctGrid::start_radius.

Here is the call graph for this function: