Skip to main content

Simons Observatory Control System

Project description

PyPI Package PyPI - Python Version docker PyPI - License
GitHub Workflow Status pre-commit.ci status coverage Documentation Status

Overview

This repository, SOCS, contains hardware control code for the Simons Observatory. This code operates within the framework provided by OCS.

Installation

Install and update with pip:

$ pip3 install -U socs

You may install optional dependencies by including one or more agent group names on installation, for example:

$ pip3 install -U socs[labjack,synacc]

For a complete list of agent groups see the Installation Documentation.

If you would like to install all optional dependencies use the special varient “all”:

$ pip3 install -U socs[all]

Note: Not all optional dependencies can be installed this way. See the Installation Documentation for more info on specific agent dependencies.

Installing from Source

If you are considering contributing to SOCS, or would like to use an unreleased feature, you will want to install from source. To do so, clone this repository and install using pip:

git clone https://github.com/simonsobs/socs.git
cd socs/
pip3 install -r requirements.txt
pip3 install .

In order for OCS tools to find these agents, you must add the full path to the agents directory, e.g. /home/simons/code/socs/agents/, to your OCS site config file. Do so by adding the following under your configured host if it does not already exist:

# List of additional paths to Agent plugin modules.
'agent-paths': [
  '/path/to/socs/agents/',
],

See the ocs docs for more details.

Docker Images

Docker images for SOCS and each Agent are available on Docker Hub. Official releases will be tagged with their release version, i.e. v0.1.0. These are only built on release, and the latest tag will point to the latest of these released tags. These should be considered stable.

Test images will be tagged with the latest released version tag, the number of commits ahead of that release, the latest commit hash, i.e. v0.0.2-81-g9c10ba6-dev. These get built on each commit to the main branch, and are useful for testing and development, but should be considered unstable.

Documentation

The SOCS documentation can be built using Sphinx. There is a separate requirements.txt file in the docs/ directory to install Sphinx and any additional documentation dependencies:

cd docs/
pip3 install -r requirements.txt
make html

You can then open docs/_build/html/index.html in your preferred web browser. You can also find a copy hosted on Read the Docs.

Tests

The tests for SOCS are run using pytest, and should be run from the tests/ directory:

$ cd tests/
$ python3 -m pytest --cov

For more details see tests/README.rst.

Contributing

For guidelines on how to contribute to OCS see CONTRIBUTING.rst.

License

This project is licensed under the BSD 2-Clause License - see the LICENSE.txt file for details.

Project details


Download files

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

Source Distribution

socs-0.5.2.tar.gz (375.1 kB view details)

Uploaded Source

Built Distribution

socs-0.5.2-py3-none-any.whl (448.0 kB view details)

Uploaded Python 3

File details

Details for the file socs-0.5.2.tar.gz.

File metadata

  • Download URL: socs-0.5.2.tar.gz
  • Upload date:
  • Size: 375.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.18

File hashes

Hashes for socs-0.5.2.tar.gz
Algorithm Hash digest
SHA256 87e2b2f528371308d36b0f5fe712ed4618984c962233426709c9f05de6e6d428
MD5 0fe3f473c03529e9f424b8d14539018b
BLAKE2b-256 4720b491e7f7a6e345ba5fbff14933f17c01bef91470749da5e48355c2c12c28

See more details on using hashes here.

File details

Details for the file socs-0.5.2-py3-none-any.whl.

File metadata

  • Download URL: socs-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 448.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.18

File hashes

Hashes for socs-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 eaa9002f57207fe9852fe20c256ef0a685fcdb266dd88fc600b78fde868927b8
MD5 a9120e4e6ab10b8ad14cd3cf5da4f000
BLAKE2b-256 eb2d8261db1ab90877e395ec9ee85fcb1032e50f625e85235df8cb29016889d9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page