qc-selector

The Selector library provides methods for selecting a diverse subset of a (molecular) dataset.

Citation

Please use the following citation in any publication using the selector library:

@article{selector_library,
author = {Meng, Fanwang and Martínez González, Marco and Chuiko, Valerii and Tehrani, Alireza and Al Nabulsi, Abdul Rahman and Broscius, Abigail and Khaleel, Hasan and López-P{\'e}rez, Kenneth and Miranda-Quintana, Ramón Alain and Ayers, Paul W. and Heidar-Zadeh, Farnaz},
title = {Selector: A General Python Library for Diverse Subset Selection},
journal = {Journal of Chemical Information and Modeling},
volume = {0},
number = {0},
pages = {null},
year = {0},
doi = {10.1021/acs.jcim.5c01499},
note ={PMID: 41591801},
URL = {https://doi.org/10.1021/acs.jcim.5c01499}
}

Web Server

We have a web server for the selector library at https://huggingface.co/spaces/QCDevs/Selector. For small and prototype datasets, you can use the web server to select a diverse subset of your dataset and compute the diversity metrics, where you can download the selected subset and the computed diversity metrics.

Installation

It is recommended to install selector within a virtual environment. To create a virtual environment, we can use the venv module (Python 3.9+, https://docs.python.org/3/tutorial/venv.html), miniconda (https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html), or pipenv (https://pipenv.pypa.io/en/latest/).

Installing from PyPI

To install selector with pip, we can install the latest stable release from the Python Package Index (PyPI) as follows:

# install the stable release
pip install qc-selector

Installing from The Prebuild Wheel Files

To download the prebuilt wheel files, visit the PyPI page and GitHub releases.

# download the wheel file first to your local machine
# then install the wheel file
pip install file_path/qc_selector-0.1.0-py3-none-any.whl

Installing from the Source Code

In addition, we can install the latest development version from the GitHub repository as follows:

# install the latest development version
pip install git+https://github.com/theochem/Selector.git

We can also clone the repository to access the latest development version, test it and install it as follows:

# clone the repository
git clone git@github.com:theochem/Selector.git

# change into the working directory
cd Selector
# run the tests
python -m pytest .

# install the package
pip install .

See https://selector.qcdevs.org for full details.

Download files

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

Source Distribution

qc_selector-0.1.4.tar.gz (121.4 kB view details)

Uploaded Feb 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

qc_selector-0.1.4-py3-none-any.whl (105.5 kB view details)

Uploaded Feb 3, 2026 Python 3

File details

Details for the file qc_selector-0.1.4.tar.gz.

File metadata

Download URL: qc_selector-0.1.4.tar.gz
Upload date: Feb 3, 2026
Size: 121.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for qc_selector-0.1.4.tar.gz
Algorithm	Hash digest
SHA256	`2e9e875a729e586a5f8137995837ca7a80a79b214cfcd55493cdd00c5546e34b`
MD5	`36c76cb15e59577abf0f818ada8b4775`
BLAKE2b-256	`f935484c3cde04cad5e98a89bbcbbb11cac9ad04cf7f54034260a588b0bb40d2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qc_selector-0.1.4.tar.gz:

Publisher: pypi_release.yaml on theochem/Selector

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qc_selector-0.1.4.tar.gz
- Subject digest: 2e9e875a729e586a5f8137995837ca7a80a79b214cfcd55493cdd00c5546e34b
- Sigstore transparency entry: 907373929
- Sigstore integration time: Feb 3, 2026
Source repository:
- Permalink: theochem/Selector@a536369a1aedf0503dbc03256567bf1c803e1b13
- Branch / Tag: refs/tags/v0.1.4
- Owner: https://github.com/theochem
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi_release.yaml@a536369a1aedf0503dbc03256567bf1c803e1b13
- Trigger Event: push