IntNdArray

interfaccia pubblica IntNdArray
Sottoclassi indirette conosciute

Un NdArray di numeri interi.

Metodi pubblici

astratto IntNdArray
copyTo ( NdArray <intero> dst)
abstract NdArraySequence < IntNdArray >
elementi (int dimensioneIdx)
Restituisce una sequenza di tutti gli elementi in una determinata dimensione.
astratto IntNdArray
get (coordinate lunghe...)
Restituisce l'elemento N-dimensionale di questo array alle coordinate specificate.
astratto int
getInt (coordinate lunghe...)
Restituisce il valore intero dello scalare trovato alle coordinate specificate.
intero astratto
getObject (coordinate lunghe...)
Restituisce il valore dello scalare trovato alle coordinate specificate.
astratto IntNdArray
astratto IntNdArray
lettura ( DataBuffer <intero> dst)
abstract NdArraySequence < IntNdArray >
scalari ()
Restituisce una sequenza di tutti gli scalari in questo array.
astratto IntNdArray
set ( NdArray <Integer> src, long... coordinate)
astratto IntNdArray
setInt (valore int, long... coordinate)
Assegna il valore intero dello scalare trovato alle coordinate indicate.
astratto IntNdArray
setObject (valore intero, coordinate lunghe...)
astratto IntNdArray
fetta ( Indice... indici)
Crea una vista (o sezione) multidimensionale di questo array mappando una o più dimensioni ai selettori di indice specificati.
astratto IntNdArray
scrivere ( DataBuffer <intero> src)
astratto IntNdArray
scrivere ( IntDataBuffer origine)

Metodi ereditati

Metodi pubblici

public abstract IntNdArray copyTo ( NdArray <Integer> dst)

elementi astratti pubblici NdArraySequence < IntNdArray > (int dimensionIdx)

Restituisce una sequenza di tutti gli elementi in una determinata dimensione.

Logicamente, l'array N-dimensionale può essere appiattito in un singolo vettore, dove gli scalari dell' (n - 1) esimo elemento precedono quelli dell' (n) esimo elemento, per un totale di valori size() .

Ad esempio, data una matrice nxm sugli assi [x, y] , gli elementi vengono iterati nel seguente ordine:

x 0 y 0 , x 0 y 1 , ..., x 0 y m-1 , x 1 y 0 , x 1 y 1 , ..., x n-1 y m-1

La sequenza restituita può quindi essere ripetuta per visitare ciascun elemento, chiamando forEach(Consumer) o forEachIndexed(BiConsumer) .

// Iterate matrix for initializing each of its vectors
    matrixOfFloats.elements(0).forEach(v -> {
      v.set(vector(1.0f, 2.0f, 3.0f));
    );

    // Iterate a vector for reading each of its scalar
    vectorOfFloats.scalars().forEachIdx((coords, s) -> {
      System.out.println("Value " + s.getFloat() + " found at " + coords);
    });
 }

Parametri
dimensioneIdx indice della dimensione
Ritorni
  • una sequenza NdArray

public abstract IntNdArray get (coordinate lunghe...)

Restituisce l'elemento N-dimensionale di questo array alle coordinate specificate.

È possibile recuperare elementi di qualsiasi dimensione di questo array. Ad esempio, se il numero di coordinate è uguale al numero di dimensioni di questo array, viene restituito un array di rango 0 (scalare), il cui valore può quindi essere ottenuto chiamando `array.getObject()`.

Qualsiasi modifica applicata agli elementi restituiti influisce anche sui dati di questo array, poiché non è coinvolta alcuna copia.

Tieni presente che invocare questo metodo è un modo equivalente e più efficiente per suddividere questo array su un singolo scalare, ovvero array.get(x, y, z) è uguale a array.slice(at(x), at(y), at(z))

Parametri
coordinate coordinate dell'elemento a cui accedere, nessuno restituirà questo array
Ritorni
  • l'elemento in questo indice

public abstract int getInt (coordinate lunghe...)

Restituisce il valore intero dello scalare trovato alle coordinate specificate.

Per accedere all'elemento scalare, il numero di coordinate fornite deve essere uguale al numero di dimensioni di questo array (cioè al suo rango). Per esempio:

IntNdArray matrix = NdArrays.ofInts(shape(2, 2));  // matrix rank = 2
  matrix.getInt(0, 1);  // succeeds, returns 0
  matrix.getInt(0);  // throws IllegalRankException

  IntNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getInt();  // succeeds, returns 0
 

