io.rtron.math.geometry.euclidean.threed.surface.ParametricBoundedSurface3D.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of rtron-math Show documentation

Component 'rtron-math' of rtron.

The newest version!

/*
 * Copyright 2019-2022 Chair of Geoinformatics, Technical University of Munich
 *
 * Licensed 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 io.rtron.math.geometry.euclidean.threed.surface

import com.github.kittinunf.result.Result
import io.rtron.math.geometry.euclidean.threed.curve.Curve3D
import io.rtron.math.range.DefinableDomain
import io.rtron.math.range.Range
import io.rtron.math.range.Tolerable
import io.rtron.std.handleFailure

data class ParametricBoundedSurface3D(
    val leftBoundary: Curve3D,
    val rightBoundary: Curve3D,
    override val tolerance: Double,
    private val discretizationStepSize: Double
) : AbstractSurface3D(), DefinableDomain, Tolerable {

    // Properties and Initializers
    init {
        require(leftBoundary.domain == rightBoundary.domain) { "Boundary curves must have the identical domain." }
        require(length > tolerance) { "Length must be greater than zero as well as the tolerance threshold." }
    }

    override val domain: Range
        get() = leftBoundary.domain

    val length: Double
        get() = leftBoundary.length

    private val leftVertices by lazy {
        leftBoundary.calculatePointListGlobalCS(discretizationStepSize).handleFailure { throw it.error }
    }

    private val rightVertices by lazy {
        rightBoundary.calculatePointListGlobalCS(discretizationStepSize).handleFailure { throw it.error }
    }

    // Methods

    override fun calculatePolygonsLocalCS(): Result, Exception> =
        LinearRing3D.ofWithDuplicatesRemoval(leftVertices, rightVertices, tolerance)
            .handleFailure { return it }
            .map { it.calculatePolygonsGlobalCS() }
            .handleFailure { return it }
            .flatten()
            .let { Result.success(it) }

    companion object {
        const val DEFAULT_STEP_SIZE: Double = 0.3 // used for tesselation
    }
}