8d_blocked_accessors.js (8223B)
1 /** 2 * @license Apache-2.0 3 * 4 * Copyright (c) 2021 The Stdlib Authors. 5 * 6 * Licensed under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 19 /* eslint-disable max-depth, max-len */ 20 21 'use strict'; 22 23 // MODULES // 24 25 var init = require( './init.js' ); 26 27 28 // MAIN // 29 30 /** 31 * Applies a unary callback to elements in an eight-dimensional input ndarray and assigns results to elements in an equivalently shaped output ndarray via loop blocking. 32 * 33 * @private 34 * @param {Object} x - object containing input ndarray meta data 35 * @param {string} x.dtype - data type 36 * @param {Collection} x.data - data buffer 37 * @param {NonNegativeIntegerArray} x.shape - dimensions 38 * @param {IntegerArray} x.strides - stride lengths 39 * @param {NonNegativeInteger} x.offset - index offset 40 * @param {string} x.order - specifies whether `x` is row-major (C-style) or column-major (Fortran-style) 41 * @param {Function} x.getter - callback for accessing `x` data buffer elements 42 * @param {Object} y - object containing output ndarray meta data 43 * @param {string} y.dtype - data type 44 * @param {Collection} y.data - data buffer 45 * @param {NonNegativeIntegerArray} y.shape - dimensions 46 * @param {IntegerArray} y.strides - stride lengths 47 * @param {NonNegativeInteger} y.offset - index offset 48 * @param {string} y.order - specifies whether `y` is row-major (C-style) or column-major (Fortran-style) 49 * @param {Function} y.setter - callback for setting `y` data buffer elements 50 * @param {Callback} fcn - unary callback 51 * 52 * @example 53 * var Complex64Array = require( '@stdlib/array/complex64' ); 54 * var Complex64 = require( '@stdlib/complex/float32' ); 55 * var real = require( '@stdlib/complex/real' ); 56 * var imag = require( '@stdlib/complex/imag' ); 57 * 58 * function scale( z ) { 59 * return new Complex64( real(z)*10.0, imag(z)*10.0 ); 60 * } 61 * 62 * // Create data buffers: 63 * var xbuf = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] ); 64 * var ybuf = new Complex64Array( 4 ); 65 * 66 * // Define the shape of the input and output arrays: 67 * var shape = [ 1, 1, 1, 1, 1, 1, 2, 2 ]; 68 * 69 * // Define the array strides: 70 * var sx = [ 2, 2, 2, 2, 2, 2, 2, 1 ]; 71 * var sy = [ 2, 2, 2, 2, 2, 2, 2, 1 ]; 72 * 73 * // Define the index offsets: 74 * var ox = 0; 75 * var oy = 0; 76 * 77 * // Define getters and setters: 78 * function getter( buf, idx ) { 79 * return buf.get( idx ); 80 * } 81 * 82 * function setter( buf, idx, value ) { 83 * buf.set( value, idx ); 84 * } 85 * 86 * // Create the input and output ndarray-like objects: 87 * var x = { 88 * 'dtype': 'complex64', 89 * 'data': xbuf, 90 * 'shape': shape, 91 * 'strides': sx, 92 * 'offset': ox, 93 * 'order': 'row-major', 94 * 'getter': getter 95 * }; 96 * var y = { 97 * 'dtype': 'complex64', 98 * 'data': ybuf, 99 * 'shape': shape, 100 * 'strides': sy, 101 * 'offset': oy, 102 * 'order': 'row-major', 103 * 'setter': setter 104 * }; 105 * 106 * // Apply the unary function: 107 * blockedunary8d( x, y, scale ); 108 * 109 * var v = y.data.get( 0 ); 110 * 111 * var re = real( v ); 112 * // returns 10.0 113 * 114 * var im = imag( v ); 115 * // returns 20.0 116 */ 117 function blockedunary8d( x, y, fcn ) { // eslint-disable-line max-statements, max-lines-per-function 118 var bsize; 119 var xbuf; 120 var ybuf; 121 var get; 122 var set; 123 var dx0; 124 var dx1; 125 var dx2; 126 var dx3; 127 var dx4; 128 var dx5; 129 var dx6; 130 var dx7; 131 var dy0; 132 var dy1; 133 var dy2; 134 var dy3; 135 var dy4; 136 var dy5; 137 var dy6; 138 var dy7; 139 var ox1; 140 var ox2; 141 var ox3; 142 var ox4; 143 var ox5; 144 var ox6; 145 var ox7; 146 var oy1; 147 var oy2; 148 var oy3; 149 var oy4; 150 var oy5; 151 var oy6; 152 var oy7; 153 var sh; 154 var s0; 155 var s1; 156 var s2; 157 var s3; 158 var s4; 159 var s5; 160 var s6; 161 var s7; 162 var sx; 163 var sy; 164 var ox; 165 var oy; 166 var ix; 167 var iy; 168 var i0; 169 var i1; 170 var i2; 171 var i3; 172 var i4; 173 var i5; 174 var i6; 175 var i7; 176 var j0; 177 var j1; 178 var j2; 179 var j3; 180 var j4; 181 var j5; 182 var j6; 183 var j7; 184 var o; 185 186 // Note on variable naming convention: s#, dx#, dy#, i#, j# where # corresponds to the loop number, with `0` being the innermost loop... 187 188 // Initialize and unpack block data: 189 o = init( x, y ); 190 sh = o.sh; 191 sx = o.sx; 192 sy = o.sy; 193 bsize = o.bsize; 194 195 // Cache the indices of the first indexed elements in the respective ndarrays... 196 ox = x.offset; 197 oy = y.offset; 198 199 // Cache references to the input and output ndarray buffers... 200 xbuf = x.data; 201 ybuf = y.data; 202 203 // Cache offset increments for the innermost loop... 204 dx0 = sx[0]; 205 dy0 = sy[0]; 206 207 // Cache accessors: 208 get = x.getter; 209 set = y.setter; 210 211 // Iterate over blocks... 212 for ( j7 = sh[7]; j7 > 0; ) { 213 if ( j7 < bsize ) { 214 s7 = j7; 215 j7 = 0; 216 } else { 217 s7 = bsize; 218 j7 -= bsize; 219 } 220 ox7 = ox + ( j7*sx[7] ); 221 oy7 = oy + ( j7*sy[7] ); 222 for ( j6 = sh[6]; j6 > 0; ) { 223 if ( j6 < bsize ) { 224 s6 = j6; 225 j6 = 0; 226 } else { 227 s6 = bsize; 228 j6 -= bsize; 229 } 230 dx7 = sx[7] - ( s6*sx[6] ); 231 dy7 = sy[7] - ( s6*sy[6] ); 232 ox6 = ox7 + ( j6*sx[6] ); 233 oy6 = oy7 + ( j6*sy[6] ); 234 for ( j5 = sh[5]; j5 > 0; ) { 235 if ( j5 < bsize ) { 236 s5 = j5; 237 j5 = 0; 238 } else { 239 s5 = bsize; 240 j5 -= bsize; 241 } 242 dx6 = sx[6] - ( s5*sx[5] ); 243 dy6 = sy[6] - ( s5*sy[5] ); 244 ox5 = ox6 + ( j5*sx[5] ); 245 oy5 = oy6 + ( j5*sy[5] ); 246 for ( j4 = sh[4]; j4 > 0; ) { 247 if ( j4 < bsize ) { 248 s4 = j4; 249 j4 = 0; 250 } else { 251 s4 = bsize; 252 j4 -= bsize; 253 } 254 dx5 = sx[5] - ( s4*sx[4] ); 255 dy5 = sy[5] - ( s4*sy[4] ); 256 ox4 = ox5 + ( j4*sx[4] ); 257 oy4 = oy5 + ( j4*sy[4] ); 258 for ( j3 = sh[3]; j3 > 0; ) { 259 if ( j3 < bsize ) { 260 s3 = j3; 261 j3 = 0; 262 } else { 263 s3 = bsize; 264 j3 -= bsize; 265 } 266 dx4 = sx[4] - ( s3*sx[3] ); 267 dy4 = sy[4] - ( s3*sy[3] ); 268 ox3 = ox4 + ( j3*sx[3] ); 269 oy3 = oy4 + ( j3*sy[3] ); 270 for ( j2 = sh[2]; j2 > 0; ) { 271 if ( j2 < bsize ) { 272 s2 = j2; 273 j2 = 0; 274 } else { 275 s2 = bsize; 276 j2 -= bsize; 277 } 278 dx3 = sx[3] - ( s2*sx[2] ); 279 dy3 = sy[3] - ( s2*sy[2] ); 280 ox2 = ox3 + ( j2*sx[2] ); 281 oy2 = oy3 + ( j2*sy[2] ); 282 for ( j1 = sh[1]; j1 > 0; ) { 283 if ( j1 < bsize ) { 284 s1 = j1; 285 j1 = 0; 286 } else { 287 s1 = bsize; 288 j1 -= bsize; 289 } 290 dx2 = sx[2] - ( s1*sx[1] ); 291 dy2 = sy[2] - ( s1*sy[1] ); 292 ox1 = ox2 + ( j1*sx[1] ); 293 oy1 = oy2 + ( j1*sy[1] ); 294 for ( j0 = sh[0]; j0 > 0; ) { 295 if ( j0 < bsize ) { 296 s0 = j0; 297 j0 = 0; 298 } else { 299 s0 = bsize; 300 j0 -= bsize; 301 } 302 // Compute index offsets for the first input and output ndarray elements in the current block... 303 ix = ox1 + ( j0*sx[0] ); 304 iy = oy1 + ( j0*sy[0] ); 305 306 // Compute loop offset increments... 307 dx1 = sx[1] - ( s0*sx[0] ); 308 dy1 = sy[1] - ( s0*sy[0] ); 309 310 // Iterate over the ndarray dimensions... 311 for ( i7 = 0; i7 < s7; i7++ ) { 312 for ( i6 = 0; i6 < s6; i6++ ) { 313 for ( i5 = 0; i5 < s5; i5++ ) { 314 for ( i4 = 0; i4 < s4; i4++ ) { 315 for ( i3 = 0; i3 < s3; i3++ ) { 316 for ( i2 = 0; i2 < s2; i2++ ) { 317 for ( i1 = 0; i1 < s1; i1++ ) { 318 for ( i0 = 0; i0 < s0; i0++ ) { 319 set( ybuf, iy, fcn( get( xbuf, ix ) ) ); 320 ix += dx0; 321 iy += dy0; 322 } 323 ix += dx1; 324 iy += dy1; 325 } 326 ix += dx2; 327 iy += dy2; 328 } 329 ix += dx3; 330 iy += dy3; 331 } 332 ix += dx4; 333 iy += dy4; 334 } 335 ix += dx5; 336 iy += dy5; 337 } 338 ix += dx6; 339 iy += dy6; 340 } 341 ix += dx7; 342 iy += dy7; 343 } 344 } 345 } 346 } 347 } 348 } 349 } 350 } 351 } 352 } 353 354 355 // EXPORTS // 356 357 module.exports = blockedunary8d;