A Python library that provides data acquisition and processing assets shared between Sun (NeuroAI) lab libraries.
This library makes 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.
All library dependencies are installed automatically by all supported installation methods (see the Installation section).
Note, installation from source is highly discouraged for anyone who is not an active project developer.
- Download this repository to the local machine using the preferred method, such as git-cloning. Use one of the stable releases that include precompiled binary and source code distribution (sdist) wheels.
- If the downloaded distribution is stored as a compressed archive, unpack it using the appropriate decompression tool.
cdto the root directory of the prepared project distribution.- Run
python -m pip install .to install the project. Alternatively, if using a distribution with precompiled binaries, usepython -m pip install WHEEL_PATH, replacing 'WHEEL_PATH' with the path to the wheel file.
Use the following command to install the library using pip: pip install sl-shared-assets.
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.
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 the 'configuration' Command-Line Interface (CLI) exposed by this library.
This project uses semantic versioning. See the tags on this repository for the available project releases.
- Ivan Kondratyev (Inkaros)
- Kushaan Gupta (kushaangupta)
- Natalie Yeung
This project is licensed under the GPL3 License: see the LICENSE file for details.
- All Sun lab members for providing the inspiration and comments during the development of this library.
- The creators of all other dependencies and projects listed in the pyproject.toml file.