Add out variance to StructureND and some related types, make some unrelated changes

2021-05-20 19:43:29 +07:00 · 2021-05-20 19:43:29 +07:00 · d7a4228f5f
commit d7a4228f5f
parent 5d2fff6575
28 changed files with 83 additions and 82 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -20,19 +20,20 @@
 - Space is replaced by Group. Space is reserved for vector spaces.
 - VectorSpace is now a vector space
 - Buffer factories for primitives moved to MutableBuffer.Companion
- NDStructure and NDAlgebra to StructureND and AlgebraND respectively
- Real -> Double
+- Rename `NDStructure` and `NDAlgebra` to `StructureND` and `AlgebraND` respectively
+- `Real` -> `Double`
 - DataSets are moved from functions to core
 - Redesign advanced Chain API
- Redesign MST. Remove MSTExpression.
- Move MST to core
+- Redesign `MST`. Remove `MstExpression`.
+- Move `MST` to core
 - Separated benchmarks and examples
- Rewritten EJML module without ejml-simple
- Stability of kmath-ast and kmath-kotilngrad promoted to EXPERIMENTAL.
+- Rewrite `kmath-ejml` without `ejml-simple` artifact, support sparse matrices
+- Promote stability of kmath-ast and kmath-kotlingrad to EXPERIMENTAL.
 - ColumnarData returns nullable column
- MST is made sealed interface
- Replaced MST.Symbolic by Symbol, Symbol now implements MST
- Removed Any restriction on polynomials
+- `MST` is made sealed interface
+- Replace `MST.Symbolic` by `Symbol`, `Symbol` now implements MST
+- Remove Any restriction on polynomials
+- Add `out` variance to type parameters of `StructureND` and its implementations where possible

 ### Deprecated

--- a/README.md
+++ b/README.md
@ -40,7 +40,7 @@ KMath is a modular library. Different modules provide different features with di

 * **PROTOTYPE**. On this level there are no compatibility guarantees. All methods and classes form those modules could break any moment. You can still use it, but be sure to fix the specific version.
 * **EXPERIMENTAL**. The general API is decided, but some changes could be made. Volatile API is marked with `@UnstableKmathAPI` or other stability warning annotations.
