Metadata-Version: 2.1
Name: stressberry
Version: 0.1.7
Summary: Stress tests for the Raspberry Pi
Home-page: https://github.com/nschloe/stressberry
Author: Nico Schlömer
Author-email: nico.schloemer@gmail.com
License: License :: OSI Approved :: MIT License
Description: # stressberry
        
        Stress tests and temperature plots for the Raspberry Pi.
        
        [![CircleCI](https://img.shields.io/circleci/project/github/nschloe/stressberry/master.svg)](https://circleci.com/gh/nschloe/stressberry/tree/master)
        [![codecov](https://img.shields.io/codecov/c/github/nschloe/stressberry.svg)](https://codecov.io/gh/nschloe/stressberry)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
        [![awesome](https://img.shields.io/badge/awesome-yes-brightgreen.svg)](https://github.com/nschloe/stressberry)
        [![PyPi Version](https://img.shields.io/pypi/v/stressberry.svg)](https://pypi.org/project/stressberry)
        [![GitHub stars](https://img.shields.io/github/stars/nschloe/stressberry.svg?logo=github&label=Stars)](https://github.com/nschloe/stressberry)
        
        <img src="https://nschloe.github.io/stressberry/all.svg" width="70%">
        
        There are a million ways to cool down your Raspberry Pi: Small heat sinks,
        specific cases, and some [extreme DIY solutions](https://youtu.be/WfQMLInuwws).
        stressberry is a package for testing the core temperature under different
        loads, and it produces nice plots which can easily be compared.
        
        To run stressberry on your computer, simply install it with
        ```
        [sudo] apt install stress
        [sudo -H] pip3 install -U stressberry
        ```
        and run it with
        ```
        stressberry-run out.dat
        stressberry-plot out.dat -o out.png
        ```
        (Use `MPLBACKEND=Agg stressberry-plot out.dat -o out.png` if you're running the script
        on the Raspberry Pi itself.)
        
        The run lets the CPU idle for a bit, then stresses it with maximum load for 5
        minutes, and lets it cool down afterwards. The entire process takes 10 minutes.
        The resulting data is displayed to a screen or, if specified, written to a PNG
        file.
        
        If you'd like to submit your own data for display here, feel free to
        [open an issue](https://github.com/nschloe/stressberry/issues) and include the
        data file, a photograph of your setup, and perhaps some further information.
        
        ### The setups
        
        #### A naked Raspberry Pi 3
        
        <img src="https://nschloe.github.io/stressberry/naked-photo.jpg" width="30%">
        
        The Raspberry Pi 3 without fans, heat sinks, or particular cases. The idle core
        temperature is about 47°C, under heavy load it reaches 80°C (at which point the
        CPU frequency is throttled).
        
        #### A simple acrylic case
        
        <img src="https://nschloe.github.io/stressberry/acryl-photo.jpg" width="30%">
        
        Your average acrylic case from eBay. Temperature measurements are bit warmer
        than with the naked Raspberry Pi, presumable because the case hinders the free
        air flow.
        
        #### A black full-body aluminum alloy case
        
        <img src="https://nschloe.github.io/stressberry/fasttech-photo.jpg" width="30%">
        
        I got [this case](https://www.fasttech.com/p/5299000) from FastTech for about
        $17. It's basically a full-body aluminum alloy case with heat pads for the CPU
        and the RAM chip. The heat is dissipated _very_ well and in fact beats
        every other solution I've seen so far,
        including [the extreme DIY passive cooling setup](https://youtu.be/WfQMLInuwws).
        
        
        ### Testing
        
        To run the tests, just check out this repository and type
        ```
        pytest
        ```
        
        ### Distribution
        
        To create a new release
        
        1. bump the `__version__` number,
        
        2. publish to PyPi and GitHub:
            ```
            $ make publish
            ```
        
        ### License
        stressberry is published under the [MIT license](https://en.wikipedia.org/wiki/MIT_License).
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Description-Content-Type: text/markdown
