/* ============================================================================== This file is part of the JUCE library. Copyright (c) 2017 - ROLI Ltd. JUCE is an open source library subject to commercial or open-source licensing. By using JUCE, you agree to the terms of both the JUCE 5 End-User License Agreement and JUCE 5 Privacy Policy (both updated and effective as of the 27th April 2017). End User License Agreement: www.juce.com/juce-5-licence Privacy Policy: www.juce.com/juce-5-privacy-policy Or: You may also use this code under the terms of the GPL v3 (see www.gnu.org/licenses). JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE DISCLAIMED. ============================================================================== */ namespace juce { namespace dsp { template LookupTable::LookupTable() { data.resize (1); } template LookupTable::LookupTable (const std::function& functionToApproximate, size_t numPointsToUse) { initialise (functionToApproximate, numPointsToUse); } //============================================================================== template void LookupTable::initialise (const std::function& functionToApproximate, size_t numPointsToUse) { data.resize (static_cast (getRequiredBufferSize (numPointsToUse))); for (size_t i = 0; i < numPointsToUse; ++i) { auto value = functionToApproximate (i); jassert (! std::isnan (value)); jassert (! std::isinf (value)); // Make sure functionToApproximate returns a sensible value for the entire specified range. // E.g., this won't work for zero: [] (size_t i) { return 1.0f / i; } data.getReference (static_cast (i)) = value; } prepare(); } template void LookupTable::prepare() noexcept { auto guardIndex = static_cast (getGuardIndex()); data.getReference (guardIndex) = data.getUnchecked (guardIndex - 1); } template void LookupTableTransform::initialise (const std::function& functionToApproximate, FloatType minInputValueToUse, FloatType maxInputValueToUse, size_t numPoints) { jassert (maxInputValueToUse > minInputValueToUse); minInputValue = minInputValueToUse; maxInputValue = maxInputValueToUse; scaler = FloatType (numPoints - 1) / (maxInputValueToUse - minInputValueToUse); offset = -minInputValueToUse * scaler; const auto initFn = [functionToApproximate, minInputValueToUse, maxInputValueToUse, numPoints] (size_t i) { return functionToApproximate ( jlimit ( minInputValueToUse, maxInputValueToUse, jmap (FloatType (i), FloatType (0), FloatType (numPoints - 1), minInputValueToUse, maxInputValueToUse)) ); }; lookupTable.initialise (initFn, numPoints); } //============================================================================== template double LookupTableTransform::calculateMaxRelativeError (const std::function& functionToApproximate, FloatType minInputValue, FloatType maxInputValue, size_t numPoints, size_t numTestPoints) { jassert (maxInputValue > minInputValue); if (numTestPoints == 0) numTestPoints = 100 * numPoints; // use default LookupTableTransform transform (functionToApproximate, minInputValue, maxInputValue, numPoints); double maxError = 0; for (size_t i = 0; i < numTestPoints; ++i) { auto inputValue = jmap (FloatType (i), FloatType (0), FloatType (numTestPoints - 1), minInputValue, maxInputValue); auto approximatedOutputValue = transform.processSample (inputValue); auto referenceOutputValue = functionToApproximate (inputValue); maxError = jmax (maxError, calculateRelativeDifference ((double) referenceOutputValue, (double) approximatedOutputValue)); } return maxError; } //============================================================================== template double LookupTableTransform::calculateRelativeDifference (double x, double y) noexcept { static const auto eps = std::numeric_limits::min(); auto absX = std::abs (x); auto absY = std::abs (y); auto absDiff = std::abs (x - y); if (absX < eps) { if (absY >= eps) return absDiff / absY; return absDiff; // return the absolute error if both numbers are too close to zero } return absDiff / std::min (absX, absY); } //============================================================================== template class LookupTable; template class LookupTable; template class LookupTableTransform; template class LookupTableTransform; } // namespace dsp } // namespace juce