MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
StaggeredLine.hpp File Reference

Interior propagation of a bore on its interleaved grid, with the discrete energy and a pickup. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Namespaces

namespace  MayaFlux
 Main namespace for the Maya Flux audio engine.
namespace  MayaFlux::Kinesis
namespace  MayaFlux::Kinesis::Acoustics

Functions

void MayaFlux::Kinesis::Acoustics::advance_pressure (std::span< double > pressure, std::span< const double > velocity, std::span< const double > pressure_gain) noexcept
 Advance the interior pressures from the new velocities.
void MayaFlux::Kinesis::Acoustics::advance_velocity (std::span< double > velocity, std::span< const double > pressure, std::span< const double > velocity_gain) noexcept
 Advance the half step velocities from the pressure.
double MayaFlux::Kinesis::Acoustics::discrete_energy (std::span< const double > pressure, std::span< const double > velocity_previous, std::span< const double > velocity_current, std::span< const double > pressure_gain, std::span< const double > velocity_gain, double time_step) noexcept
 Discrete energy of the bore in joules.
constexpr double MayaFlux::Kinesis::Acoustics::end_cell_pressure (double pressure, double pressure_gain, double net_inflow) noexcept
 New pressure of an end cell from the flow into it.
void MayaFlux::Kinesis::Acoustics::resample_line (std::span< const double > source, std::span< double > target, double offset=0.0) noexcept
 Linearly interpolate a line of values onto another of a different size by relative position.
double MayaFlux::Kinesis::Acoustics::sample_pressure (std::span< const double > pressure, double position) noexcept
 Pressure at a position along the bore, linearly interpolated.

Detailed Description

Interior propagation of a bore on its interleaved grid, with the discrete energy and a pickup.

Pressure p^n lives at integer steps and volume velocity u^(n+1/2) at half steps, so one sample is: advance_velocity from the current pressure, then the end cells, then advance_pressure for the interior. The end cells are updated by an end law, which is where a reed, a wall or a radiation load acts. Nothing here allocates, and every function runs over spans the caller owns.

With a Courant number of one the interior is exact for a cylinder. Below one it adds numerical dispersion and lowers the bandwidth, and it stays stable for any Courant number up to one.

Definition in file StaggeredLine.hpp.