powerlog 0.0.1__tar.gz

powerlog-0.0.1/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

powerlog-0.0.1/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

powerlog-0.0.1/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.12 (powerlog)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.12 (powerlog)" project-jdk-type="Python SDK" />
+</project>

powerlog-0.0.1/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/powerlog.iml" filepath="$PROJECT_DIR$/.idea/powerlog.iml" />
+    </modules>
+  </component>
+</project>

powerlog-0.0.1/.idea/powerlog.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.12 (powerlog)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

powerlog-0.0.1/.idea/workspace.xml

@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="4ef7608a-8f08-4a0e-91d4-612ae53ad9fc" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 3
+}]]></component>
+  <component name="ProjectId" id="2zIXWyB0VVxNT3eQh5fkkI5Lg6L" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "last_opened_file_path": "/media/shovon/Codes/GithubCodes/powerlog",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="RunManager">
+    <configuration name="main" type="PythonConfigurationType" factoryName="Python" nameIsGenerated="true">
+      <module name="powerlog" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-b26f3e71634d-JavaScript-PY-251.26094.141" />
+        <option value="bundled-python-sdk-9f8e2b94138c-36ea0e71a18c-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-251.26094.141" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="4ef7608a-8f08-4a0e-91d4-612ae53ad9fc" name="Changes" comment="" />
+      <created>1751419597209</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1751419597209</updated>
+      <workItem from="1751419598405" duration="1599000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

powerlog-0.0.1/Changelog.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## 0.0.1 (2025-07-01)
+- Initial release

powerlog-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmedur Rahman Shovon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

powerlog-0.0.1/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: powerlog
+Version: 0.0.1
+Summary: GPU power log
+Project-URL: Homepage, https://github.com/arsho/powerlog
+Project-URL: Issues, https://github.com/arsho/powerlog/issues
+Author-email: Ahmedur Rahman Shovon <shovon.sylhet@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: energy,gpupower,power analysis,power log,powerlog
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# powerlog
+
+**Powerlog** is a lightweight command-line tool and Python package to profile GPU power consumption during the execution of a command-line program. It uses `nvidia-smi` to sample power draw at regular intervals and reports total energy usage, average power, and min/max readings.
+
+## Features
+
+* Measures real-time GPU power draw using `nvidia-smi`
+* Computes:
+
+  * Total runtime
+  * Total energy consumed (in Joules)
+  * Average, min, and max power (Watts)
+* Outputs both summary and raw samples as CSV
+* Simple CLI interface
+
+## Installation
+
+Requires Python 3.6+ and NVIDIA's `nvidia-smi` available in your system PATH.
+
+```bash
+pip install powerlog
+```
+
+## Usage
+
+```bash
+powerlog --output power_report.csv --gpu 2 ./my_gpu_program arg1 arg2
+```
+
+### CLI Options
+
+| Argument     | Description                                 |
+| ------------ | ------------------------------------------- |
+| `--output`   | Base name for the output CSV files          |
+| `--gpu`      | Number of GPUs to monitor (default: 1)      |
+| `cmd`        | Command and arguments to run and profile    |
+
+## Output
+
+If `--output power.csv` is specified:
+
+* `power.csv`: Summary of runtime, energy, and power stats
+* `power_samples.csv`: Raw timestamped power draw samples
+
+## Example
+
+```bash
+powerlog --output matrix_power.csv --gpu 1 ./matrix_multiply data/input.bin
+powerlog --output matrix_power.csv --gpu 1 nvidia-smi
+```
+
+## Dependencies
+
+* Python standard library (`subprocess`, `argparse`, `time`, `csv`)
+* NVIDIA GPU with drivers and `nvidia-smi` tool
+
+## License
+
+MIT License
+
+## Acknowledgments
+
+Developed as part of GPU power-efficiency profiling experiments in Datalog-based engines.

powerlog-0.0.1/README.md

