crunch-cube

Build Status Coverage Status Documentation Status

Open Source Python implementation of the API for working with CrunchCubes

Introduction

This package contains the implementation of the CrunchCube API. It is used to extract useful information from CrunchCube responses (we'll refer to them as cubes in the subsequent text). Cubes are obtained from the Crunch.io platform, as JSON responses to the specific queries created by the user. These queries specify which data the user wants to extract from the Crunch.io system. The most common usage is to obtain the following:

Cross correlation between different variable
Margins of the cross tab cube
Proportions of the cross tab cube (e.g. proportions of each single element to the entire sample size)
Percentages

When the data is obtained from the Crunch.io platform, it needs to be interpreted to the form that's convenient for a user. The actual shape of the cube JSON contains many internal details, which are not of essence to the end-user (but are still necessary for proper cube functionality).

The job of this library is to provide a convenient API that handles those intricacies, and enables the user to quickly and easily obtain (extract) the relevant data from the cube. Such data is best represented in a table-like format. For this reason, the most of the API functions return some form of the ndarray type, from the numpy package. Each function is explained in greater detail, uner its own section, under the API subsection of this document.

Installation

The cr-cube package can be installed by using the pip install:

pip install cr-cube

For developers

For development mode, cr.cube needs to be installed from the local checkout of the crunch-cube repository. It is strongly advised to use virtualenv. Assuming you've created and activated a virtual environment venv, navigate to the top-level folder of the repo, on the local file system, and run:

pip install -e .

python setup.py develop

Running tests

To setup and run tests, you will need to install cr.cube as well as testing dependencies. To do this, from the root directory, simply run:

pip install -e .[testing]

And then tests can be run using py.test in the root directory:

pytest

Usage

After the cr.cube package has been successfully installed, the usage is as simple as:

>>> from cr.cube.cube import Cube

>>> ### Obtain the crunch cube JSON payload using app.crunch.io, pycrunch, rcrunch or scrunch
>>> ### And store it in the 'cube_JSON_response' variable

>>> cube = Cube(cube_JSON_response)
>>> print(cube)
Cube(name='MyCube', dimension_types='CAT x CAT')
>>> cube.counts
np.array([[1169, 547],
          [1473, 1261]])

Complete API Doc

Please visit https://crunch-cube.readthedocs.io/en/latest for the API reference.

Changes

3.3.9

Build released version with Python 3.11

3.3.8

Use native namespace packages for cr instead of deprecated pkg_resources / pkgutil

3.3.7

Rebuild

3.3.6

Rebuild

3.3.5

Fix bug in _Strand.table_base and _Strand.table_missing for MRs.

3.3.4

Fix bug in _Slice.rows_disaggregated_missing_unweighted_counts for Numeric Array grouped by categorical
Fix bug in _Strand.table_base_scalar and _Strand.table_base_range when a variable is entirely missing.

3.3.3

Add information about missing values to partitions:
- _Nub: .table_missing
- _Strand: .table_missing, .disaggregated_missing_unweighted_counts, .disaggregated_missing_labels, & .disaggregated_missing_element_ids
- _Slice: .rows_disaggregated_missing_unweighted_counts, .rows_disaggregated_missing_labels, .rows_disaggregated_missing_element_ids .columns_disaggregated_missing_unweighted_counts, .columns_disaggregated_missing_labels, & .columns_disaggregated_missing_element_ids

3.3.2

Bug fix column numeric ranges for _Slice

3.3.1

Add numeric ranges

3.2.1

Fix translate_element_id when is is None

For a complete list of changes see history.

Release files for cr-cube 3.3.9

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

Source distribution (sdist)

Source distribution for cr-cube 3.3.9
File	Size	Uploaded
cr_cube-3.3.9.tar.gz	1.0 MB	May 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cr-cube 3.3.9
File	Interpreter	ABI	Platform	Reset
cr_cube-3.3.9-py3-none-any.whl 120.1 kB May 25, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / cr_cube-3.3.9.tar.gz

Download URL	cr_cube-3.3.9.tar.gz
Size	1.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`3178ded74f0039641f7d1ce17c465e9fc43851ecff568a095b5aac0e0e65cf3f`
BLAKE2b-256 checksum How to use checksums	`15b77efa9609078b3da4e47f3c8541d30caa444203c75098883daf1bbd55c944`
Upload date	May 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.15`

Release files / cr_cube-3.3.9-py3-none-any.whl

Download URL	cr_cube-3.3.9-py3-none-any.whl
Size	120.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b0be22832a145ae38ead83a97c499760e6c0c24653189307ba4cbd950a0ada8a`
BLAKE2b-256 checksum How to use checksums	`085b8e1724d148e203b760a8d71104bd70edca1e9277ed9efaf11f3e6221398b`
Upload date	May 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.15`