org.nd4j.linalg.api.concurrency.AffinityManager Maven / Gradle / Ivy
The newest version!
/*
* ******************************************************************************
* *
* *
* * This program and the accompanying materials are made available under the
* * terms of the Apache License, Version 2.0 which is available at
* * https://www.apache.org/licenses/LICENSE-2.0.
* *
* * See the NOTICE file distributed with this work for additional
* * information regarding copyright ownership.
* * Unless required by applicable law or agreed to in writing, software
* * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* * License for the specific language governing permissions and limitations
* * under the License.
* *
* * SPDX-License-Identifier: Apache-2.0
* *****************************************************************************
*/
package org.nd4j.linalg.api.concurrency;
import org.nd4j.linalg.api.buffer.DataBuffer;
import org.nd4j.linalg.api.ndarray.INDArray;
public interface AffinityManager {
enum Location {
HOST, DEVICE, EVERYWHERE,
}
/**
* This method returns deviceId for current thread
* @return
*/
Integer getDeviceForCurrentThread();
/**
* This method returns deviceId for a given thread
* @return
*/
Integer getDeviceForThread(long threadId);
/**
* This method returns id of current device for a given INDArray
*
* @param array
* @return
*/
Integer getDeviceForArray(INDArray array);
/**
* This method returns number of available devices
* @return
*/
int getNumberOfDevices();
/**
* Utility method, to associate INDArray with specific device (backend-specific)
*
* @param array
*/
void touch(INDArray array);
/**
* Utility method, to associate INDArray with specific device (backend-specific)
*
* @param buffer
*/
void touch(DataBuffer buffer);
/**
* This method replicates given INDArray, and places it to target device.
*
* @param deviceId target deviceId
* @param array INDArray to replicate
* @return
*/
INDArray replicateToDevice(Integer deviceId, INDArray array);
/**
* This method replicates given DataBuffer, and places it to target device.
*
* @param deviceId target deviceId
* @param buffer
* @return
*/
DataBuffer replicateToDevice(Integer deviceId, DataBuffer buffer);
/**
* This method tags specific INDArray as "recent" on specified location
*
* @param location
*/
void tagLocation(INDArray array, Location location);
/**
* This method tags specific DataBuffer as "recent" on specified location
*
* @param location
*/
void tagLocation(DataBuffer buffer, Location location);
/**
* This method propagates given INDArray to specified location
*
* @param array
* @param location
*/
void ensureLocation(INDArray array, Location location);
/**
* This method returns last-updated location for the given INDArray
* @param array
* @return
*/
Location getActiveLocation(INDArray array);
/**
* This method forces specific device for current thread.
*
* PLEASE NOTE: This method is UNSAFE and should NOT be used with 100% clearance about it.
*
* @param deviceId
*/
void unsafeSetDevice(Integer deviceId);
/**
* This method returns TRUE if cross-device access is allowed on this system
*/
boolean isCrossDeviceAccessSupported();
/**
* This method allows to block cross-device access. Mostly suitable for debugging/testing purposes
*
* @param reallyAllow
*/
void allowCrossDeviceAccess(boolean reallyAllow);
}