@@ -0,0 +1,63 @@
+# powerlog
+
+**Powerlog** is a lightweight command-line tool and Python package to profile GPU power consumption during the execution of a command-line program. It uses `nvidia-smi` to sample power draw at regular intervals and reports total energy usage, average power, and min/max readings.
+
+## Features
+
+* Measures real-time GPU power draw using `nvidia-smi`
+* Computes:
+
+  * Total runtime
+  * Total energy consumed (in Joules)
+  * Average, min, and max power (Watts)
+* Outputs both summary and raw samples as CSV
+* Simple CLI interface
+
+## Installation
+
+Requires Python 3.6+ and NVIDIA's `nvidia-smi` available in your system PATH.
+
+```bash
+pip install powerlog
+```
+
+## Usage
+
+```bash
+powerlog --output power_report.csv --gpu 2 ./my_gpu_program arg1 arg2
+```
+
+### CLI Options
+
+| Argument     | Description                                 |
+| ------------ | ------------------------------------------- |
+| `--output`   | Base name for the output CSV files          |
+| `--gpu`      | Number of GPUs to monitor (default: 1)      |
+| `cmd`        | Command and arguments to run and profile    |
+
+## Output
+
+If `--output power.csv` is specified:
+
+* `power.csv`: Summary of runtime, energy, and power stats
+* `power_samples.csv`: Raw timestamped power draw samples
+
+## Example
+
+```bash
+powerlog --output matrix_power.csv --gpu 1 ./matrix_multiply data/input.bin
+powerlog --output matrix_power.csv --gpu 1 nvidia-smi
+```
+
+## Dependencies
+
+* Python standard library (`subprocess`, `argparse`, `time`, `csv`)
+* NVIDIA GPU with drivers and `nvidia-smi` tool
+
+## License
+
+MIT License
+
+## Acknowledgments
+
+Developed as part of GPU power-efficiency profiling experiments in Datalog-based engines.

powerlog-0.0.1/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "powerlog"
+version = "0.0.1"
+dependencies = []
+requires-python = ">=3.8"
+authors = [
+  {name = "Ahmedur Rahman Shovon", email = "shovon.sylhet@gmail.com"},
+]
+description = "GPU power log"
+readme = "README.md"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta"
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+keywords = ["powerlog", "gpupower", "energy", "power analysis", "power log"]
+
+[project.urls]
+Homepage = "https://github.com/arsho/powerlog"
+Issues = "https://github.com/arsho/powerlog/issues"

powerlog-0.0.1/src/powerlog/__init__.py

