Crunch.io Cube library
Project description
# crunch-cube
Open Source Python implementation of the API for working with Crunch Cubes
## Introduction
This package contains the implementation of the Crunch Cube API. It is used to
extract useful information from Crunch Cube 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 Crunch Cube package can be installed by using the `pip install`:
pip install cr.cube
### For developers
For development mode, Crunch Cube needs to be installed from the local checkout
of the `crunch-cube` repository. Navigate to the top-level folder of the repo,
on the local file system, and run:
python setup.py develop
## Usage
After the `cr.cube` package has been successfully installed, the usage is as
simple as:
from cr.cube.crunch_cube import CrunchCube
### Obtain the crunch cube JSON from the Crunch.io
### And store it in the 'cube_JSON_response' variable
cube = CrunchCube(cube_JSON_response)
cube.as_array()
### Outputs:
#
# np.array([
# [5, 2],
# [5, 3]
# ])
## API
### `as_array`
Tabular, or matrix, representation of the _cube_. The detailed description can
be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
### `margin`
Calculates margins of the _cube_. The detailed description can be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
### `proportions`
Calculates proportions of single variable elements to the whole sample size.
The detailed description can be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
### `percentages`
Calculates percentages of single variable elements to the whole sample size.
The detailed description can be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
[](https://travis-ci.org/Crunch-io/crunch-cube)
[](https://coveralls.io/github/Crunch-io/crunch-cube?branch=master)
[](http://crunch-cube.readthedocs.io/en/latest/?badge=latest)
## Changes
### 1.0 Initial release
### 1.1 Fix stray ipdb.
### 1.2 Support exporter
### 1.3 Implement Headers & Subtotals
### 1.4 Update based on tabbook tests from `cr.lib`
#### 1.4.1 Update based on deck tests from `cr.server`
#### 1.4.2 Fix bugs discovered by first `cr.exporter` deploy to alpha
#### 1.4.3 Fix bug (exporting 2D crtab with H&S on row only)
#### 1.4.4 Implement obtaining labels with category ids (useful for H&S in exporter)
#### 1.4.5 Fix MR x MR proportions calculation
### 1.5.0 Start implementing index table functionality
#### 1.5.1 Implement index for MR x MR
#### 1.5.2 Fix bugs with `anchor: 0` for H&S
#### 1.5.3 Fix bugs with invalid input data for H&S
### 1.6.0 Z-Score and bug fixes.
#### 1.6.1 `standardized_residuals` are now included.
#### 1.6.2 support "Before" and "After" in variable transformations since they exist in zz9 data.
#### 1.6.4 Fixes for 3d Pruning.
#### 1.6.5 Fixes for Pruning and Headers and subtotals.
- Population size support.
- Fx various calculations in 3d cubes.
#### 1.6.6 Added support for CubeSlice, which always represents a
- 2D cube (even if they're the slices of a 3D cube).
- Various fixes for support of wide-export
#### 1.6.7 Population fraction
- Various bugfixes and optimizations.
- Add property `population_fraction`. This is needed for the exporter to be able to calculate the correct population counts, based on weighted/unweighted and filtered/unfiltered states of the cube.
- Apply newly added `population_fraction` to the calculation of `population_counts`.
- Modify API for `scale_means`. It now accepts additional parameters `hs_dims` (defaults to `None`) and `prune` (defaults to `False`). Also, the format of the return value is slightly different in nature. It is a list of lists of numpy arrrays. It functions like this:
- The outermost list corresponds to cube slices. If cube.ndim < 3, then it's a single-element list
- Inner lists have either 1 or 2 elements (if they're a 1D cube slice, or a 2D cube slice, respectively).
- If there are scale means defined on the corresponding dimension of the cube slice, then the inner list element is a numpy array with scale means. If it doesn't have scale means defined (numeric values), then the element is `None`.
- Add property `ca_dim_ind` to `CubeSlice`.
- Add property `is_double_mr` to `CubeSlice` (which is needed since it differs from the interpretation of the cube. E.g. MR x CA x MR will render slices which are *not* double MRs).
- Add `shape`, `ndim`, and `scale_means` to `CubeSlice`, for accessibility.
- `index` now also operates on slices (no api change).
Open Source Python implementation of the API for working with Crunch Cubes
## Introduction
This package contains the implementation of the Crunch Cube API. It is used to
extract useful information from Crunch Cube 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 Crunch Cube package can be installed by using the `pip install`:
pip install cr.cube
### For developers
For development mode, Crunch Cube needs to be installed from the local checkout
of the `crunch-cube` repository. Navigate to the top-level folder of the repo,
on the local file system, and run:
python setup.py develop
## Usage
After the `cr.cube` package has been successfully installed, the usage is as
simple as:
from cr.cube.crunch_cube import CrunchCube
### Obtain the crunch cube JSON from the Crunch.io
### And store it in the 'cube_JSON_response' variable
cube = CrunchCube(cube_JSON_response)
cube.as_array()
### Outputs:
#
# np.array([
# [5, 2],
# [5, 3]
# ])
## API
### `as_array`
Tabular, or matrix, representation of the _cube_. The detailed description can
be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
### `margin`
Calculates margins of the _cube_. The detailed description can be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
### `proportions`
Calculates proportions of single variable elements to the whole sample size.
The detailed description can be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
### `percentages`
Calculates percentages of single variable elements to the whole sample size.
The detailed description can be found
[here](http://crunch-cube.readthedocs.io/en/latest/cr.cube.html#cr-cube-crunch-cube-module).
[](https://travis-ci.org/Crunch-io/crunch-cube)
[](https://coveralls.io/github/Crunch-io/crunch-cube?branch=master)
[](http://crunch-cube.readthedocs.io/en/latest/?badge=latest)
## Changes
### 1.0 Initial release
### 1.1 Fix stray ipdb.
### 1.2 Support exporter
### 1.3 Implement Headers & Subtotals
### 1.4 Update based on tabbook tests from `cr.lib`
#### 1.4.1 Update based on deck tests from `cr.server`
#### 1.4.2 Fix bugs discovered by first `cr.exporter` deploy to alpha
#### 1.4.3 Fix bug (exporting 2D crtab with H&S on row only)
#### 1.4.4 Implement obtaining labels with category ids (useful for H&S in exporter)
#### 1.4.5 Fix MR x MR proportions calculation
### 1.5.0 Start implementing index table functionality
#### 1.5.1 Implement index for MR x MR
#### 1.5.2 Fix bugs with `anchor: 0` for H&S
#### 1.5.3 Fix bugs with invalid input data for H&S
### 1.6.0 Z-Score and bug fixes.
#### 1.6.1 `standardized_residuals` are now included.
#### 1.6.2 support "Before" and "After" in variable transformations since they exist in zz9 data.
#### 1.6.4 Fixes for 3d Pruning.
#### 1.6.5 Fixes for Pruning and Headers and subtotals.
- Population size support.
- Fx various calculations in 3d cubes.
#### 1.6.6 Added support for CubeSlice, which always represents a
- 2D cube (even if they're the slices of a 3D cube).
- Various fixes for support of wide-export
#### 1.6.7 Population fraction
- Various bugfixes and optimizations.
- Add property `population_fraction`. This is needed for the exporter to be able to calculate the correct population counts, based on weighted/unweighted and filtered/unfiltered states of the cube.
- Apply newly added `population_fraction` to the calculation of `population_counts`.
- Modify API for `scale_means`. It now accepts additional parameters `hs_dims` (defaults to `None`) and `prune` (defaults to `False`). Also, the format of the return value is slightly different in nature. It is a list of lists of numpy arrrays. It functions like this:
- The outermost list corresponds to cube slices. If cube.ndim < 3, then it's a single-element list
- Inner lists have either 1 or 2 elements (if they're a 1D cube slice, or a 2D cube slice, respectively).
- If there are scale means defined on the corresponding dimension of the cube slice, then the inner list element is a numpy array with scale means. If it doesn't have scale means defined (numeric values), then the element is `None`.
- Add property `ca_dim_ind` to `CubeSlice`.
- Add property `is_double_mr` to `CubeSlice` (which is needed since it differs from the interpretation of the cube. E.g. MR x CA x MR will render slices which are *not* double MRs).
- Add `shape`, `ndim`, and `scale_means` to `CubeSlice`, for accessibility.
- `index` now also operates on slices (no api change).
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cr.cube-1.6.7.tar.gz
(768.6 kB
view details)
Built Distribution
cr.cube-1.6.7-py2-none-any.whl
(32.9 kB
view details)
File details
Details for the file cr.cube-1.6.7.tar.gz.
File metadata
- Download URL: cr.cube-1.6.7.tar.gz
- Upload date:
- Size: 768.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/2.7.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2ab4255b565ce7f797ed30cc24195d3b8ed5db32bc63f9629aefebab5d8e6e21 |
|
| MD5 | e4064598510e41f00bff003528a7271c |
|
| BLAKE2b-256 | 4e9f23abc4281cd332d3cad7aa4d27d3dd6fba4ca5d3d287871a1a0472f83653 |
File details
Details for the file cr.cube-1.6.7-py2-none-any.whl.
File metadata
- Download URL: cr.cube-1.6.7-py2-none-any.whl
- Upload date:
- Size: 32.9 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/2.7.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a94624571b106fbabe93fa29e9e9a05996f1e2e32798103b6248e13871ff2cb9 |
|
| MD5 | 51f1c878deccb303bb171f0c459d63d2 |
|
| BLAKE2b-256 | 955dd0682cff7ad6c3d57155e9a9bcedd65378de875ea22c0d49a836fa102a6a |
