repl.txt (2600B)
1 2 {{alias}}( N, x, stride ) 3 Computes the arithmetic mean of a single-precision floating-point strided 4 array using extended accumulation and returning an extended precision 5 result. 6 7 The `N` and `stride` parameters determine which elements in `x` are accessed 8 at runtime. 9 10 Indexing is relative to the first index. To introduce an offset, use a typed 11 array view. 12 13 If `N <= 0`, the function returns `NaN`. 14 15 Parameters 16 ---------- 17 N: integer 18 Number of indexed elements. 19 20 x: Float32Array 21 Input array. 22 23 stride: integer 24 Index increment. 25 26 Returns 27 ------- 28 out: number 29 The arithmetic mean. 30 31 Examples 32 -------- 33 // Standard Usage: 34 > var x = new {{alias:@stdlib/array/float32}}( [ 1.0, -2.0, 2.0 ] ); 35 > {{alias}}( x.length, x, 1 ) 36 ~0.3333 37 38 // Using `N` and `stride` parameters: 39 > x = new {{alias:@stdlib/array/float32}}( [ -2.0, 1.0, 1.0, -5.0, 2.0, -1.0 ] ); 40 > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); 41 > var stride = 2; 42 > {{alias}}( N, x, stride ) 43 ~0.3333 44 45 // Using view offsets: 46 > var x0 = new {{alias:@stdlib/array/float32}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); 47 > var x1 = new {{alias:@stdlib/array/float32}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); 48 > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 ); 49 > stride = 2; 50 > {{alias}}( N, x1, stride ) 51 ~-0.3333 52 53 {{alias}}.ndarray( N, x, stride, offset ) 54 Computes the arithmetic mean of a single-precision floating-point strided 55 array using extended accumulation and alternative indexing semantics and 56 returning an extended precision result. 57 58 While typed array views mandate a view offset based on the underlying 59 buffer, the `offset` parameter supports indexing semantics based on a 60 starting index. 61 62 Parameters 63 ---------- 64 N: integer 65 Number of indexed elements. 66 67 x: Float32Array 68 Input array. 69 70 stride: integer 71 Index increment. 72 73 offset: integer 74 Starting index. 75 76 Returns 77 ------- 78 out: number 79 The arithmetic mean. 80 81 Examples 82 -------- 83 // Standard Usage: 84 > var x = new {{alias:@stdlib/array/float32}}( [ 1.0, -2.0, 2.0 ] ); 85 > {{alias}}.ndarray( x.length, x, 1, 0 ) 86 ~0.3333 87 88 // Using offset parameter: 89 > var x = new {{alias:@stdlib/array/float32}}( [ 1.0, -2.0, 3.0, 2.0, 5.0, -1.0 ] ); 90 > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); 91 > {{alias}}.ndarray( N, x, 2, 1 ) 92 ~-0.3333 93 94 See Also 95 -------- 96