@@ -0,0 +1,128 @@
+import subprocess
+import sys
+import time
+import csv
+import argparse
+
+NS_IN_S = 1_000_000_000  # Nanoseconds in a second
+
+def log(message):
+    print(message, file=sys.stdout)
+
+def get_power_draw(total_gpu_on_node=1):
+    proc = subprocess.run(
+        ["nvidia-smi", "--query-gpu=power.draw", "--format=csv,noheader,nounits"],
+        capture_output=True
+    )
+    stdout = proc.stdout.decode("utf-8").strip()
+    power_values = [float(line.strip()) for line in stdout.splitlines()]
+    return sum(power_values[:total_gpu_on_node])
+
+def measure_power(cmd_args, resolution=0.1, total_gpu_on_node=1):
+    get_power_draw()  # warm-up
+    energy_j = 0
+    power_draw_samples = []
+
+    proc = subprocess.Popen(cmd_args)
+    start_time_ns = time.time_ns()
+    time_ns = start_time_ns
+
+    while True:
+        try:
+            proc.wait(timeout=resolution)
+        except subprocess.TimeoutExpired:
+            new_time_ns = time.time_ns()
+            draw_w = get_power_draw()
+            delay_ns = new_time_ns - time_ns
+            energy_j += delay_ns * draw_w / NS_IN_S
+            power_draw_samples.append((new_time_ns, draw_w))
+            time_ns = new_time_ns
+        else:
+            break
+
+    end_time_ns = time_ns
+    total_time_s = (end_time_ns - start_time_ns) / NS_IN_S
+    sampled_draws = [v[1] for v in power_draw_samples]
+    avg_power_sampled = sum(sampled_draws) / len(sampled_draws)
+    avg_power_timed = energy_j / total_time_s
+    min_draw = min(sampled_draws)
+    max_draw = max(sampled_draws)
+
+    return {
+        "total_time_s": total_time_s,
+        "energy_j": energy_j,
+        "avg_power_sampled": avg_power_sampled,
+        "avg_power_timed": avg_power_timed,
+        "min_draw": min_draw,
+        "max_draw": max_draw,
+        "samples": power_draw_samples
+    }
+
+def save_summary_csv(path, result):
+    with open(path, 'w', newline='') as csvfile:
+        writer = csv.writer(csvfile)
+        writer.writerow([
+            "Total Time (s)",
+            "Total Energy (J)",
+            "Avg Power Sampled (W)",
+            "Avg Power Timed (W)",
+            "Min Power Sampled (W)",
+            "Max Power Sampled (W)"
+        ])
+        writer.writerow([
+            f"{result['total_time_s']:.4f}",
+            f"{result['energy_j']:.4f}",
+            f"{result['avg_power_sampled']:.4f}",
+            f"{result['avg_power_timed']:.4f}",
+            f"{result['min_draw']:.2f}",
+            f"{result['max_draw']:.2f}"
+        ])
+
+def save_samples_csv(path, samples):
+    with open(path, 'w', newline='') as csvfile:
+        writer = csv.writer(csvfile)
+        writer.writerow(["Timestamp (ns)", "Power Draw (W)"])
+        for t_ns, draw in samples:
+            writer.writerow([t_ns, f"{draw:.2f}"])
+
+def main():
+    parser = argparse.ArgumentParser(description="Measure GPU power during execution.")
+    parser.add_argument("cmd", nargs=argparse.REMAINDER, help="Command to run (mandatory)")
+    parser.add_argument("--output", type=str, help="Output CSV base name (optional)")
+    parser.add_argument("--gpu", type=int, default=1, help="Number of GPUs per node (default 1)")
+
+    try:
+        args = parser.parse_args()
+    except:
+        parser.print_help()
+        sys.exit(0)
+
+    log(f"Running command: {' '.join(args.cmd)} on {args.gpu} GPU")
+    result = measure_power(args.cmd, total_gpu_on_node = args.gpu)
+
+    # Display to stdout
+    log("\n" + "=" * 60)
+    log("GPU POWER USAGE SUMMARY")
+    log(f"Total Time:           {result['total_time_s']:.4f} s")
+    log(f"Total Energy:         {result['energy_j']:.4f} J")
+    log(f"Avg Power (Timed):    {result['avg_power_timed']:.4f} W")
+    log(f"Avg Power (Sampled):  {result['avg_power_sampled']:.4f} W")
+    log(f"Min Power (Sampled):  {result['min_draw']:.2f} W")
+    log(f"Max Power (Sampled):  {result['max_draw']:.2f} W")
+    log("=" * 60)
+
+    # Save to CSVs if output requested
+    if args.output:
+        summary_csv = args.output if args.output.endswith(".csv") else args.output + ".csv"
+        samples_csv = summary_csv.replace(".csv", "_samples.csv")
+        save_summary_csv(summary_csv, result)
+        save_samples_csv(samples_csv, result["samples"])
+        log(f"Saved summary to: {summary_csv}")
+        log(f"Saved power samples to: {samples_csv}")
+
+if __name__ == "__main__":
+    main()
+
+
+# python power_time.py  --output power_report.csv --gpu 4 ./tc.out data/data_7035.bin 0 0 1
+# python power_time.py  --output power_report.csv --gpu 4 ./tc.out data/data_7035.bin 0 0 1