mct-nightly 2.2.0.20241209.545__py3-none-any.whl → 2.2.0.20241211.531__py3-none-any.whl

{mct_nightly-2.2.0.20241209.545.dist-info → mct_nightly-2.2.0.20241211.531.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mct-nightly
-Version: 2.2.0.20241209.545
+Version: 2.2.0.20241211.531
 Summary: A Model Compression Toolkit for neural networks
 Home-page: UNKNOWN
 License: UNKNOWN

{mct_nightly-2.2.0.20241209.545.dist-info → mct_nightly-2.2.0.20241211.531.dist-info}/RECORD

@@ -1,4 +1,4 @@
-model_compression_toolkit/__init__.py,sha256=6AyrIFAF_n31SbVFLSLbYkFV2J14B71InZGWcUcUUC0,1573
+model_compression_toolkit/__init__.py,sha256=3AkzGEeakmlxtSQtujDenxH119YlHAatNP77RqE6mR4,1573
 model_compression_toolkit/constants.py,sha256=i_R6uXBfO1ph_X6DNJych2x59SUojfJbn7dNjs_mZnc,3846
 model_compression_toolkit/defaultdict.py,sha256=LSc-sbZYXENMCw3U9F4GiXuv67IKpdn0Qm7Fr11jy-4,2277
 model_compression_toolkit/logger.py,sha256=3DByV41XHRR3kLTJNbpaMmikL8icd9e1N-nkQAY9oDk,4567
@@ -8,7 +8,7 @@ model_compression_toolkit/core/__init__.py,sha256=tnDtL9KmT0vsOU27SsJ19TKDEbIH-t
 model_compression_toolkit/core/analyzer.py,sha256=X-2ZpkH1xdXnISnw1yJvXnvV-ssoUh-9LkLISSWNqiY,3691
 model_compression_toolkit/core/graph_prep_runner.py,sha256=7-b7Jd5jBVaXOWg5nSqbEyzBtdaGDbCxs8aqMV6GZ6I,11287
 model_compression_toolkit/core/quantization_prep_runner.py,sha256=OtL6g2rTC5mfdKrkzm47EPPW-voGGVYMYxpy2_sfu1U,6547
-model_compression_toolkit/core/runner.py,sha256=IavCZRVG9RisEKvFDxz27WDRKrfIG03YKXKv3tcagPo,14700
+model_compression_toolkit/core/runner.py,sha256=Hzeh3x84nPobf3Xy9dyvEqFN1yO71_JMdP_pV2eqetI,14680
 model_compression_toolkit/core/common/__init__.py,sha256=Wh127PbXcETZX_d1PQqZ71ETK3J9XO5A-HpadGUbj6o,1447
 model_compression_toolkit/core/common/base_substitutions.py,sha256=xDFSmVVs_iFSZfajytI0cuQaNRNcwHX3uqOoHgVUvxQ,1666
 model_compression_toolkit/core/common/framework_implementation.py,sha256=IkMydCj6voau7dwkYLYA_Ka_EFUKP3GKQdpYN6b1fgc,22163
@@ -29,7 +29,7 @@ model_compression_toolkit/core/common/collectors/mean_collector.py,sha256=mjr3U_
 model_compression_toolkit/core/common/collectors/min_max_per_channel_collector.py,sha256=5oKsJEKdVmj4C7fKdHhmrFN5k4G2BaFETpmf_xKNs7s,5207
 model_compression_toolkit/core/common/collectors/statistics_collector.py,sha256=vcf7Pk1v09SJC4fbAWf_8AgTktE6tPizJbQpSmocP2U,7930
 model_compression_toolkit/core/common/fusion/__init__.py,sha256=Rf1RcYmelmdZmBV5qOKvKWF575ofc06JFQSq83Jz99A,696
-model_compression_toolkit/core/common/fusion/graph_fuser.py,sha256=8seu9jBpC7HartP1nJd7S_SYFICyemVpDV9ZJ0QUQ7E,6212
+model_compression_toolkit/core/common/fusion/graph_fuser.py,sha256=5VkHB2fW0ohfPQmISz6o4fCMV8QyFdj5_kU51lN0JS8,6214
 model_compression_toolkit/core/common/fusion/layer_fusing.py,sha256=lOubqpc18TslhXZijWUJQAa1c3jIB2S-M-5HK78wJPQ,5548
 model_compression_toolkit/core/common/graph/__init__.py,sha256=Xr-Lt_qXMdrCnnOaUS_OJP_3iTTGfPCLf8_vSrQgCs0,773
 model_compression_toolkit/core/common/graph/base_graph.py,sha256=GG13PAtndsMjIqINfrCN6llVkFrg5CBfij4z99ntieU,37815
@@ -41,7 +41,7 @@ model_compression_toolkit/core/common/graph/graph_searches.py,sha256=2oKuW6L8hP-
 model_compression_toolkit/core/common/graph/virtual_activation_weights_node.py,sha256=3el-A7j1oyoo1_9zq3faQp7IeRsFXFCvnrb3zZFXpU0,9803
 model_compression_toolkit/core/common/graph/memory_graph/__init__.py,sha256=cco4TmeIDIh32nj9ZZXVkws4dd9F2UDrmjKzTN8G0V0,697
 model_compression_toolkit/core/common/graph/memory_graph/bipartite_graph.py,sha256=X6FK3C3y8ixFRPjC_wm3ClloCX8_06SOdA1TRi7o_LA,3800
-model_compression_toolkit/core/common/graph/memory_graph/compute_graph_max_cut.py,sha256=yJ0GncHVOP0Wj9ntzluklDQsgRFow89gteNCvIxRVXU,2857
+model_compression_toolkit/core/common/graph/memory_graph/compute_graph_max_cut.py,sha256=-bVPbzMMaDpbacjFOafBsxbmJFHaD4tE8IAHobLzop4,2858
 model_compression_toolkit/core/common/graph/memory_graph/cut.py,sha256=aPdXJPP5a5Rnu5Z5XqTZZkuGtdgHVu0RmX_NOfNM6Tc,2470
 model_compression_toolkit/core/common/graph/memory_graph/max_cut_astar.py,sha256=crV2NCLVO8jx9MlryZBYuJKFe_G9HfM7rUR64fDymlw,17045
 model_compression_toolkit/core/common/graph/memory_graph/memory_element.py,sha256=gRmBEFRmyJsNKezQfiwDwQu1cmbGd2wgKCRTH6iw8mw,3961
@@ -59,25 +59,25 @@ model_compression_toolkit/core/common/matchers/function.py,sha256=kMwcinxn_PInve
 model_compression_toolkit/core/common/matchers/node_matcher.py,sha256=63cMwa5YbQ5LKZy8-KFmdchVc3N7mpDJ6fNDt_uAQsk,2745
 model_compression_toolkit/core/common/matchers/walk_matcher.py,sha256=xqfLKk6xZt72hSnND_HoX5ESOooNMypb5VOZkVsJ_nw,1111
 model_compression_toolkit/core/common/mixed_precision/__init__.py,sha256=sw7LOPN1bM82o3SkMaklyH0jw-TLGK0-fl2Wq73rffI,697
-model_compression_toolkit/core/common/mixed_precision/bit_width_setter.py,sha256=iPuI11f3IkroC-dStdR40vKn4jpa1VL-kskCXc5z7wk,7536
+model_compression_toolkit/core/common/mixed_precision/bit_width_setter.py,sha256=lB3cxQPQqpAH5tP6kqOxqv7RmOtf1YciIkvr9irvKq0,7084
 model_compression_toolkit/core/common/mixed_precision/configurable_quant_id.py,sha256=LLDguK7afsbN742ucLpmJr5TUfTyFpK1vbf2bpVr1v0,882
 model_compression_toolkit/core/common/mixed_precision/configurable_quantizer_utils.py,sha256=7dKMi5S0zQZ16m8NWn1XIuoXsKuZUg64G4-uK8-j1PQ,5177
 model_compression_toolkit/core/common/mixed_precision/distance_weighting.py,sha256=-x8edUyudu1EAEM66AuXPtgayLpzbxoLNubfEbFM5kU,2867
-model_compression_toolkit/core/common/mixed_precision/mixed_precision_candidates_filter.py,sha256=nZb0_inMxgqlx5lG6uMF0sskHR-5zMSClzxYALBeqLA,4531
+model_compression_toolkit/core/common/mixed_precision/mixed_precision_candidates_filter.py,sha256=15PbLAfuIyQInFczPka_MuyO4AJzAaOm9bOi3bzllxc,4531
 model_compression_toolkit/core/common/mixed_precision/mixed_precision_quantization_config.py,sha256=r1t025_QHshyoop-PZvL7x6UuXaeplCCU3h4VNBhJHo,4309
 model_compression_toolkit/core/common/mixed_precision/mixed_precision_search_facade.py,sha256=B7xLl8P5eCz0_fBxocDlNiv6k-3MdfMUk2GjYKl2p5k,7522
 model_compression_toolkit/core/common/mixed_precision/mixed_precision_search_manager.py,sha256=hlaV4ybreT0DR4ftLSPg5KTit3BEm9dWA7Y8NHpEJ8w,37532
 model_compression_toolkit/core/common/mixed_precision/sensitivity_evaluation.py,sha256=adjuvrJcan7Ua3nYlJX7T6qGkCRHGqWMaM5-099a9Us,27220
 model_compression_toolkit/core/common/mixed_precision/set_layer_to_bitwidth.py,sha256=P8QtKgFXtt5b2RoubzI5OGlCfbEfZsAirjyrkFzK26A,2846
-model_compression_toolkit/core/common/mixed_precision/solution_refinement_procedure.py,sha256=KifDMbm7qkSfvSl6pcZzQ82naIXzeKL6aT-VsvWZYyc,7901
+model_compression_toolkit/core/common/mixed_precision/solution_refinement_procedure.py,sha256=cjmHFU4peJ6qYP8lsIkYYSLvRddDbiSQ6mPZnZy0p6U,7905
 model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/__init__.py,sha256=Rf1RcYmelmdZmBV5qOKvKWF575ofc06JFQSq83Jz99A,696
 model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/resource_utilization.py,sha256=MtPkZfPIJWI191Hbjp6JluUyLnqiJRi3zNf-CqVNuag,5053
-model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/resource_utilization_data.py,sha256=sFuUgWwC0aEBpf9zWmCTIcAbykBj3t5vmWAoB_BjYWA,14979
-model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/ru_aggregation_methods.py,sha256=ttc8wPa_9LZansutQ2f1ss-RTzgTv739wy3qsdLzyyk,4217
+model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/resource_utilization_data.py,sha256=Wu89Rl6gAB5vL5l8jPH-4GFeKG41jusAb_yiHQ9Sjxs,14978
+model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/ru_aggregation_methods.py,sha256=PmuVXCKgwRNvG7pLGdA24Ren1lFH5hW51_FrOmUVHwU,4199
 model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/ru_functions_mapping.py,sha256=mOxZwOQYnOwSJMiapEEH9o-89ujJdPxSl8zXpnApc0U,1850
 model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/ru_methods.py,sha256=WC1EHoNuo_lrzy4NRhGJ1cgmJ2IsFsbmP86mrVO3AVA,21506
 model_compression_toolkit/core/common/mixed_precision/search_methods/__init__.py,sha256=sw7LOPN1bM82o3SkMaklyH0jw-TLGK0-fl2Wq73rffI,697
-model_compression_toolkit/core/common/mixed_precision/search_methods/linear_programming.py,sha256=QZlQtvAUXUNNc6H2mKEFZhQ-fjP1QCIsxsS5BrhaXvU,16547
+model_compression_toolkit/core/common/mixed_precision/search_methods/linear_programming.py,sha256=YsA2CVrGt_VGJzZ9TMqPtz5b1YX_jb-Qfb9QfV-RXsc,16568
 model_compression_toolkit/core/common/network_editors/__init__.py,sha256=vZmu55bYqiaOQs3AjfwWDXHmuKZcLHt-wm7uR5fPEqg,1307
 model_compression_toolkit/core/common/network_editors/actions.py,sha256=nid0_j-Cn10xvmztT8yCKW_6uA7JEnom9SW9syx7wc0,19594
 model_compression_toolkit/core/common/network_editors/edit_network.py,sha256=dfgawi-nB0ocAJ0xcGn9E-Zv203oUnQLuMiXpX8vTgA,1748
@@ -559,8 +559,8 @@ model_compression_toolkit/xquant/pytorch/model_analyzer.py,sha256=b93o800yVB3Z-i
 model_compression_toolkit/xquant/pytorch/pytorch_report_utils.py,sha256=bOc-hFL3gdoSM1Th_S2N_-9JJSlPGpZCTx_QLJHS6lg,3388
 model_compression_toolkit/xquant/pytorch/similarity_functions.py,sha256=CERxq5K8rqaiE-DlwhZBTUd9x69dtYJlkHOPLB54vm8,2354
 model_compression_toolkit/xquant/pytorch/tensorboard_utils.py,sha256=mkoEktLFFHtEKzzFRn_jCnxjhJolK12TZ5AQeDHzUO8,9767
-mct_nightly-2.2.0.20241209.545.dist-info/LICENSE.md,sha256=aYSSIb-5AFPeITTvXm1UAoe0uYBiMmSS8flvXaaFUks,10174
-mct_nightly-2.2.0.20241209.545.dist-info/METADATA,sha256=KvMf3tFdGsWWZUXlYIMAVKzUmG1cLlAe-n4d5JJqiCI,26446
-mct_nightly-2.2.0.20241209.545.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-mct_nightly-2.2.0.20241209.545.dist-info/top_level.txt,sha256=gsYA8juk0Z-ZmQRKULkb3JLGdOdz8jW_cMRjisn9ga4,26
-mct_nightly-2.2.0.20241209.545.dist-info/RECORD,,
+mct_nightly-2.2.0.20241211.531.dist-info/LICENSE.md,sha256=aYSSIb-5AFPeITTvXm1UAoe0uYBiMmSS8flvXaaFUks,10174
+mct_nightly-2.2.0.20241211.531.dist-info/METADATA,sha256=qdiuketUM1fffHOn2tTgXRwUHPHj-IcdJbapmxVE0bM,26446
+mct_nightly-2.2.0.20241211.531.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+mct_nightly-2.2.0.20241211.531.dist-info/top_level.txt,sha256=gsYA8juk0Z-ZmQRKULkb3JLGdOdz8jW_cMRjisn9ga4,26
+mct_nightly-2.2.0.20241211.531.dist-info/RECORD,,

model_compression_toolkit/__init__.py

@@ -27,4 +27,4 @@ from model_compression_toolkit import data_generation
 from model_compression_toolkit import pruning
 from model_compression_toolkit.trainable_infrastructure.keras.load_model import keras_load_quantized_model
 
-__version__ = "2.2.0.20241209.000545"
+__version__ = "2.2.0.20241211.000531"

model_compression_toolkit/core/common/fusion/graph_fuser.py

@@ -26,6 +26,8 @@ class FusedLayerType:
     """
     def __init__(self):
         self.__name__ = 'FusedLayer'
+
+
 class GraphFuser:
 
     def create_fused_graph(self, graph: Graph) -> Dict[str, str]:

model_compression_toolkit/core/common/graph/memory_graph/compute_graph_max_cut.py

@@ -24,6 +24,7 @@ from model_compression_toolkit.core.common.graph.memory_graph.memory_graph impor
 
 SchedulerInfo = namedtuple('SchedulerInfo', [OPERATORS_SCHEDULING, MAX_CUT, CUTS, FUSED_NODES_MAPPING])
 
+
 def compute_graph_max_cut(memory_graph: MemoryGraph,
                           n_iter: int = 50,
                           astar_n_iter: int = 500,

model_compression_toolkit/core/common/mixed_precision/bit_width_setter.py

@@ -48,9 +48,8 @@ def set_bit_widths(mixed_precision_enable: bool,
             node_name = node.name if not node.reuse else '_'.join(node.name.split('_')[:-2])
             if node_name in sorted_nodes_names:  # only configurable nodes are in this list
                 node_index_in_graph = sorted_nodes_names.index(node_name)
-                _set_node_final_qc(bit_widths_config,
+                _set_node_final_qc(bit_widths_config[node_index_in_graph],
                                    node,
-                                   node_index_in_graph,
                                    graph.fw_info)
             else:
                 if node.is_activation_quantization_enabled():
@@ -83,8 +82,7 @@ def set_bit_widths(mixed_precision_enable: bool,
 
 
 def _get_node_qc_by_bit_widths(node: BaseNode,
-                               bit_width_cfg: List[int],
-                               node_index_in_graph: int,
+                               node_bit_width_cfg: int,
                                fw_info) -> Any:
     """
     Get the node's quantization configuration that
@@ -93,8 +91,7 @@ def _get_node_qc_by_bit_widths(node: BaseNode,
 
     Args:
         node: Node to get its quantization configuration candidate.
-        bit_width_cfg: Configuration which determines the node's desired bit width.
-        node_index_in_graph: Index of the node in the bit_width_cfg.
+        node_bit_width_cfg: Configuration which determines the node's desired bit width.
         fw_info: Information relevant to a specific framework about how layers should be quantized.
 
     Returns:
@@ -104,24 +101,21 @@ def _get_node_qc_by_bit_widths(node: BaseNode,
     kernel_attr = fw_info.get_kernel_op_attributes(node.type)
 
     if node.is_activation_quantization_enabled():
-        bit_index_in_cfg = bit_width_cfg[node_index_in_graph]
-        qc = node.candidates_quantization_cfg[bit_index_in_cfg]
+        qc = node.candidates_quantization_cfg[node_bit_width_cfg]
 
         return qc
 
     elif kernel_attr is not None:
         if node.is_weights_quantization_enabled(kernel_attr[0]):
-            bit_index_in_cfg = bit_width_cfg[node_index_in_graph]
-            qc = node.candidates_quantization_cfg[bit_index_in_cfg]
+            qc = node.candidates_quantization_cfg[node_bit_width_cfg]
 
             return qc
 
     Logger.critical(f"Quantization configuration for node '{node.name}' not found in candidate configurations.")  # pragma: no cover
 
 
-def _set_node_final_qc(bit_width_cfg: List[int],
+def _set_node_final_qc(node_bit_width_cfg: int,
                        node: BaseNode,
-                       node_index_in_graph: int,
                        fw_info):
     """
     Get the node's quantization configuration that
@@ -130,15 +124,13 @@ def _set_node_final_qc(bit_width_cfg: List[int],
     If the node quantization config was not found, raise an exception.
 
     Args:
-        bit_width_cfg: Configuration which determines the node's desired bit width.
+        node_bit_width_cfg: Configuration which determines the node's desired bit width.
         node: Node to set its node quantization configuration.
-        node_index_in_graph: Index of the node in the bit_width_cfg.
         fw_info: Information relevant to a specific framework about how layers should be quantized.
 
     """
     node_qc = _get_node_qc_by_bit_widths(node,
-                                         bit_width_cfg,
-                                         node_index_in_graph,
+                                         node_bit_width_cfg,
                                          fw_info)
 
     if node_qc is None:

model_compression_toolkit/core/common/mixed_precision/mixed_precision_candidates_filter.py

@@ -30,7 +30,7 @@ def filter_candidates_for_mixed_precision(graph: Graph,
     such that only a single candidate would remain, with the bitwidth equal to the one defined in the matching layer's
     base config in the TPC.
 
-    Note" This function modifies the graph inplace!
+    Note: This function modifies the graph inplace!
 
     Args:
         graph: A graph representation of the model to be quantized.

model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/resource_utilization_data.py

@@ -57,7 +57,6 @@ def compute_resource_utilization_data(in_model: Any,
     Returns:
         ResourceUtilization: An object encapsulating the calculated resource utilization computations.
 
-
     """
     core_config = _create_core_config_for_ru(core_config)
     # We assume that the resource_utilization_data API is used to compute the model resource utilization for

model_compression_toolkit/core/common/mixed_precision/resource_utilization_tools/ru_aggregation_methods.py

@@ -33,9 +33,10 @@ def sum_ru_values(ru_vector: np.ndarray, set_constraints: bool = True) -> List[A
     Returns: A list with an lpSum object for lp problem definition with the vector's sum.
 
     """
-    if not set_constraints:
-        return [0] if len(ru_vector) == 0 else [sum(ru_vector)]
-    return [lpSum(ru_vector)]
+    if set_constraints:
+        return [lpSum(ru_vector)]
+    return [0] if len(ru_vector) == 0 else [sum(ru_vector)]
+
 
 
 def max_ru_values(ru_vector: np.ndarray, set_constraints: bool = True) -> List[float]:
@@ -53,9 +54,10 @@ def max_ru_values(ru_vector: np.ndarray, set_constraints: bool = True) -> List[f
     in the linear programming problem formalization.
 
     """
-    if not set_constraints:
-        return [0] if len(ru_vector) == 0 else [max(ru_vector)]
-    return [ru for ru in ru_vector]
+    if set_constraints:
+        return [ru for ru in ru_vector]
+    return [0] if len(ru_vector) == 0 else [max(ru_vector)]
+
 
 
 def total_ru(ru_tensor: np.ndarray, set_constraints: bool = True) -> List[float]:
@@ -74,16 +76,14 @@ def total_ru(ru_tensor: np.ndarray, set_constraints: bool = True) -> List[float]
     in the linear programming problem formalization.
 
     """
-    if not set_constraints:
+    if set_constraints:
+        weights_ru = lpSum([ru[0] for ru in ru_tensor])
+        return [weights_ru + activation_ru for _, activation_ru in ru_tensor]
+    else:
         weights_ru = sum([ru[0] for ru in ru_tensor])
         activation_ru = max([ru[1] for ru in ru_tensor])
         return [weights_ru + activation_ru]
 
-    weights_ru = lpSum([ru[0] for ru in ru_tensor])
-    total_ru = [weights_ru + activation_ru for _, activation_ru in ru_tensor]
-
-    return total_ru
-
 
 class MpRuAggregation(Enum):
     """

model_compression_toolkit/core/common/mixed_precision/search_methods/linear_programming.py

@@ -73,7 +73,7 @@ def mp_integer_programming_search(search_manager: MixedPrecisionSearchManager,
 
     assert lp_problem.status == LpStatusOptimal, Logger.critical(
         "No solution was found during solving the LP problem")
-    Logger.info(LpStatus[lp_problem.status])
+    Logger.info(f"ILP status: {LpStatus[lp_problem.status]}")
 
     # Take the bitwidth index only if its corresponding indicator is one.
     config = np.asarray(
@@ -82,7 +82,7 @@ def mp_integer_programming_search(search_manager: MixedPrecisionSearchManager,
          in layer_to_indicator_vars_mapping.values()]
     ).flatten()
 
-    if target_resource_utilization.bops < np.inf:
+    if target_resource_utilization.bops_restricted():
         return search_manager.config_reconstruction_helper.reconstruct_config_from_virtual_graph(config)
     else:
         return config

model_compression_toolkit/core/common/mixed_precision/solution_refinement_procedure.py

@@ -47,7 +47,7 @@ def greedy_solution_refinement_procedure(mp_solution: List[int],
 
     """
     # Refinement is not supported for BOPs utilization for now...
-    if target_resource_utilization.bops < np.inf:
+    if target_resource_utilization.bops_restricted():
         Logger.info(f'Target resource utilization constraint BOPs - Skipping MP greedy solution refinement')
         return mp_solution
 

model_compression_toolkit/core/runner.py

@@ -151,8 +151,7 @@ def core_runner(in_model: Any,
                 f'Mixed Precision has overwrite bit-width configuration{core_config.mixed_precision_config.configuration_overwrite}')
             bit_widths_config = core_config.mixed_precision_config.configuration_overwrite
 
-        if (target_resource_utilization.activation_memory < np.inf or
-                target_resource_utilization.total_memory < np.inf):
+        if target_resource_utilization.activation_restricted() or target_resource_utilization.total_mem_restricted():
             Logger.warning(
                 f"Running mixed precision for activation compression, please note this feature is experimental and is "
                 f"subject to future changes. If you encounter an issue, please open an issue in our GitHub "