org.nd4j.linalg.cache.ConstantHandler Maven / Gradle / Ivy
/*
* ******************************************************************************
* *
* *
* * 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.cache;
import org.nd4j.linalg.api.buffer.DataBuffer;
import org.nd4j.linalg.api.buffer.DataType;
public interface ConstantHandler {
/**
* If specific hardware supports dedicated constant memory,
* this method forces DataBuffer passed in to be moved
* to that constant memory.
*
* PLEASE NOTE: This method implementation is hardware-dependant.
*
* @param dataBuffer
* @return
*/
long moveToConstantSpace(DataBuffer dataBuffer);
/**
*
* PLEASE NOTE: This method implementation is hardware-dependant.
* PLEASE NOTE: This method does NOT allow concurrent use of any array
*
* @param dataBuffer
* @return
*/
DataBuffer relocateConstantSpace(DataBuffer dataBuffer);
/**
* This method returns DataBuffer with
* constant equal to input array.
*
* PLEASE NOTE: This method assumes that
* you'll never ever change values
* within result DataBuffer
*
* @param array
* @return
*/
DataBuffer getConstantBuffer(boolean[] array, DataType dataType);
DataBuffer getConstantBuffer(int[] array, DataType dataType);
/**
* This method returns DataBuffer with
* constant equal to input array.
*
* PLEASE NOTE: This method assumes that
* you'll never ever change values
* within result DataBuffer
*
* @param array
* @return
*/
DataBuffer getConstantBuffer(long[] array, DataType dataType);
/**
* This method returns DataBuffer with contant equal to input array.
*
* PLEASE NOTE: This method assumes that you'll never ever change values within result DataBuffer
*
* @param array
* @return
*/
DataBuffer getConstantBuffer(double[] array, DataType dataType);
/**
* This method returns DataBuffer with contant equal to input array.
*
* PLEASE NOTE: This method assumes that you'll never ever change values within result DataBuffer
*
* @param array
* @return
*/
DataBuffer getConstantBuffer(float[] array, DataType dataType);
/**
* This method removes all cached constants
*/
void purgeConstants();
/**
* This method returns memory used for cache, in bytes
*
* @return
*/
long getCachedBytes();
}