Skip to content

amv213/pycotech

Repository files navigation

📑 Welcome to Pycotech!

pycotech offers tools and wrappers to interface with PT-104 PicoLog® Data Loggers and files, allowing you to easily build an end-to-end data processing pipeline in pure python.

This work would not have been possible without Martin Schröder's amazing wrapper around the usbpt104 C library for the Pico PT-104A RTD Data Acquisition Module. Don't hesitate to head over to his PT_104 Github repo to check out the original project and to drop a star! 🌟

🔥 Features

pycotech's suite of utility functions provides seamless integration of .PLW and .TXT files generated by traditional PicoTechnology® software - allowing you to handle, visualise, and convert between data-formats at will.

Pycotech also provides python command line alternatives to most of the principal PicoLog® software components. Namely, pycotech's plw-recorder allows you to bypass the PLW Recorder® data acquisition software and gather data directly from a number of PT-104 Data Loggers. Pycotech's plw-player substitutes instead the PicoLog® Player software, allowing you to read, convert, and extract data from existing .PLW files.


🚀 Quick Start

  1. 📚 Install pycotech like any other python package, using pip to download it from PyPI:

    python -m pip install pycotech
  2. 🐍 Now test your installation running the following minimal script:

    import pycotech
    
    df = pycotech.utils.read_plw("my_plw_file.PLW")
    
    print(df)
  3. 🎉 If everything went well you should now be properly set-up to use pycotech! Enjoy!

📟 CLI Tools

To use pycotech's command line tools, install pycotech as described above and then run any of the following:

  1. plw-player: converts .PLW files to .TXT

    plw-player -plw "my_plw_file.PLW"
    usage: plw-player [-h] -plw PLW [-txt TXT]
    
    optional arguments:
     -h, --help  show this help message and exit
     -plw PLW    input .PLW file
     -txt TXT    output .TXT file
  2. plw-recorder: continuous data acquisition from connected PT-104 Loggers:

    plw-recorder
    usage: plw-recorder [-h] [-dir DIR] [-r R]
    
    optional arguments:
    -h, --help  show this help message and exit
    -dir DIR    output logs directory
    -r R        logging rate (hours)

📚 Documentation

To learn more about the package head over to the official documentation !

About

Tools and wrappers to interface with PT-104 PicoLog® Data Loggers and files.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages