var dlinspace = require( '@stdlib/blas/ext/base/dlinspace' );

Fills a double-precision floating-point strided array with linearly spaced values over a specified interval.

var Float64Array = require( '@stdlib/array/float64' );

var x = new Float64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );

dlinspace( x.length, 0.0, 7.0, true, x, 1 );
// x => <Float64Array>[ 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0 ]

The function has the following parameters:

• N: number of indexed elements.
• start: start of interval.
• stop: end of interval.
• endpoint: boolean indicating whether to include the stop value when writing values to the input array. If true, the input array is filled with evenly spaced values over the closed interval [start, stop]. If false, the input array is filled with evenly spaced values over the half-open interval [start, stop).
• x: input Float64Array.
• strideX: stride length.

The N and stride parameters determine which elements in the strided array are accessed at runtime. For example, to fill every other element:

var Float64Array = require( '@stdlib/array/float64' );

var x = new Float64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );

dlinspace( 4, 1.0, 5.0, false, x, 2 );
// x => <Float64Array>[ 1.0, 0.0, 2.0, 0.0, 3.0, 0.0, 4.0, 0.0 ]

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

var Float64Array = require( '@stdlib/array/float64' );

// Initial array...
var x0 = new Float64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );

// Create an offset view...
var x1 = new Float64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // start at 2nd element

// Fill every other element...
dlinspace( 3, 1.0, 3.0, true, x1, 2 );
// x0 => <Float64Array>[ 0.0, 1.0, 0.0, 2.0, 0.0, 3.0 ]

Fills a double-precision floating-point strided array with linearly spaced values over a specified interval using alternative indexing semantics.

var Float64Array = require( '@stdlib/array/float64' );

var x = new Float64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );

dlinspace.ndarray( x.length, 0.0, 7.0, true, x, 1, 0 );
// x => <Float64Array>[ 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0 ]

The function has the following additional parameters:

• offsetX: starting index.

While typed array views mandate a view offset based on the underlying buffer, the offset parameter supports indexing semantics based on a starting index. For example, to access only the last three elements:

var Float64Array = require( '@stdlib/array/float64' );

var x = new Float64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );

dlinspace.ndarray( 3, 1.0, 3.0, true, x, 1, x.length-3 );
// x => <Float64Array>[ 0.0, 0.0, 0.0, 1.0, 2.0, 3.0 ]

• Let M be the number of generated values (which is either N or N+1 depending on whether endpoint is true or false, respectively). The spacing between values is thus given by

  Δ = (stop-start)/(M-1)
  

• When the number of generated values is greater than 1 and endpoint is true, the set of values written to a provided input array is guaranteed to include the start and stop values. Beware, however, that values between start and stop are subject to floating-point rounding errors. Hence,

  var Float64Array = require( '@stdlib/array/float64' );
  
  var x = new Float64Array( [ 0.0, 0.0, 0.0 ] );
  
  dlinspace( 3, 0.0, 1.0, true, x, 1 );
  // x => <Float64Array>[ 0.0, ~0.5, 1.0 ]

  where x[1] is only guaranteed to be approximately equal to 0.5.

• When N = 1 and endpoint is false, only the start value is written to a provided input array. When N = 1 and endpoint is true, only the stop value is written to a provided input array.

• If start < stop, values are written to a provided input array in ascending order; otherwise, values are written in descending order.

• If N <= 0, both functions return x unchanged.