// 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();
}
}
}