-* **DEVELOPMENT**. API breaking genrally follows semantic versioning ideology. There could be changes in minor versions, but not in patch versions. API is protected with [binary-compatibility-validator](https://github.com/Kotlin/binary-compatibility-validator) tool.
+* **DEVELOPMENT**. API breaking generally follows semantic versioning ideology. There could be changes in minor versions, but not in patch versions. API is protected with [binary-compatibility-validator](https://github.com/Kotlin/binary-compatibility-validator) tool.
 * **STABLE**. The API stabilized. Breaking changes are allowed only in major releases.

 <!--Current feature list is [here](/docs/features.md)-->
@ -213,7 +213,7 @@ One can still use generic algebras though.
 >
 > **Features:**
 > - [differentiable-mst-expression](kmath-kotlingrad/src/main/kotlin/space/kscience/kmath/kotlingrad/DifferentiableMstExpression.kt) : MST based DifferentiableExpression.
-> - [differentiable-mst-expression](kmath-kotlingrad/src/main/kotlin/space/kscience/kmath/kotlingrad/DifferentiableMstExpression.kt) : Conversions between Kotlin&nabla;'s SFun and MST
+> - [differentiable-mst-expression](kmath-kotlingrad/src/main/kotlin/space/kscience/kmath/kotlingrad/DifferentiableMstExpression.kt) : Conversions between Kotlin∇'s SFun and MST

 <hr/>

@ -247,10 +247,9 @@ One can still use generic algebras though.
 > **Maturity**: PROTOTYPE
 >
 > **Features:**
-> - [tensor algebra](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/api/TensorAlgebra.kt) : Interface for basic linear algebra operations on tensors (plus, dot, etc.)
-> - [linear algebra operations](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/api/LinearOpsTensorAlgebra.kt) : Interface for advanced linear algebra operations like LU decomposition, SVD, etc.
-> - [tensor algebra over Double](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/core/DoubleTensorAlgebra.kt): Full implementation of operations for tensors over `Double`'s.
-> - [tensor algebra with broadcasting](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/core/BroadcastDoubleTensorAlgebra.kt) : Basic linear algebra operations implemented with broadcasting for tensors over `Double`'s.
+> - [tensor algebra](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/api/TensorAlgebra.kt) : Basic linear algebra operations on tensors (plus, dot, etc.)
+> - [tensor algebra with broadcasting](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/core/algebras/BroadcastDoubleTensorAlgebra.kt) : Basic linear algebra operations implemented with broadcasting.
+> - [linear algebra operations](kmath-tensors/src/commonMain/kotlin/space/kscience/kmath/tensors/api/LinearOpsTensorAlgebra.kt) : Advanced linear algebra operations like LU decomposition, SVD, etc.

 <hr/>

@ -294,8 +293,8 @@ repositories {
 }

 dependencies {
-    api("space.kscience:kmath-core:0.3.0-dev-8")
-    // api("space.kscience:kmath-core-jvm:0.3.0-dev-8") for jvm-specific version
+    api("space.kscience:kmath-core:0.3.0-dev-11")
+    // api("space.kscience:kmath-core-jvm:0.3.0-dev-11") for jvm-specific version
 }
 ```

--- a/docs/templates/README-TEMPLATE.md
+++ b/docs/templates/README-TEMPLATE.md
@ -40,7 +40,7 @@ KMath is a modular library. Different modules provide different features with di

 * **PROTOTYPE**. On this level there are no compatibility guarantees. All methods and classes form those modules could break any moment. You can still use it, but be sure to fix the specific version.
 * **EXPERIMENTAL**. The general API is decided, but some changes could be made. Volatile API is marked with `@UnstableKmathAPI` or other stability warning annotations.
-* **DEVELOPMENT**. API breaking genrally follows semantic versioning ideology. There could be changes in minor versions, but not in patch versions. API is protected with [binary-compatibility-validator](https://github.com/Kotlin/binary-compatibility-validator) tool.
+* **DEVELOPMENT**. API breaking generally follows semantic versioning ideology. There could be changes in minor versions, but not in patch versions. API is protected with [binary-compatibility-validator](https://github.com/Kotlin/binary-compatibility-validator) tool.
 * **STABLE**. The API stabilized. Breaking changes are allowed only in major releases.

 <!--Current feature list is [here](/docs/features.md)-->
--- a/examples/src/main/kotlin/space/kscience/kmath/tensors/PCA.kt
+++ b/examples/src/main/kotlin/space/kscience/kmath/tensors/PCA.kt
@ -11,7 +11,7 @@ import space.kscience.kmath.tensors.core.BroadcastDoubleTensorAlgebra

 // simple PCA

-fun main() = BroadcastDoubleTensorAlgebra {  // work in context with broadcast methods
+fun main(): Unit = BroadcastDoubleTensorAlgebra {  // work in context with broadcast methods
    val seed = 100500L

    // assume x is range from 0 until 10
--- a/kmath-ast/README.md
+++ b/kmath-ast/README.md
@ -10,7 +10,7 @@ Performance and visualization extensions to MST API.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-ast:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-ast:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -20,7 +20,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-ast:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-ast:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -31,7 +31,7 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-ast:0.3.0-dev-8")
+    implementation("space.kscience:kmath-ast:0.3.0-dev-11")
 }
 ```

--- a/kmath-complex/README.md
+++ b/kmath-complex/README.md
@ -8,7 +8,7 @@ Complex and hypercomplex number systems in KMath.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-complex:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-complex:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -18,7 +18,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-complex:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-complex:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -29,6 +29,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-complex:0.3.0-dev-8")
+    implementation("space.kscience:kmath-complex:0.3.0-dev-11")
 }
 ```
--- a/kmath-core/README.md
+++ b/kmath-core/README.md
@ -15,7 +15,7 @@ performance calculations to code generation.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-core:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-core:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -25,7 +25,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-core:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-core:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -36,6 +36,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-core:0.3.0-dev-8")
+    implementation("space.kscience:kmath-core:0.3.0-dev-11")
 }
 ```
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/linear/MatrixBuilder.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/linear/MatrixBuilder.kt
@ -8,7 +8,7 @@ package space.kscience.kmath.linear
 import space.kscience.kmath.misc.UnstableKMathAPI
 import space.kscience.kmath.operations.Ring

-public class MatrixBuilder<T : Any, A : Ring<T>>(
+public class MatrixBuilder<T : Any, out A : Ring<T>>(
    public val linearSpace: LinearSpace<T, A>,
    public val rows: Int,
    public val columns: Int,
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/linear/MatrixWrapper.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/linear/MatrixWrapper.kt
@ -16,7 +16,7 @@ import kotlin.reflect.KClass
 *
 * @param T the type of items.
 */
-public class MatrixWrapper<T : Any> internal constructor(
+public class MatrixWrapper<out T : Any> internal constructor(
    public val origin: Matrix<T>,
    public val features: Set<MatrixFeature>,
 ) : Matrix<T> by origin {
@ -26,12 +26,11 @@ public class MatrixWrapper<T : Any> internal constructor(
     */
    @UnstableKMathAPI
    @Suppress("UNCHECKED_CAST")
-    override fun <F : StructureFeature> getFeature(type: KClass<out F>): F? = features.singleOrNull { type.isInstance(it) } as? F
-        ?: origin.getFeature(type)
+    public override fun <F : StructureFeature> getFeature(type: KClass<out F>): F? =
+        features.singleOrNull(type::isInstance) as? F
+            ?: origin.getFeature(type)

-    override fun toString(): String {
-        return "MatrixWrapper(matrix=$origin, features=$features)"
-    }
+    public override fun toString(): String = "MatrixWrapper(matrix=$origin, features=$features)"
 }

 /**
@ -82,7 +81,7 @@ public fun <T : Any> LinearSpace<T, Ring<T>>.zero(
    elementAlgebra.zero
 } + ZeroFeature

-public class TransposedFeature<T : Any>(public val original: Matrix<T>) : MatrixFeature
+public class TransposedFeature<out T : Any>(public val original: Matrix<T>) : MatrixFeature

 /**
 * Create a virtual transposed matrix without copying anything. `A.transpose().transpose() === A`
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/linear/VirtualMatrix.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/linear/VirtualMatrix.kt
@ -10,7 +10,7 @@ package space.kscience.kmath.linear
 *
 * @property generator the function that provides elements.
 */
-public class VirtualMatrix<T : Any>(
+public class VirtualMatrix<out T : Any>(
    override val rowNum: Int,
    override val colNum: Int,
    public val generator: (i: Int, j: Int) -> T,
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/AlgebraND.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/AlgebraND.kt
@ -26,7 +26,7 @@ public class ShapeMismatchException(public val expected: IntArray, public val ac
 * @param C the type of the element context.
 * @param N the type of the structure.
 */
-public interface AlgebraND<T, C : Algebra<T>> {
+public interface AlgebraND<T, out C : Algebra<T>> {
    /**
     * The shape of ND-structures this algebra operates on.
     */
@ -121,7 +121,7 @@ internal fun <T, C : Algebra<T>> AlgebraND<T, C>.checkShape(element: StructureND
 * @param N the type of ND structure.
 * @param S the type of space of structure elements.
 */
-public interface GroupND<T, S : Group<T>> : Group<StructureND<T>>, AlgebraND<T, S> {
+public interface GroupND<T, out S : Group<T>> : Group<StructureND<T>>, AlgebraND<T, S> {
    /**
     * Element-wise addition.
     *
@ -189,7 +189,7 @@ public interface GroupND<T, S : Group<T>> : Group<StructureND<T>>, AlgebraND<T,
 * @param N the type of ND structure.
 * @param R the type of ring of structure elements.
 */
-public interface RingND<T, R : Ring<T>> : Ring<StructureND<T>>, GroupND<T, R> {
+public interface RingND<T, out R : Ring<T>> : Ring<StructureND<T>>, GroupND<T, R> {
    /**
     * Element-wise multiplication.
     *
@ -230,7 +230,7 @@ public interface RingND<T, R : Ring<T>> : Ring<StructureND<T>>, GroupND<T, R> {
 * @param N the type of ND structure.
 * @param F the type field of structure elements.
 */
-public interface FieldND<T, F : Field<T>> : Field<StructureND<T>>, RingND<T, F>, ScaleOperations<StructureND<T>> {
+public interface FieldND<T, out F : Field<T>> : Field<StructureND<T>>, RingND<T, F>, ScaleOperations<StructureND<T>> {
    /**
     * Element-wise division.
     *
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/BufferAlgebraND.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/BufferAlgebraND.kt
@ -11,7 +11,7 @@ import space.kscience.kmath.structures.BufferFactory
 import kotlin.contracts.InvocationKind
 import kotlin.contracts.contract

-public interface BufferAlgebraND<T, A : Algebra<T>> : AlgebraND<T, A> {
+public interface BufferAlgebraND<T, out A : Algebra<T>> : AlgebraND<T, A> {
    public val strides: Strides
    public val bufferFactory: BufferFactory<T>

--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/BufferND.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/BufferND.kt
@ -18,7 +18,7 @@ import space.kscience.kmath.structures.MutableBufferFactory
 * @param strides The strides to access elements of [Buffer] by linear indices.
 * @param buffer The underlying buffer.
 */
-public open class BufferND<T>(
+public open class BufferND<out T>(
    public val strides: Strides,
    public val buffer: Buffer<T>,
 ) : StructureND<T> {
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/Structure1D.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/Structure1D.kt
@ -15,7 +15,7 @@ import kotlin.jvm.JvmInline
 /**
 * A structure that is guaranteed to be one-dimensional
 */
-public interface Structure1D<T> : StructureND<T>, Buffer<T> {
+public interface Structure1D<out T> : StructureND<T>, Buffer<T> {
    public override val dimension: Int get() = 1

    public override operator fun get(index: IntArray): T {
@ -42,7 +42,7 @@ public interface MutableStructure1D<T> : Structure1D<T>, MutableStructureND<T>,
 * A 1D wrapper for nd-structure
 */
@JvmInline
-private value class Structure1DWrapper<T>(val structure: StructureND<T>) : Structure1D<T> {
+private value class Structure1DWrapper<out T>(val structure: StructureND<T>) : Structure1D<T> {
    override val shape: IntArray get() = structure.shape
    override val size: Int get() = structure.shape[0]

@ -68,7 +68,11 @@ private class MutableStructure1DWrapper<T>(val structure: MutableStructureND<T>)
    }

    @PerformancePitfall
-    override fun copy(): MutableBuffer<T> = structure.elements().map { it.second }.toMutableList().asMutableBuffer()
+    override fun copy(): MutableBuffer<T> = structure
+        .elements()
+        .map(Pair<IntArray, T>::second)
+        .toMutableList()
+        .asMutableBuffer()
 }


@ -76,7 +80,7 @@ private class MutableStructure1DWrapper<T>(val structure: MutableStructureND<T>)
 * A structure wrapper for buffer
 */
@JvmInline
-private value class Buffer1DWrapper<T>(val buffer: Buffer<T>) : Structure1D<T> {
+private value class Buffer1DWrapper<out T>(val buffer: Buffer<T>) : Structure1D<T> {
    override val shape: IntArray get() = intArrayOf(buffer.size)
    override val size: Int get() = buffer.size

--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/Structure2D.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/Structure2D.kt
@ -18,7 +18,7 @@ import kotlin.reflect.KClass
 *
 * @param T the type of items.
 */
-public interface Structure2D<T> : StructureND<T> {
+public interface Structure2D<out T> : StructureND<T> {
    /**
     * The number of rows in this structure.
     */
@ -100,7 +100,7 @@ public interface MutableStructure2D<T> : Structure2D<T>, MutableStructureND<T> {
 * A 2D wrapper for nd-structure
 */
@JvmInline
-private value class Structure2DWrapper<T>(val structure: StructureND<T>) : Structure2D<T> {
+private value class Structure2DWrapper<out T>(val structure: StructureND<T>) : Structure2D<T> {
    override val shape: IntArray get() = structure.shape

    override val rowNum: Int get() = shape[0]
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/StructureND.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/nd/StructureND.kt
@ -24,7 +24,7 @@ public interface StructureFeature
 *
 * @param T the type of items.
 */
-public interface StructureND<T> {
+public interface StructureND<out T> {
    /**
     * The shape of structure, i.e. non-empty sequence of non-negative integers that specify sizes of dimensions of
     * this structure.
@ -213,9 +213,7 @@ public interface Strides {
    /**
     * Iterate over ND indices in a natural order
     */
-    public fun indices(): Sequence<IntArray> = (0 until linearSize).asSequence().map {
-        index(it)
-    }
+    public fun indices(): Sequence<IntArray> = (0 until linearSize).asSequence().map(::index)
 }

 /**
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/structures/Buffer.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/structures/Buffer.kt
@ -283,7 +283,7 @@ public value class ReadOnlyBuffer<T>(public val buffer: MutableBuffer<T>) : Buff
 *
 * @param T the type of elements provided by the buffer.
 */
-public class VirtualBuffer<T>(override val size: Int, private val generator: (Int) -> T) : Buffer<T> {
+public class VirtualBuffer<out T>(override val size: Int, private val generator: (Int) -> T) : Buffer<T> {
    override operator fun get(index: Int): T {
        if (index < 0 || index >= size) throw IndexOutOfBoundsException("Expected index from 0 to ${size - 1}, but found $index")
        return generator(index)
--- a/kmath-core/src/commonMain/kotlin/space/kscience/kmath/structures/FlaggedBuffer.kt
+++ b/kmath-core/src/commonMain/kotlin/space/kscience/kmath/structures/FlaggedBuffer.kt
@ -37,7 +37,7 @@ public enum class ValueFlag(public val mask: Byte) {
 /**
 * A buffer with flagged values.
 */
-public interface FlaggedBuffer<T> : Buffer<T> {
+public interface FlaggedBuffer<out T> : Buffer<T> {
    public fun getFlag(index: Int): Byte
 }

--- a/kmath-core/src/commonTest/kotlin/space/kscience/kmath/expressions/SimpleAutoDiffTest.kt
+++ b/kmath-core/src/commonTest/kotlin/space/kscience/kmath/expressions/SimpleAutoDiffTest.kt
@ -17,7 +17,7 @@ import kotlin.test.Test
 import kotlin.test.assertEquals
 import kotlin.test.assertTrue

-class SimpleAutoDiffTest {
+internal class SimpleAutoDiffTest {

    fun dx(
        xBinding: Pair<Symbol, Double>,
--- a/kmath-coroutines/src/jvmMain/kotlin/space/kscience/kmath/structures/LazyStructureND.kt
+++ b/kmath-coroutines/src/jvmMain/kotlin/space/kscience/kmath/structures/LazyStructureND.kt
@ -11,7 +11,7 @@ import space.kscience.kmath.misc.PerformancePitfall
 import space.kscience.kmath.nd.DefaultStrides
 import space.kscience.kmath.nd.StructureND

-public class LazyStructureND<T>(
+public class LazyStructureND<out T>(
    public val scope: CoroutineScope,
    public override val shape: IntArray,
    public val function: suspend (IntArray) -> T,
--- a/kmath-ejml/README.md
+++ b/kmath-ejml/README.md
@ -9,7 +9,7 @@ EJML based linear algebra implementation.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-ejml:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-ejml:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -19,7 +19,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-ejml:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-ejml:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -30,6 +30,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-ejml:0.3.0-dev-8")
+    implementation("space.kscience:kmath-ejml:0.3.0-dev-11")
 }
 ```
--- a/kmath-ejml/src/main/kotlin/space/kscience/kmath/ejml/EjmlMatrix.kt
+++ b/kmath-ejml/src/main/kotlin/space/kscience/kmath/ejml/EjmlMatrix.kt
@ -16,7 +16,7 @@ import space.kscience.kmath.nd.Structure2D
 * @property origin The underlying EJML matrix.
 * @author Iaroslav Postovalov
 */
-public abstract class EjmlMatrix<T, out M : Matrix>(public open val origin: M) : Structure2D<T> {
+public abstract class EjmlMatrix<out T, out M : Matrix>(public open val origin: M) : Structure2D<T> {
    public override val rowNum: Int get() = origin.numRows
    public override val colNum: Int get() = origin.numCols
 }
--- a/kmath-for-real/README.md
+++ b/kmath-for-real/README.md
@ -9,7 +9,7 @@ Specialization of KMath APIs for Double numbers.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-for-real:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-for-real:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -19,7 +19,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-for-real:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-for-real:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -30,6 +30,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-for-real:0.3.0-dev-8")
+    implementation("space.kscience:kmath-for-real:0.3.0-dev-11")
 }
 ```
--- a/kmath-functions/README.md
+++ b/kmath-functions/README.md
@ -11,7 +11,7 @@ Functions and interpolations.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-functions:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-functions:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -21,7 +21,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-functions:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-functions:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -32,6 +32,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-functions:0.3.0-dev-8")
+    implementation("space.kscience:kmath-functions:0.3.0-dev-11")
 }
 ```
--- a/kmath-kotlingrad/README.md
+++ b/kmath-kotlingrad/README.md
@ -1,6 +1,6 @@
 # Module kmath-kotlingrad

-[Kotlin∇](https://github.com/breandan/kotlingrad) integration module.
+[Kotlin∇](https://www.htmlsymbols.xyz/unicode/U+2207) integration module.

 - [differentiable-mst-expression](src/main/kotlin/space/kscience/kmath/kotlingrad/DifferentiableMstExpression.kt) : MST based DifferentiableExpression.
 - [differentiable-mst-expression](src/main/kotlin/space/kscience/kmath/kotlingrad/DifferentiableMstExpression.kt) : Conversions between Kotlin∇'s SFun and MST
@ -8,7 +8,7 @@

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-kotlingrad:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-kotlingrad:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -18,7 +18,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-kotlingrad:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-kotlingrad:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -29,6 +29,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-kotlingrad:0.3.0-dev-8")
+    implementation("space.kscience:kmath-kotlingrad:0.3.0-dev-11")
 }
 ```
--- a/kmath-memory/build.gradle.kts
+++ b/kmath-memory/build.gradle.kts
@ -7,6 +7,6 @@ plugins {
 readme {
    maturity = ru.mipt.npm.gradle.Maturity.DEVELOPMENT
    description = """
-        An API and basic implementation for arranging objects in a continous memory block.
+        An API and basic implementation for arranging objects in a continuous memory block.
    """.trimIndent()
 }
--- a/kmath-nd4j/README.md
+++ b/kmath-nd4j/README.md
@ -9,7 +9,7 @@ ND4J based implementations of KMath abstractions.

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-nd4j:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-nd4j:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -19,7 +19,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-nd4j:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-nd4j:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -30,7 +30,7 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-nd4j:0.3.0-dev-8")
+    implementation("space.kscience:kmath-nd4j:0.3.0-dev-11")
 }
 ```

--- a/kmath-tensors/README.md
+++ b/kmath-tensors/README.md
@ -2,14 +2,14 @@

 Common linear algebra operations on tensors.

- - [tensor algebra](src/commonMain/kotlin/space/kscience/kmath/tensors/api/TensorAlgebra.kt) : Interface for basic linear algebra operations on tensors (plus, dot, etc.)
- - [linear algebra operations](src/commonMain/kotlin/space/kscience/kmath/tensors/api/LinearOpsTensorAlgebra.kt) : Interface for advanced linear algebra operations like LU decomposition, SVD, etc.
- - [tensor algebra over Double](src/commonMain/kotlin/space/kscience/kmath/tensors/core/DoubleTensorAlgebra.kt): Full implementation of operations for tensors over `Double`'s.
- - [tensor algebra with broadcasting](src/commonMain/kotlin/space/kscience/kmath/tensors/core/BroadcastDoubleTensorAlgebra.kt) : Basic linear algebra operations implemented with broadcasting for tensors over `Double`'s.
+ - [tensor algebra](src/commonMain/kotlin/space/kscience/kmath/tensors/api/TensorAlgebra.kt) : Basic linear algebra operations on tensors (plus, dot, etc.)
+ - [tensor algebra with broadcasting](src/commonMain/kotlin/space/kscience/kmath/tensors/core/algebras/BroadcastDoubleTensorAlgebra.kt) : Basic linear algebra operations implemented with broadcasting.
+ - [linear algebra operations](src/commonMain/kotlin/space/kscience/kmath/tensors/api/LinearOpsTensorAlgebra.kt) : Advanced linear algebra operations like LU decomposition, SVD, etc.
+

 ## Artifact:

-The Maven coordinates of this project are `space.kscience:kmath-tensors:0.3.0-dev-8`.
+The Maven coordinates of this project are `space.kscience:kmath-tensors:0.3.0-dev-11`.

 **Gradle:**
 ```gradle
@ -19,7 +19,7 @@ repositories {
 }

 dependencies {
-    implementation 'space.kscience:kmath-tensors:0.3.0-dev-8'
+    implementation 'space.kscience:kmath-tensors:0.3.0-dev-11'
 }
 ```
 **Gradle Kotlin DSL:**
@ -30,6 +30,6 @@ repositories {
 }

 dependencies {
-    implementation("space.kscience:kmath-tensors:0.3.0-dev-8")
+    implementation("space.kscience:kmath-tensors:0.3.0-dev-11")
 }
 ```