npc_lims

neuropixels cloud lab information management system Tools to fetch and update paths, metadata and state for Mindscope Neuropixels sessions, in the cloud.

quickstart

make a new Python >=3.9 virtual environment with conda or venv (lighter option, since this package does not require pandas, numpy etc.):
```
python -m venv .venv
```

activate the virtual environment:

Windows

.venv\scripts\activate

Unix

source .venv/bin/activate.sh

install the package:
```
python -m pip install npc_lims
```
setup credentials
- required environment variables:
  - AWS S3
    - AWS_DEFAULT_REGION
    - AWS_ACCESS_KEY_ID
    - AWS_SECRET_ACCESS_KEY
    - to find and read files on S3
    - must have read access on relevant aind buckets
    - can be in a standard ~/.aws location, as used by AWS CLI or boto3
  - CodeOcean API
    - CODE_OCEAN_API_TOKEN
    - CODE_OCEAN_DOMAIN
    - to find processed data in "data assets" via the Codeocean API
    - generated in CodeOcean:
      - right click on Account (bottom left, person icon)
      - click User Secrets - these are secrets than can be made available as environment variables in CodeOcean capsules
      - go to Access Tokens and click Generate new token - this is for programatically querying CodeOcean's databases
        
        in Token Name enter Codeocean API (read) and check read on capsules and datasets
        
        a token will be generated: click copy (storing it in a password manager, if you use one)
      - head back to User Secrets where we'll paste it into a new secret via Add secret > API credentials - in description enter Codeocean API (read) - in API key enter CODE_OCEAN_API_KEY - in API secret paste the copied secret from before (should start with cop_...) CODE_OCEAN_DOMAIN is the codeocean https address, up to and including .org
- environment variables can also be specified in a file named .env in the current working directory
  - example: https://www.dotenv.org/docs/security/env.html
  - be very careful that this file does not get pushed to public locations, e.g. github
    - if using git, add it to a .gitignore file in your project's root directory:
```
.env*
```

now in Python we can find sessions that are available to work with:

    >>> import npc_lims;

# get a sequence of `SessionInfo` dataclass instances, one per session:
    >>> tracked_sessions: tuple[npc_lims.SessionInfo, ...] = npc_lims.get_session_info()

# each `SessionInfo` instance has minimal metadata about its session:
    >>> tracked_sessions[0]                 # doctest: +SKIP
    npc_lims.SessionInfo(id='626791_2022-08-15', subject=626791, date='2022-08-15', idx=0, project='DRPilotSession', is_ephys=True, is_sync=True, allen_path=PosixUPath('//allen/programs/mindscope/workgroups/dynamicrouting/PilotEphys/Task 2 pilot/DRpilot_626791_20220815'))
        >>> tracked_sessions[0].is_ephys        # doctest: +SKIP
    False

# currently, we're only tracking behavior and ephys sessions that use variants of https://github.com/samgale/DynamicRoutingTask/blob/main/TaskControl.py:
    >>> all(s.date.year >= 2022 for s in tracked_sessions)
    True

"tracked sessions" are discovered via 3 routes:
- https://github.com/AllenInstitute/npc_lims/blob/main/tracked_sessions.yaml
- \\allen\programs\mindscope\workgroups\dynamicrouting\DynamicRoutingTask\DynamicRoutingTraining.xlsx
- \\allen\programs\mindscope\workgroups\dynamicrouting\DynamicRoutingTask\DynamicRoutingTrainingNSB.xlsx

Metadata

Release files for npc_lims 0.1.199

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for npc_lims 0.1.199
File	Size	Uploaded
npc_lims-0.1.199.tar.gz	50.1 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for npc_lims 0.1.199
File	Interpreter	ABI	Platform	Reset
npc_lims-0.1.199-py3-none-any.whl 54.8 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 104.9 kB

Release files / npc_lims-0.1.199.tar.gz

Download URL	npc_lims-0.1.199.tar.gz
Size	50.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`7b2d8253d1df552a6b44a9aa2a36ceecdf01de032e8e78c6d6045651c7bec482`
BLAKE2b-256 checksum How to use checksums	`e75fb98acc5beecc553b143cf17d1155a3633475e50161bb2e2304dc2b43c43f`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / npc_lims-0.1.199-py3-none-any.whl

Download URL	npc_lims-0.1.199-py3-none-any.whl
Size	54.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9c69b5d5e9ea427ba5b7349165e65ae030d56a804c44bdfdd35e36d7dfbf1e35`
BLAKE2b-256 checksum How to use checksums	`0689cd561e1514f026b847c0aefd49e2d37f09a8e9b4e04198e53bf035fed0ab`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`