Skip to content

A Python library that stores assets shared between multiple Sun (NeuroAI) lab data acquisition and processing repositories.

License

Notifications You must be signed in to change notification settings

Sun-Lab-NBB/sl-shared-assets

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sl-shared-assets

A python library that provides data acquisition and processing assets shared between Sun (NeuroAI) lab libraries.

PyPI - Version PyPI - Python Version uv Ruff type-checked: mypy PyPI - License PyPI - Status PyPI - Wheel


Detailed Description

Primarily, this library is designed to make the two main Sun lab libraries used for data acquisition (sl-experiment) and processing (sl-forgery) independent of each other.

The library broadly stores two types of assets. First, it stores dataclasses used to save the data acquired in the lab and configure data acquisition and processing runtimes. Second, it provides the low-level tools and methods used to manage the data at all stages of Sun lab data workflow: acquisition, processing, and analysis.


Table of Contents


Dependencies

All software library dependencies are installed automatically as part of the library installation.


Installation

Source

Note, installation from source is highly discouraged for everyone who is not an active project developer.

  1. Download this repository to your local machine using any method, such as Git-cloning. Use one of the stable releases from GitHub.
  2. Unpack the downloaded zip and note the path to the binary wheel (.whl) file contained in the archive.
  3. Run python -m pip install WHEEL_PATH, replacing 'WHEEL_PATH' with the path to the wheel file, to install the wheel into the active python environment.

pip

Use the following command to install the library using pip: pip install sl-shared-assets.


Usage

Most library components are intended to be used via other Sun lab libraries. For details on using shared assets for data acquisition and preprocessing, see the sl-experiment library. For details on using shared assets for data processing and dataset formation, see the sl-forgery library.

Warning! End users should not use any component of this library directly or install this library into any Python environment. All assets from this library are intended to be used exclusively by developers working on other Sun lab libraries.

API Documentation

Developers working on integrating sl-shared-assets into other libraries should see the API documentation for the detailed description of the methods and classes exposed by components of this library.

Note! The API documentation includes important information about Command-Line Interfaces (CLIs) exposed by this library as part of installation into a Python environment.


Versioning

This project uses semantic versioning. For the versions available, see the tags on this repository.


Authors


License

This project is licensed under the GPL3 License: see the LICENSE file for details.


Acknowledgments

  • All Sun lab members for providing the inspiration and comments during the development of this library.
  • The creators of all other projects used in the development automation pipelines and source code of this project see pyproject.toml.

About

A Python library that stores assets shared between multiple Sun (NeuroAI) lab data acquisition and processing repositories.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages