@@ -903,7 +903,7 @@ <h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">
903903< p > Please also refer to < a href ="https://github.com/frequenz-floss/frequenz-client-reporting-python/tree/HEAD/examples "> examples</ a > for more detailed usage.</ p >
904904< h3 id ="installation "> Installation< a class ="headerlink " href ="#installation " title ="Permanent link "> ¤</ a > </ h3 >
905905< div class ="language-bash highlight "> < pre > < span > </ span > < code > < span id ="__span-0-1 "> < a id ="__codelineno-0-1 " name ="__codelineno-0-1 " href ="#__codelineno-0-1 "> </ a > < span class ="c1 "> # Choose the version you want to install</ span >
906- </ span > < span id ="__span-0-2 "> < a id ="__codelineno-0-2 " name ="__codelineno-0-2 " href ="#__codelineno-0-2 "> </ a > < span class ="nv "> VERSION</ span > < span class ="o "> =</ span > < span class ="m "> 0</ span > .16 .0
906+ </ span > < span id ="__span-0-2 "> < a id ="__codelineno-0-2 " name ="__codelineno-0-2 " href ="#__codelineno-0-2 "> </ a > < span class ="nv "> VERSION</ span > < span class ="o "> =</ span > < span class ="m "> 0</ span > .17 .0
907907</ span > < span id ="__span-0-3 "> < a id ="__codelineno-0-3 " name ="__codelineno-0-3 " href ="#__codelineno-0-3 "> </ a > pip< span class ="w "> </ span > install< span class ="w "> </ span > frequenz-client-reporting< span class ="o "> ==</ span > < span class ="nv "> $VERSION</ span >
908908</ span > </ code > </ pre > </ div >
909909< h3 id ="initialize-the-client "> Initialize the client< a class ="headerlink " href ="#initialize-the-client " title ="Permanent link "> ¤</ a > </ h3 >
@@ -928,8 +928,8 @@ <h3 id="query-metrics-for-a-single-microgrid-and-component">Query metrics for a
928928</ span > < span id ="__span-2-4 "> < a id ="__codelineno-2-4 " name ="__codelineno-2-4 " href ="#__codelineno-2-4 "> </ a > < span class ="n "> microgrid_id</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ,</ span >
929929</ span > < span id ="__span-2-5 "> < a id ="__codelineno-2-5 " name ="__codelineno-2-5 " href ="#__codelineno-2-5 "> </ a > < span class ="n "> component_id</ span > < span class ="o "> =</ span > < span class ="mi "> 100</ span > < span class ="p "> ,</ span >
930930</ span > < span id ="__span-2-6 "> < a id ="__codelineno-2-6 " name ="__codelineno-2-6 " href ="#__codelineno-2-6 "> </ a > < span class ="n "> metrics</ span > < span class ="o "> =</ span > < span class ="p "> [</ span > < span class ="n "> Metric</ span > < span class ="o "> .</ span > < span class ="n "> AC_ACTIVE_POWER</ span > < span class ="p "> ,</ span > < span class ="n "> Metric</ span > < span class ="o "> .</ span > < span class ="n "> AC_REACTIVE_POWER</ span > < span class ="p "> ],</ span >
931- </ span > < span id ="__span-2-7 "> < a id ="__codelineno-2-7 " name ="__codelineno-2-7 " href ="#__codelineno-2-7 "> </ a > < span class ="n "> start_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
932- </ span > < span id ="__span-2-8 "> < a id ="__codelineno-2-8 " name ="__codelineno-2-8 " href ="#__codelineno-2-8 "> </ a > < span class ="n "> end_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
931+ </ span > < span id ="__span-2-7 "> < a id ="__codelineno-2-7 " name ="__codelineno-2-7 " href ="#__codelineno-2-7 "> </ a > < span class ="n "> start_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
932+ </ span > < span id ="__span-2-8 "> < a id ="__codelineno-2-8 " name ="__codelineno-2-8 " href ="#__codelineno-2-8 "> </ a > < span class ="n "> end_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
933933</ span > < span id ="__span-2-9 "> < a id ="__codelineno-2-9 " name ="__codelineno-2-9 " href ="#__codelineno-2-9 "> </ a > < span class ="n "> resampling_period</ span > < span class ="o "> =</ span > < span class ="n "> timedelta</ span > < span class ="p "> (</ span > < span class ="n "> seconds</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ),</ span >
934934</ span > < span id ="__span-2-10 "> < a id ="__codelineno-2-10 " name ="__codelineno-2-10 " href ="#__codelineno-2-10 "> </ a > < span class ="p "> )</ span >
935935</ span > < span id ="__span-2-11 "> < a id ="__codelineno-2-11 " name ="__codelineno-2-11 " href ="#__codelineno-2-11 "> </ a > < span class ="p "> ]</ span >
@@ -941,8 +941,8 @@ <h3 id="query-metrics-for-a-single-microgrid-and-sensor">Query metrics for a sin
941941</ span > < span id ="__span-3-4 "> < a id ="__codelineno-3-4 " name ="__codelineno-3-4 " href ="#__codelineno-3-4 "> </ a > < span class ="n "> microgrid_id</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ,</ span >
942942</ span > < span id ="__span-3-5 "> < a id ="__codelineno-3-5 " name ="__codelineno-3-5 " href ="#__codelineno-3-5 "> </ a > < span class ="n "> sensor_id</ span > < span class ="o "> =</ span > < span class ="mi "> 100</ span > < span class ="p "> ,</ span >
943943</ span > < span id ="__span-3-6 "> < a id ="__codelineno-3-6 " name ="__codelineno-3-6 " href ="#__codelineno-3-6 "> </ a > < span class ="n "> metrics</ span > < span class ="o "> =</ span > < span class ="p "> [</ span > < span class ="n "> Metric</ span > < span class ="o "> .</ span > < span class ="n "> SENSOR_IRRADIANCE</ span > < span class ="p "> ],</ span >
944- </ span > < span id ="__span-3-7 "> < a id ="__codelineno-3-7 " name ="__codelineno-3-7 " href ="#__codelineno-3-7 "> </ a > < span class ="n "> start_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
945- </ span > < span id ="__span-3-8 "> < a id ="__codelineno-3-8 " name ="__codelineno-3-8 " href ="#__codelineno-3-8 "> </ a > < span class ="n "> end_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
944+ </ span > < span id ="__span-3-7 "> < a id ="__codelineno-3-7 " name ="__codelineno-3-7 " href ="#__codelineno-3-7 "> </ a > < span class ="n "> start_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
945+ </ span > < span id ="__span-3-8 "> < a id ="__codelineno-3-8 " name ="__codelineno-3-8 " href ="#__codelineno-3-8 "> </ a > < span class ="n "> end_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
946946</ span > < span id ="__span-3-9 "> < a id ="__codelineno-3-9 " name ="__codelineno-3-9 " href ="#__codelineno-3-9 "> </ a > < span class ="n "> resampling_period</ span > < span class ="o "> =</ span > < span class ="n "> timedelta</ span > < span class ="p "> (</ span > < span class ="n "> seconds</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ),</ span >
947947</ span > < span id ="__span-3-10 "> < a id ="__codelineno-3-10 " name ="__codelineno-3-10 " href ="#__codelineno-3-10 "> </ a > < span class ="p "> )</ span >
948948</ span > < span id ="__span-3-11 "> < a id ="__codelineno-3-11 " name ="__codelineno-3-11 " href ="#__codelineno-3-11 "> </ a > < span class ="p "> ]</ span >
@@ -964,8 +964,8 @@ <h3 id="query-metrics-for-multiple-microgrids-and-components">Query metrics for
964964</ span > < span id ="__span-4-14 "> < a id ="__codelineno-4-14 " name ="__codelineno-4-14 " href ="#__codelineno-4-14 "> </ a > < span class ="n "> client</ span > < span class ="o "> .</ span > < span class ="n "> list_microgrid_components_data</ span > < span class ="p "> (</ span >
965965</ span > < span id ="__span-4-15 "> < a id ="__codelineno-4-15 " name ="__codelineno-4-15 " href ="#__codelineno-4-15 "> </ a > < span class ="n "> microgrid_components</ span > < span class ="o "> =</ span > < span class ="n "> microgrid_components</ span > < span class ="p "> ,</ span >
966966</ span > < span id ="__span-4-16 "> < a id ="__codelineno-4-16 " name ="__codelineno-4-16 " href ="#__codelineno-4-16 "> </ a > < span class ="n "> metrics</ span > < span class ="o "> =</ span > < span class ="p "> [</ span > < span class ="n "> Metric</ span > < span class ="o "> .</ span > < span class ="n "> AC_ACTIVE_POWER</ span > < span class ="p "> ,</ span > < span class ="n "> Metric</ span > < span class ="o "> .</ span > < span class ="n "> AC_REACTIVE_POWER</ span > < span class ="p "> ],</ span >
967- </ span > < span id ="__span-4-17 "> < a id ="__codelineno-4-17 " name ="__codelineno-4-17 " href ="#__codelineno-4-17 "> </ a > < span class ="n "> start_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
968- </ span > < span id ="__span-4-18 "> < a id ="__codelineno-4-18 " name ="__codelineno-4-18 " href ="#__codelineno-4-18 "> </ a > < span class ="n "> end_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
967+ </ span > < span id ="__span-4-17 "> < a id ="__codelineno-4-17 " name ="__codelineno-4-17 " href ="#__codelineno-4-17 "> </ a > < span class ="n "> start_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
968+ </ span > < span id ="__span-4-18 "> < a id ="__codelineno-4-18 " name ="__codelineno-4-18 " href ="#__codelineno-4-18 "> </ a > < span class ="n "> end_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
969969</ span > < span id ="__span-4-19 "> < a id ="__codelineno-4-19 " name ="__codelineno-4-19 " href ="#__codelineno-4-19 "> </ a > < span class ="n "> resampling_period</ span > < span class ="o "> =</ span > < span class ="n "> timedelta</ span > < span class ="p "> (</ span > < span class ="n "> seconds</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ),</ span >
970970</ span > < span id ="__span-4-20 "> < a id ="__codelineno-4-20 " name ="__codelineno-4-20 " href ="#__codelineno-4-20 "> </ a > < span class ="n "> include_states</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span > < span class ="p "> ,</ span > < span class ="c1 "> # Set to True to include state data</ span >
971971</ span > < span id ="__span-4-21 "> < a id ="__codelineno-4-21 " name ="__codelineno-4-21 " href ="#__codelineno-4-21 "> </ a > < span class ="n "> include_bounds</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span > < span class ="p "> ,</ span > < span class ="c1 "> # Set to True to include metric bounds data</ span >
@@ -989,8 +989,8 @@ <h3 id="query-metrics-for-multiple-microgrids-and-sensors">Query metrics for mul
989989</ span > < span id ="__span-5-14 "> < a id ="__codelineno-5-14 " name ="__codelineno-5-14 " href ="#__codelineno-5-14 "> </ a > < span class ="n "> client</ span > < span class ="o "> .</ span > < span class ="n "> receive_microgrid_sensors_data</ span > < span class ="p "> (</ span >
990990</ span > < span id ="__span-5-15 "> < a id ="__codelineno-5-15 " name ="__codelineno-5-15 " href ="#__codelineno-5-15 "> </ a > < span class ="n "> microgrid_sensors</ span > < span class ="o "> =</ span > < span class ="n "> microgrid_sensors</ span > < span class ="p "> ,</ span >
991991</ span > < span id ="__span-5-16 "> < a id ="__codelineno-5-16 " name ="__codelineno-5-16 " href ="#__codelineno-5-16 "> </ a > < span class ="n "> metrics</ span > < span class ="o "> =</ span > < span class ="p "> [</ span > < span class ="n "> Metric</ span > < span class ="o "> .</ span > < span class ="n "> SENSOR_IRRADIANCE</ span > < span class ="p "> ],</ span >
992- </ span > < span id ="__span-5-17 "> < a id ="__codelineno-5-17 " name ="__codelineno-5-17 " href ="#__codelineno-5-17 "> </ a > < span class ="n "> start_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
993- </ span > < span id ="__span-5-18 "> < a id ="__codelineno-5-18 " name ="__codelineno-5-18 " href ="#__codelineno-5-18 "> </ a > < span class ="n "> end_dt </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
992+ </ span > < span id ="__span-5-17 "> < a id ="__codelineno-5-17 " name ="__codelineno-5-17 " href ="#__codelineno-5-17 "> </ a > < span class ="n "> start_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-01T00:00:00"</ span > < span class ="p "> ),</ span >
993+ </ span > < span id ="__span-5-18 "> < a id ="__codelineno-5-18 " name ="__codelineno-5-18 " href ="#__codelineno-5-18 "> </ a > < span class ="n "> end_time </ span > < span class ="o "> =</ span > < span class ="n "> datetime</ span > < span class ="o "> .</ span > < span class ="n "> fromisoformat</ span > < span class ="p "> (</ span > < span class ="s2 "> "2024-05-02T00:00:00"</ span > < span class ="p "> ),</ span >
994994</ span > < span id ="__span-5-19 "> < a id ="__codelineno-5-19 " name ="__codelineno-5-19 " href ="#__codelineno-5-19 "> </ a > < span class ="n "> resampling_period</ span > < span class ="o "> =</ span > < span class ="n "> timedelta</ span > < span class ="p "> (</ span > < span class ="n "> seconds</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ),</ span >
995995</ span > < span id ="__span-5-20 "> < a id ="__codelineno-5-20 " name ="__codelineno-5-20 " href ="#__codelineno-5-20 "> </ a > < span class ="n "> include_states</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span > < span class ="p "> ,</ span > < span class ="c1 "> # Set to True to include state data</ span >
996996</ span > < span id ="__span-5-21 "> < a id ="__codelineno-5-21 " name ="__codelineno-5-21 " href ="#__codelineno-5-21 "> </ a > < span class ="p "> )</ span >
0 commit comments