# Copyright (c) 2023, RTE (http://www.rte-france.com)
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
# SPDX-License-Identifier: MPL-2.0
#
import warnings
from typing import Dict, List, Optional
import pandas as pd
from pypowsybl import _pypowsybl
from .dc_sensitivity_analysis_result import DcSensitivityAnalysisResult
from .sensitivity_analysis_result import DEFAULT_MATRIX_ID
[docs]class AcSensitivityAnalysisResult(DcSensitivityAnalysisResult):
"""
Represents the result of an AC sensitivity analysis.
The result contains computed values (so-called "reference" values) and sensitivity values
of requested factors, on the base case and on post contingency states.
"""
def __init__(self,
result_context_ptr: _pypowsybl.JavaHandle,
functions_ids: Dict[str, List[str]],
function_data_frame_index: Dict[str, List[str]]):
DcSensitivityAnalysisResult.__init__(self, result_context_ptr, functions_ids, function_data_frame_index)
[docs] def get_bus_voltages_sensitivity_matrix(self, matrix_id: str = DEFAULT_MATRIX_ID, contingency_id: str = None) -> \
Optional[pd.DataFrame]:
"""
.. deprecated:: 1.1.0
Use :meth:`get_sensitivity_matrix` instead.
Get the matrix of bus voltages sensitivities on the base case or on post contingency state.
Args:
contingency_id: ID of the contingency
Returns:
the matrix of sensitivities
"""
warnings.warn("get_bus_voltages_sensitivity_matrix is deprecated, use get_sensitivity_matrix instead",
DeprecationWarning)
return self.get_sensitivity_matrix(matrix_id, contingency_id)
[docs] def get_reference_voltages(self, matrix_id: str = DEFAULT_MATRIX_ID, contingency_id: str = None) -> Optional[
pd.DataFrame]:
"""
.. deprecated:: 1.1.0
Use :meth:`get_reference_matrix` instead.
The values of bus voltages on the base case or on post contingency state.
Args:
matrix_id: ID of the matrix
contingency_id: ID of the contingency
Returns:
the values of bus voltages
"""
warnings.warn("get_reference_voltages is deprecated, use get_reference_matrix instead",
DeprecationWarning)
return self.get_reference_matrix(matrix_id, contingency_id, 'reference_voltages')