// 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.IO; using System.Linq; using Core.Common.Base.IO; using Core.Common.Utils; using log4net; using Ringtoets.Common.Data.Hydraulics; using Ringtoets.Common.IO.HydraRing; using Ringtoets.Common.Service.MessageProviders; using Ringtoets.Common.Service.Properties; using Ringtoets.HydraRing.Calculation.Calculator; using Ringtoets.HydraRing.Calculation.Calculator.Factory; using Ringtoets.HydraRing.Calculation.Data.Input.Hydraulics; using Ringtoets.HydraRing.Calculation.Exceptions; namespace Ringtoets.Common.Service { /// /// Service that provides methods for performing Hydra-Ring calculations for marginal wave statistics. /// public class WaveHeightCalculationService { private static readonly ILog log = LogManager.GetLogger(typeof(WaveHeightCalculationService)); private IWaveHeightCalculator calculator; private bool canceled; /// /// Performs validation over the values on the given . /// Error and status information is logged during the execution of the operation. /// /// The name of the calculation. /// The file path of the hydraulic boundary database file which to validate. /// The object which is used to build log messages. /// True if there were no validation errors; False otherwise. public static bool Validate(string name, string hydraulicBoundaryDatabaseFilePath, ICalculationMessageProvider messageProvider) { string calculationName = messageProvider.GetCalculationName(name); CalculationServiceHelper.LogValidationBegin(calculationName); string[] validationProblems = ValidateInput(hydraulicBoundaryDatabaseFilePath); CalculationServiceHelper.LogMessagesAsError(Resources.Hydraulic_boundary_database_connection_failed_0_, validationProblems); CalculationServiceHelper.LogValidationEnd(calculationName); return !validationProblems.Any(); } /// /// Performs a calculation for wave height. /// /// The wave height calculation to use. /// The path which points to the hydraulic boundary database file. /// The norm of the assessment section. /// The object which is used to build log messages. /// Thrown when is null. /// Thrown when /// /// contains invalid characters. /// The target probability or the calculated probability falls outside the [0.0, 1.0] range and is not . /// /// Thrown when: /// /// No settings database file could be found at the location of /// with the same name. /// Unable to open settings database file. /// Unable to read required data from database file. /// /// Thrown when an error occurs while performing the calculation. public void Calculate(IWaveHeightCalculation waveHeightCalculation, string hydraulicBoundaryDatabaseFilePath, double norm, ICalculationMessageProvider messageProvider) { if (waveHeightCalculation == null) { throw new ArgumentNullException(nameof(waveHeightCalculation)); } string hlcdDirectory = Path.GetDirectoryName(hydraulicBoundaryDatabaseFilePath); string calculationName = messageProvider.GetCalculationName(waveHeightCalculation.GetName()); CalculationServiceHelper.LogCalculationBegin(calculationName); calculator = HydraRingCalculatorFactory.Instance.CreateWaveHeightCalculator(hlcdDirectory); var exceptionThrown = false; try { WaveHeightCalculationInput calculationInput = CreateInput(waveHeightCalculation, norm, hydraulicBoundaryDatabaseFilePath); if (waveHeightCalculation.GetCalculateIllustrationPoints()) { calculator.CalculateWithIllustrationPoints(calculationInput); } else { calculator.Calculate(calculationInput); } if (!canceled && string.IsNullOrEmpty(calculator.LastErrorFileContent)) { waveHeightCalculation.SetOutput( CreateHydraulicBoundaryLocationOutput( messageProvider, waveHeightCalculation.GetName(), calculationInput.Beta, norm, calculator.Converged)); } } catch (HydraRingCalculationException) { if (!canceled) { string lastErrorContent = calculator.LastErrorFileContent; log.Error(string.IsNullOrEmpty(lastErrorContent) ? messageProvider.GetCalculationFailedUnexplainedMessage(waveHeightCalculation.GetName()) : messageProvider.GetCalculationFailedMessage(waveHeightCalculation.GetName(), lastErrorContent)); exceptionThrown = true; throw; } } finally { string lastErrorFileContent = calculator.LastErrorFileContent; bool errorOccurred = CalculationServiceHelper.HasErrorOccurred(canceled, exceptionThrown, lastErrorFileContent); if (errorOccurred) { log.Error(messageProvider.GetCalculationFailedMessage(waveHeightCalculation.GetName(), lastErrorFileContent)); } log.InfoFormat(Resources.WaveHeightCalculationService_Calculate_Calculation_temporary_directory_can_be_found_on_location_0, calculator.OutputDirectory); CalculationServiceHelper.LogCalculationEnd(calculationName); if (errorOccurred) { throw new HydraRingCalculationException(lastErrorFileContent); } } } /// /// Cancels any currently running wave height calculation. /// public void Cancel() { calculator?.Cancel(); canceled = true; } /// /// Creates the output of the calculation. /// /// The object which is used to build log messages. /// The name of the hydraulic boundary location. /// The target reliability for the calculation. /// The target probability for the calculation. /// The value indicating whether the calculation converged. /// A . /// Thrown when /// or the calculated probability falls outside the [0.0, 1.0] range and is not . private HydraulicBoundaryLocationOutput CreateHydraulicBoundaryLocationOutput( ICalculationMessageProvider messageProvider, string hydraulicBoundaryLocationName, double targetReliability, double targetProbability, bool? calculatorConverged) { double waveHeight = calculator.WaveHeight; double reliability = calculator.ReliabilityIndex; double probability = StatisticsConverter.ReliabilityToProbability(reliability); CalculationConvergence converged = RingtoetsCommonDataCalculationService.GetCalculationConvergence(calculatorConverged); if (converged != CalculationConvergence.CalculatedConverged) { log.Warn(messageProvider.GetCalculatedNotConvergedMessage(hydraulicBoundaryLocationName)); } return new HydraulicBoundaryLocationOutput(waveHeight, targetProbability, targetReliability, probability, reliability, converged); } /// /// Creates the input for an wave height calculation. /// /// The /// to create the input from. /// The norm to use during the calculation. /// The file path to the hydraulic /// boundary database. /// A . /// Thrown when the /// contains invalid characters. /// Thrown when: /// /// No settings database file could be found at the location of /// with the same name. /// Unable to open settings database file. /// Unable to read required data from database file. /// /// private static WaveHeightCalculationInput CreateInput(IWaveHeightCalculation waveHeightCalculation, double norm, string hydraulicBoundaryDatabaseFilePath) { var waveHeightCalculationInput = new WaveHeightCalculationInput(1, waveHeightCalculation.GetId(), norm); HydraRingSettingsDatabaseHelper.AssignSettingsFromDatabase(waveHeightCalculationInput, hydraulicBoundaryDatabaseFilePath); return waveHeightCalculationInput; } private static string[] ValidateInput(string hydraulicBoundaryDatabaseFilePath) { var validationResult = new List(); string validationProblem = HydraulicDatabaseHelper.ValidatePathForCalculation(hydraulicBoundaryDatabaseFilePath); if (!string.IsNullOrEmpty(validationProblem)) { validationResult.Add(validationProblem); } return validationResult.ToArray(); } } }