File: repl.txt

package info (click to toggle)
node-stdlib 0.0.96%2Bds1%2B~cs0.0.429-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 421,476 kB
  • sloc: javascript: 1,562,831; ansic: 109,702; lisp: 49,823; cpp: 27,224; python: 7,871; sh: 6,807; makefile: 6,089; fortran: 3,102; awk: 387
file content (92 lines) | stat: -rw-r--r-- 2,391 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

{{alias}}( N, x, stride )
    Computes the sum of the absolute values.

    The sum of absolute values corresponds to the *L1* norm.

    The `N` and `stride` parameters determine which elements in `x` are used to
    compute the sum.

    Indexing is relative to the first index. To introduce an offset, use typed
    array views.

    If `N` or `stride` is less than or equal to `0`, the function returns `0`.

    Parameters
    ----------
    N: integer
        Number of elements to sum.

    x: Float32Array
        Input array.

    stride: integer
        Index increment.

    Returns
    -------
    sum: float
        Sum of absolute values.

    Examples
    --------
    // Standard usage:
    > var x = new {{alias:@stdlib/array/float32}}( [ -2.0, 1.0, 3.0, -5.0, 4.0, 0.0, -1.0, -3.0 ] );
    > var sum = {{alias}}( x.length, x, 1 )
    19.0

    // Sum every other value:
    > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
    > var stride = 2;
    > sum = {{alias}}( N, x, stride )
    10.0

    // Use view offset; e.g., starting at 2nd element:
    > var x0 = new {{alias:@stdlib/array/float32}}( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
    > var x1 = new {{alias:@stdlib/array/float32}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 );
    > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 );
    > sum = {{alias}}( N, x1, stride )
    12.0


{{alias}}.ndarray( N, x, stride, offset )
    Computes the sum of absolute values using alternative indexing semantics.

    While typed array views mandate a view offset based on the underlying
    buffer, the `offset` parameter supports indexing semantics based on a
    starting index.

    Parameters
    ----------
    N: integer
        Number of elements to sum.

    x: Float32Array
        Input array.

    stride: integer
        Index increment.

    offset: integer
        Starting index.

    Returns
    -------
    sum: float
        Sum of absolute values.

    Examples
    --------
    // Standard usage:
    > var x = new {{alias:@stdlib/array/float32}}( [ -2.0, 1.0, 3.0, -5.0, 4.0, 0.0, -1.0, -3.0 ] );
    > var sum = {{alias}}.ndarray( x.length, x, 1, 0 )
    19.0

    // Sum the last three elements:
    > x = new {{alias:@stdlib/array/float32}}( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
    > sum = {{alias}}.ndarray( 3, x, -1, x.length-1 )
    15.0

    See Also
    --------