Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

Synchronized Energy Harvesting Emulator and Recorder CLI

Project description


shepherd-herd ist the command line utility for controlling a group of shepherd nodes remotely through an IP-based network.


shepherd-herd is a pure python package and available on PyPI. Use your python package manager to install it. For example, using pip:

pip install shepherd-herd


All shepherd-herd commands require the list of hosts on which to perform the requested action. This list of hosts is provided with the -i option, that takes either the path to a file or a comma-separated list of hosts (compare Ansible -i).

For example, save the following file as hosts.

    ansible_user: jane

Then use shepherd-herd to check if all your nodes are up:

shepherd-herd -i hosts run echo 'hello'

Or, equivalently define the list of hosts on the command line

shepherd-herd -i sheep0,sheep1,sheep2, run echo 'hello'

Here, we just provide a selected set of examples of how to use shepherd-herd. For a full list of supported commands and options, run shepherd-herd --help and shepherd-herd [COMMAND] --help.

Simultaneously start a 30s recording on the nodes defined in the hosts file:

shepherd-herd -i hosts record -o rec.h5

After recording is done, retrieve the data from all nodes and merge it to one hdf5 file on your local machine for analysis:

shepherd-herd -i hosts retrieve --merge -o rec_merged.h5 rec.h5

Flash a firmware image to the sensor nodes attached to the shepherd nodes:

shepherd-herd -i hosts target flash firmware_img.bin

Reset the sensor nodes:

shepherd-herd -i hosts target reset

Simultaneously start to play back the previously recorded data to the attached sensor nodes and monitor their power consumption and GPIO events:

shepherd-herd -i hosts emulate -i rec.h5 -o load.h5

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for shepherd-herd, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size shepherd_herd-0.2.2.tar.gz (6.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page