/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* 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.
*/
package org.apache.ignite.ml.math.impls.matrix;
import org.apache.ignite.IgniteCache;
import org.apache.ignite.ml.math.Matrix;
import org.apache.ignite.ml.math.MatrixKeyMapper;
import org.apache.ignite.ml.math.ValueMapper;
import org.apache.ignite.ml.math.Vector;
import org.apache.ignite.ml.math.exceptions.UnsupportedOperationException;
import org.apache.ignite.ml.math.functions.IgniteDoubleFunction;
import org.apache.ignite.ml.math.functions.IgniteFunction;
import org.apache.ignite.ml.math.impls.CacheUtils;
import org.apache.ignite.ml.math.impls.storage.matrix.CacheMatrixStorage;
/**
* Matrix based on existing cache and key and value mapping functions.
*/
public class CacheMatrix<K, V> extends AbstractMatrix {
/**
*
*/
public CacheMatrix() {
// No-op.
}
/**
* Creates new matrix over existing cache.
*
* @param rows Amount of rows in matrix.
* @param cols Amount of columns in matrix.
* @param cache Ignite cache.
* @param keyMapper {@link MatrixKeyMapper} to validate cache key.
* @param valMapper {@link ValueMapper} to obtain value for given cache key.
*/
public CacheMatrix(
int rows,
int cols,
IgniteCache<K, V> cache,
MatrixKeyMapper<K> keyMapper,
ValueMapper<V> valMapper) {
assert rows > 0;
assert cols > 0;
assert cache != null;
assert keyMapper != null;
assert valMapper != null;
setStorage(new CacheMatrixStorage<>(rows, cols, cache, keyMapper, valMapper));
}
/**
*
*
*/
@SuppressWarnings({"unchecked"})
private CacheMatrixStorage<K, V> storage() {
return (CacheMatrixStorage<K, V>)getStorage();
}
/** {@inheritDoc} */
@Override public Matrix copy() {
throw new UnsupportedOperationException();
}
/** {@inheritDoc} */
@Override public Matrix like(int rows, int cols) {
throw new UnsupportedOperationException();
}
/** {@inheritDoc} */
@Override public Vector likeVector(int crd) {
throw new UnsupportedOperationException();
}
/**
* Return the same matrix with updates values (broken contract).
*
* @param d Value to divide to.
*/
@Override public Matrix divide(double d) {
return mapOverValues((Double v) -> v / d);
}
/**
* Return the same matrix with updates values (broken contract).
*
* @param x Value to add.
*/
@Override public Matrix plus(double x) {
return mapOverValues((Double v) -> v + x);
}
/**
* Return the same matrix with updates values (broken contract).
*
* @param x Value to multiply to.
*/
@Override public Matrix times(double x) {
return mapOverValues((Double v) -> v * x);
}
/** {@inheritDoc} */
@Override public Matrix assign(double val) {
return mapOverValues((Double v) -> val);
}
/** {@inheritDoc} */
@Override public Matrix map(IgniteDoubleFunction<Double> fun) {
return mapOverValues(fun::apply);
}
/** {@inheritDoc} */
@Override public double sum() {
CacheMatrixStorage<K, V> sto = storage();
return CacheUtils.sum(sto.cache().getName(), sto.keyMapper(), sto.valueMapper());
}
/** {@inheritDoc} */
@Override public double maxValue() {
CacheMatrixStorage<K, V> sto = storage();
return CacheUtils.max(sto.cache().getName(), sto.keyMapper(), sto.valueMapper());
}
/** {@inheritDoc} */
@Override public double minValue() {
CacheMatrixStorage<K, V> sto = storage();
return CacheUtils.min(sto.cache().getName(), sto.keyMapper(), sto.valueMapper());
}
/**
* @param mapper Mapping function.
* @return Matrix with mapped values.
*/
private Matrix mapOverValues(IgniteFunction<Double, Double> mapper) {
CacheMatrixStorage<K, V> sto = storage();
CacheUtils.map(sto.cache().getName(), sto.keyMapper(), sto.valueMapper(), mapper);
return this;
}
}