// Copyright (C) Stichting Deltares 2017. All rights reserved.
//
// This file is part of Ringtoets.
//
// Ringtoets is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see .
//
// All names, logos, and references to "Deltares" are registered trademarks of
// Stichting Deltares and remain full property of Stichting Deltares at all times.
// All rights reserved.
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;
using Core.Common.Base.Data;
using Ringtoets.AssemblyTool.Data;
using Ringtoets.Common.Data.AssemblyTool;
using Ringtoets.Common.Data.AssessmentSection;
using Ringtoets.Common.Data.FailureMechanism;
namespace Ringtoets.Common.Util
{
///
/// Class that contains helper methods to retrieve failure mechanism specific norms.
///
public static class FailureMechanismNormHelper
{
private static readonly Range contributionValidityRange = new Range(0, 100);
///
/// Gets the norm based on .
///
/// The assessment section to get the norm from.
/// The category type to use while obtaining the norm.
/// The failure mechanism contribution.
/// The 'N' parameter used to factor in the 'length effect'.
/// The norm corresponding to the provided category type.
/// Thrown when is null.
/// Thrown when
/// is an invalid .
/// Thrown when
/// is a valid but unsupported .
///
/// Thrown when:
///
/// - is not in the interval [0.0, 100.0] or is ;
/// - is smaller than 1 or is .
///
///
public static double GetNorm(IAssessmentSection assessmentSection,
FailureMechanismCategoryType categoryType,
double failureMechanismContribution,
double n)
{
if (assessmentSection == null)
{
throw new ArgumentNullException(nameof(assessmentSection));
}
ValidateInput(categoryType, failureMechanismContribution, n);
IEnumerable categories = AssemblyToolCategoriesFactory.CreateFailureMechanismSectionAssemblyCategories(
assessmentSection.FailureMechanismContribution.SignalingNorm,
assessmentSection.FailureMechanismContribution.LowerLimitNorm,
failureMechanismContribution,
n);
switch (categoryType)
{
case FailureMechanismCategoryType.MechanismSpecificFactorizedSignalingNorm:
return categories.First(c => c.Group == FailureMechanismSectionAssemblyCategoryGroup.IIv)
.LowerBoundary;
case FailureMechanismCategoryType.MechanismSpecificSignalingNorm:
return categories.First(c => c.Group == FailureMechanismSectionAssemblyCategoryGroup.IIIv)
.LowerBoundary;
case FailureMechanismCategoryType.MechanismSpecificLowerLimitNorm:
return categories.First(c => c.Group == FailureMechanismSectionAssemblyCategoryGroup.IVv)
.LowerBoundary;
case FailureMechanismCategoryType.LowerLimitNorm:
return categories.First(c => c.Group == FailureMechanismSectionAssemblyCategoryGroup.Vv)
.LowerBoundary;
case FailureMechanismCategoryType.FactorizedLowerLimitNorm:
return categories.First(c => c.Group == FailureMechanismSectionAssemblyCategoryGroup.VIv)
.LowerBoundary;
default:
throw new NotSupportedException();
}
}
private static void ValidateInput(FailureMechanismCategoryType categoryType, double failureMechanismContribution, double n)
{
if (!Enum.IsDefined(typeof(FailureMechanismCategoryType), categoryType))
{
throw new InvalidEnumArgumentException(nameof(categoryType),
(int) categoryType,
typeof(FailureMechanismCategoryType));
}
ValidateNumericInput(failureMechanismContribution, n);
}
private static void ValidateNumericInput(double failureMechanismContribution, double n)
{
if (!contributionValidityRange.InRange(failureMechanismContribution))
{
throw new ArgumentOutOfRangeException(nameof(failureMechanismContribution),
$@"The value for '{nameof(failureMechanismContribution)}' must be in the range of [0.0, 100.0].");
}
if (double.IsNaN(n) || n < 1.0)
{
throw new ArgumentOutOfRangeException(nameof(n), $@"The value for '{nameof(n)}' must be 1.0 or larger.");
}
}
}
}