ggf$ SSKJrJr SSKr"SS5r\"S/SQSS\R SS4S 9r"S S\5r"S S \5r "S S5r "SS5r "SS\5r "SS5r g))UserDict namedtupleNc\rSrSrSrSrSrg) ImportanceN)__name__ __module__ __qualname____firstlineno__OPTIONALREQUIRED__static_attributes__r 4nsight-compute-2025.1.1/sections/RequestedMetrics.pyrrs HHrr MetricRequest)namealias importance default_valuewarn_when_missinggT)defaultsc\rSrSrSrSrg)raHA metric request containing name, and optional alias, importance and default value. Args: name (str): The name of the metric. alias (str, optional): An alias for the metric name. Defaults to None. importance (:obj:`Importance`, optional): Whether the metric is required or optional. Defaults to Importance.REQUIRED. default_value (int, float, string, optional): A default value for OPTIONAL metrics. Defaults to float(0). warn_when_missing (bool, optional): Whether to issue a warning when an OPTIONAL metric is missing. Defaults to True. r N)r r r r__doc__rr rrrrs   rc0^\rSrSrSrSU4SjjrSrU=r$)MetricNotFoundError$aException raised when metric cannot be found. Args: name (str): The name of the metric that was not found. importance (:obj:`Importance`): Whether the metric was marked required or optional. message (str): A message explaining the error c>U[R:XaSOSnSRXA5nXlX lU=(d UUl[ TU]UR 5 g)NRequiredOptionalz {} metric {} could not be found.)rrformatrrmessagesuper__init__)selfrrr%importance_strdefault_message __class__s rr'MetricNotFoundError.__init__.sN'1Z5H5H'Hj<CCNY $1/  &r)rr%rN)r r r rrr'r __classcell__r+s@rrr$s''rrcz\rSrSrSr\R rS Sjr\ S5r \ S5r \ S5r \ S5r S rg) RequestedMetric8a{Wrapper class for available (loaded) metrics. Args: name (str): The name of the metric. metric (:obj:`IMetric`): An IMetric object representing the metric. importance (:obj:`Importance`, optional): Whether the metric was marked required or optional. Defaults to Importance.REQUIRED. alias (str, optional): An alias for the metric name. Defaults to None. NcdXlX lU=(d [RUlX@lgr-)_name_metricr1_DEFAULT_IMPORTANCE _importance_alias)r(rmetricrrs rr'RequestedMetric.__init__Es$  %L)L)L rcUR$r-)r4r(s rrRequestedMetric.nameKs zzrcUR$r-r5r<s rr9RequestedMetric.metricOs ||rcUR$r-)r7r<s rrRequestedMetric.importanceSsrcUR$r-)r8r<s rrRequestedMetric.aliasWs {{r)r8r7r5r4)NN)r r r rrrrr6r'propertyrr9rrrr rrr1r18sj%--   rr1cB\rSrSrSr\R S4SjrSrSr g)RequestedMetricBuilder\aBuilds a RequestedMetric from an IMetric contained in an IAction. Args: metrics (:obj:`IAction`): An IAction object (potentially) containing the IMetric associated with `name`. name (str): The name of the metric. importance (:obj:`Importance`, optional): Whether the metric was marked required or optional. Defaults to Importance.REQUIRED. alias (str, optional): An alias for the metric name. Defaults to None. Raises: MetricNotFoundError: If no IMetric object associated with `name` is available. NcpSUlXn[X%X45Ulg![a [X#5ef=fr-)r5r1KeyErrorr)r(metricsrrrr9s rr'RequestedMetricBuilder.__init__ks=  8]F*4KDL 8%d7 7 8s5cUR$r-r?r<s rbuildRequestedMetricBuilder.buildus ||rr?) r r r rrrrr'rNrr rrrGrG\s# 2<1D1DD84rrGcP^\rSrSrSrU4SjrU4SjrU4SjrU4SjrSr U=r $)RequestedMetricDictyaCCustom dict for IMetric lookup using either the metric's name or alias. Allows insertion of RequestedMetric values using a key that matches either the metric's name or its alias. Lookup will return the IMetric object directly. Lookup can be done using name or alias, independently of how the RequestedMetric was inserted. c0>0Ul[TU] 5 gr-) aliasToNamer&r')r(r+s rr'RequestedMetricDict.__init__s rc>[TU]U5R$![a Of=f[TU]URU5R$![a Of=f[U5er-)r& __getitem__r9rJrT)r(keyr+s rrWRequestedMetricDict.__getitem__sr 7&s+22 2    7&t'7'7'<=DD D   sms ))%A A A c>URnURnX:waX:wa [S5eUbJX@R;a-URUU:wa[SR XA55eX0RU'[ TU]X25$)Nz1Key must match either the metric's name or alias.z%Alias {} is already used by metric {})rrrJrTr$r& __setitem__)r(rXitemrrr+s rr[RequestedMetricDict.__setitem__syy  KclNO O  )))0@0@0G40OFMMeYZZ&*  U #w"4..rcP>XR;n[TU] U5=(d U$r-)rTr& __contains__)r(rXis_aliasr+s rr_ RequestedMetricDict.__contains__s&***w#C(4H4r)rT) r r r rrr'rWr[r_rr.r/s@rrQrQys! / 55rrQc:\rSrSrSrSrSrSrSrSr Sr S r g ) RequestedMetricsParserzConvenience class to query IMetric objects from an IAction. Args: handle: The NvRules ContextHandle. action (:obj:`IAction`): IAction object containing the IMetrics to be requested. z:Some required metrics are missing; aborted rule execution.cnXl[R"U5R5UlX lgr-)handleNvRules get_contextfrontendrK)r(rfactions rr'RequestedMetricsParser.__init__s' ++F3<<>  rc [5nSnSnUHRn[URURURUR S9R 5X%R'MT U(a/[R,"UR.[0R25 U$![GaKnUR[R:Xa[URURU5URUR S9X%R'UR(aZU(dLURR[R R"UR%U55 SnSnAGM`SnAGMgSnAGMnUR[R&:XaLSnURR[R R(UR+U55 SnAGMSnAGMSnAff=f)akParse a list of `MetricRequest`s and return a custom dict of `IMetric` objects. Args: requested_metrics (List[MetricRequest]): A list of requested metrics. Returns: A RequestedMetricDict, which returns an IMetric object for any valid metric name or alias. Raises: SystemError: If any REQUIRED metric is not contained in the IAction object. F)rrKrr)rr9rrTN)rQrGrrKrrrNrrrr1_create_fallback_metricrrir%rg IFrontendMsgType_MSG_WARNING$_get_missing_optional_metric_warningrMsgType_MSG_ERROR$_get_missing_required_metric_warningraise_exceptionrfrc!_MISSING_REQUIRED_METRICS_MESSAGE)r(requested_metricsparsed_metricsfound_missing_required_metricsfound_missing_optional_metricsr9errors rparseRequestedMetricsParser.parses-.).&).&'F .D LL%00 ,, / %' {{+(< *  # # 3UU 7' ##z':'::2A#[[#;;FC#)#4#4$ll 3N;;///8V --#--AA EEeL:>6 9W/ %%)<)<<592MM))));;AA%H= s AB G5*CG0?A#G00G5c(URcgURnURRUR5n[ U[ 5(a2US:a,UR [RRU5 U$[ U[5(a,UR[RRU5 U$[ U[5(a,UR[RRU5 U$[!S5e)Nrz8Can only create fallback metric from uint, float or str.)rrK add_metricr isinstanceint set_uint64rgIMetricValueKind_UINT64float set_doubleValueKind_DOUBLEstr set_stringValueKind_STRING ValueError)r(metric_requestvaluefallback_metrics rrm.RequestedMetricsParser._create_fallback_metrics  ' ' /,,,,11.2E2EF eS ! !eqj  & &w'G'G Ou % %  & &w'G'G O  s # #  & &w'G'G OWX XrcJ[SRUR55$)NzThe optional metric {} could not be found. Collecting it as an additional metric could enable the rule to provide more guidance.)rr$rr(rys rrp;RequestedMetricsParser._get_missing_optional_metric_warnings" ((.uzz(:  rcUR$r-)r%rs rrr;RequestedMetricsParser._get_missing_required_metric_warnings }}r)rirfrKN) r r r rrrtr'rzrmrprrrr rrrcrcs, E& 4l$ rrc) collectionsrrrgrr_MetricRequestr Exceptionrr1rGrQrcr rrrs, ID*--sD 9 N "')'(!!H:*5(*5Zaar