Skip to main content

Toolbox for inferring psychological embeddings.

Project description

PsiZ logo

Python codecov

WARNING: This package is pre-release and the API is not stable. All APIs are subject to change and all releases are alpha.

What's in a name?

The name PsiZ (pronounced like the word size, /sʌɪz/) is meant to serve as shorthand for the term psychological embedding. The greek letter Psi is often used to represent the field of psychology and the matrix variable Z is often used in machine learning to denote a latent feature space.


PsiZ provides the computational tools to infer psychological representations from human behavior (i.e., a psychological embedding). It integrates cognitive theory with contemporary computational methods.


There are two different ways to install: PyPI or git. Installing via git has the advantage of including examples and tests in the cloned repository.

Using PyPI

$ pip install psiz

You can optionally install pytest necessary for running package tests:

$ pip install psiz[test]

Using git

# Clone the PsiZ repository from GitHub to your local machine.
$ git clone
# Use `pip` to install the cloned repository.
$ pip install /local/path/to/psiz


  • PsiZ depends on TensorFlow. Please see the TF compatibility matrix for supported Python and CUDA versions for each version of TensorFlow.
  • PsiZ versions 0.5.0 and older must be installed using git clone and editable mode (pip install -e /local/path/to/psiz).
  • You can install specific releases:
    • using PyPI: pip install 'psiz==0.5.1'
    • using git: git clone --branch v0.5.1



If you use PsiZ in your work please cite one of the following:

    title     = {Enriching ImageNet with Human Similarity Judgments and Psychological Embeddings},
    author    = {Brett D. Roads and Bradley C. Love},
    booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
    year      = {2021},
    month     = {6},
    pages     = {3547--3557}
    title   = {Obtaining psychological embeddings through joint kernel and metric learning},
    author  = {Brett D. Roads and Michael C. Mozer},
    journal = {Behavior Research Methods},
    year    = {2019},
    volume  = {51},
    pages   = {2180–-2193},
    doi     = {10.3758/s13428-019-01285-3}

Contribution Guidelines

If you would like to contribute please see the contributing guidelines.

This project uses a Code of Conduct adapted from the Contributor Covenant version 2.0, available at


This project is licensed under the Apache Licence 2.0 - see LICENSE 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.

Files for psiz, version 0.5.1
Filename, size File type Python version Upload date Hashes
Filename, size psiz-0.5.1.tar.gz (179.1 kB) File type Source Python version None Upload date Hashes View
Filename, size psiz-0.5.1-py3-none-any.whl (211.5 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page