Parametri
coordinate coordinate dello scalare da risolvere
Ritorni
  • valore di quello scalare
Lancia
IndexOutOfBoundsException se alcune coordinate sono fuori dai limiti della loro rispettiva dimensione
IllegalRankException se il numero di coordinate non è sufficiente per accedere a un elemento scalare

public abstract Integer getObject (coordinate lunghe...)

Restituisce il valore dello scalare trovato alle coordinate specificate.

Per accedere all'elemento scalare, il numero di coordinate fornite deve essere uguale al numero di dimensioni di questo array (cioè al suo rango). Per esempio:

FloatNdArray matrix = NdArrays.ofFloats(shape(2, 2));  // matrix rank = 2
  matrix.getObject(0, 1);  // succeeds, returns 0.0f
  matrix.getObject(0);  // throws IllegalRankException

  FloatNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.getObject();  // succeeds, returns 0.0f
 
Nota: se questo array memorizza valori di tipo primitivo, è preferibile l'utilizzo del metodo specializzato nella sottoclasse per quel tipo. Ad esempio, floatArray.getFloat(0); .

Parametri
coordinate coordinate dello scalare da risolvere
Ritorni
  • valore di quello scalare

lettura astratta pubblica IntNdArray ( IntDataBuffer dst)

lettura astratta pubblica IntNdArray ( DataBuffer <Integer> dst)

public abstract NdArraySequence < IntNdArray > scalars ()

Restituisce una sequenza di tutti gli scalari in questo array.

Ciò equivale a chiamare elements(shape().numDimensions() - 1)

Ritorni
  • una sequenza NdArray

public abstract IntNdArray set ( NdArray <Integer> src, long... coordinate)

public abstract IntNdArray setInt (valore int, coordinate long...)

Assegna il valore intero dello scalare trovato alle coordinate indicate.

Per accedere all'elemento scalare, il numero di coordinate fornite deve essere uguale al numero di dimensioni di questo array (cioè al suo rango). Per esempio:

IntNdArray matrix = NdArrays.ofInts(shape(2, 2));  // matrix rank = 2
  matrix.setInt(10, 0, 1);  // succeeds
  matrix.setInt(10, 0);  // throws IllegalRankException

  IntNdArray scalar = matrix.get(0, 1);  // scalar rank = 0
  scalar.setInt(10);  // succeeds
 

Parametri
valore valore da assegnare
coordinate coordinate dello scalare da assegnare
Ritorni
  • questa matrice
Lancia
IndexOutOfBoundsException se alcune coordinate sono fuori dai limiti della loro rispettiva dimensione
IllegalRankException se il numero di coordinate non è sufficiente per accedere a un elemento scalare

public abstract IntNdArray setObject (valore intero, coordinate lunghe...)

public abstract porzione IntNdArray ( indice... indici)

Crea una vista (o sezione) multidimensionale di questo array mappando una o più dimensioni ai selettori di indice specificati.

Le fette consentono di attraversare un array N-dimensionale in uno qualsiasi dei suoi assi e/o di filtrare solo gli elementi di interesse. Ad esempio, per una determinata matrice sugli assi [x, y] , è possibile iterare gli elementi in y=0 per tutti x .

Qualsiasi modifica applicata alla sezione restituita influisce anche sui dati di questo array, poiché non è coinvolta alcuna copia.

Esempio di utilizzo:

FloatNdArray matrix3d = NdArrays.ofFloats(shape(3, 2, 4));  // with [x, y, z] axes

    // Iterates elements on the x axis by preserving only the 3rd value on the z axis,
    // (i.e. [x, y, 2])
    matrix3d.slice(all(), all(), at(2)).elements(0).forEach(m -> {
      assertEquals(shape(2), m); // y=2, z=0 (scalar)
    );

    // Creates a slice that contains only the last element of the y axis and elements with an
    // odd `z` coordinate.
    FloatNdArray slice = matrix3d.slice(all(), at(1), odd());
    assertEquals(shape(3, 2), slice.shape());  // x=3, y=0 (scalar), z=2 (odd coordinates)

    // Iterates backward the elements on the x axis
    matrix3d.slice(flip()).elements(0).forEach(m -> {
      assertEquals(shape(2, 4), m);  // y=2, z=4
    });
 }

Parametri
indici selettori di indice per dimensione, a partire dalla dimensione 0 di questo array.
Ritorni
  • l'elemento risultante dalla selezione dell'indice

scrittura astratta pubblica IntNdArray ( DataBuffer <Integer> src)

scrittura astratta pubblica IntNdArray ( IntDataBuffer src)