Skip to main content

Utility functions for the Rubin Science Platform

Project description

lsst-rsp

This Python package provides utility functions for the Rubin Science Platform, primarily for use within the Notebook Aspect. These utility functions are documented in the Notebook aspect documentation for the Rubin Science Platform.

Installation

The package can be installed from PyPI:

pip install lsst-rsp

However, most functionality of lsst-rsp is only useful inside a Rubin Science Platform JupyterLab container. This package is pre-installed in the standard containers.

Development

The best way to start contributing to lsst-rsp is by cloning this repository, creating a virtual environment, and running the make init command:

git clone https://github.com/lsst-sqre/lsst-rsp.git
cd lsst-rsp
make init

You can run tests with tox:

tox run

To learn more about the individual environments:

tox list

Developing on the RSP

The LSST kernel in the RSP sciplat-lab image already has a release version of lsst-rsp included. If you want to use a development version, you must first create a virtualenv, install the necessary packages, and then create a JupyterLab kernel pointing to it.

In a terminal session, run the following commands:

VENV="lsst_rsp"
mkdir -p ${HOME}/venvs
python -m venv ${HOME}/venvs/${VENV}
. ${HOME}/venvs/${VENV}/bin/activate
mkdir -p ${HOME}/src
cd ${HOME}/src
git clone https://github.com/lsst-sqre/lsst-rsp
# or git clone git@github.com:lsst-sqre/lsst-rsp.git if you prefer
cd lsst-rsp
make init
pip install ipykernel
python -m ipykernel install --user --name=${VENV}

Now you will need to shut down your lab and restart it in order to pick up the new lsst-rsp installation.

Once you're in your new container, you will notice that you have a new kernel named lsst_rsp. Now you have an editable version installed in your custom kernel, and you can run all the usual tox environments.

If you start a notebook with your custom kernel, you can see the development version with:

import lsst.rsp

lsst.rsp.__version__

You will still need to restart the kernel to pick up changes you make to your copy of lsst_rsp.

Uninstalling a development version from the RSP

In a terminal window, run the following:

. $HOME/venvs/lsst_rsp/bin/activate
jupyter kernelspec uninstall lsst_rsp

Respond y and then deactivate to the resulting prompts.

Shut down and restart your notebook as before. When you come back in, in a terminal window, run:

rm -rf $HOME/venvs/lsst_rsp

You cannot remove the virtualenv directory until you have restarted the JupyterLab container, since otherwise JupyterLab will be holding some files open for the running kernel.

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

lsst_rsp-0.9.5.tar.gz (52.4 kB view details)

Uploaded Source

Built Distribution

lsst_rsp-0.9.5-py3-none-any.whl (33.8 kB view details)

Uploaded Python 3

File details

Details for the file lsst_rsp-0.9.5.tar.gz.

File metadata

  • Download URL: lsst_rsp-0.9.5.tar.gz
  • Upload date:
  • Size: 52.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.7.19

File hashes

Hashes for lsst_rsp-0.9.5.tar.gz
Algorithm Hash digest
SHA256 0523400dc9e18a93ae254dfb49574cdf3e42ddae4c5067ef50a221782a4367db
MD5 672b4cfd9eb447054e2c5b35478ab090
BLAKE2b-256 cab93acba8b3ae2588ea94d9b8d401830d045f1e843f0b40fc0d0d9db305cc73

See more details on using hashes here.

File details

Details for the file lsst_rsp-0.9.5-py3-none-any.whl.

File metadata

  • Download URL: lsst_rsp-0.9.5-py3-none-any.whl
  • Upload date:
  • Size: 33.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.7.19

File hashes

Hashes for lsst_rsp-0.9.5-py3-none-any.whl
Algorithm Hash digest
SHA256 8dc963fca12ded7aae86e70ff41082d3a462301b6b02f4547d5ba9f54c6ad18a
MD5 7981cf45ac87c222a1647dddbc01b348
BLAKE2b-256 dfc1fe609a0f68413ba5bec656dd78ff35f6343fa1d4d49c4077347902cbc7b0

See more details on using hashes here.

Supported by

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