/** * @license Apache-2.0 * * Copyright (c) 2020 The Stdlib Authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ 'use strict'; // MODULES // var dmeanvarpn = require( './../../../base/dmeanvarpn' ); var sqrt = require( '@stdlib/math/base/special/sqrt' ); // MAIN // /** * Computes the mean and standard deviation of a double-precision floating-point strided array using a two-pass algorithm. * * @param {PositiveInteger} N - number of indexed elements * @param {number} correction - degrees of freedom adjustment * @param {Float64Array} x - input array * @param {integer} strideX - `x` stride length * @param {Float64Array} out - output array * @param {integer} strideOut - `out` stride length * @returns {Float64Array} output array * * @example * var Float64Array = require( '@stdlib/array/float64' ); * * var x = new Float64Array( [ 1.0, -2.0, 2.0 ] ); * var out = new Float64Array( 2 ); * * var v = dmeanstdevpn( x.length, 1, x, 1, out, 1 ); * // returns [ ~0.3333, ~2.0817 ] */ function dmeanstdevpn( N, correction, x, strideX, out, strideOut ) { var io; dmeanvarpn( N, correction, x, strideX, out, strideOut ); if ( strideOut < 0 ) { io = 0; } else { io = strideOut; } out[ io ] = sqrt( out[ io ] ); return out; } // EXPORTS // module.exports = dmeanstdevpn;