Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Binary file removed .coverage
Binary file not shown.
12 changes: 0 additions & 12 deletions .coveragerc

This file was deleted.

17 changes: 0 additions & 17 deletions .hgignore

This file was deleted.

2 changes: 0 additions & 2 deletions .hgtags

This file was deleted.

1 change: 0 additions & 1 deletion .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,5 @@ python:
- 3.4
install:
- pip install -r requirements.txt
- pip install -r requirements-optional.txt
script: python setup.py develop && python setup.py test

21 changes: 3 additions & 18 deletions AUTHORS
Original file line number Diff line number Diff line change
@@ -1,19 +1,4 @@
Cubes was created and is maintained by Stefan Urbanek.
This is a fork of cubes framework called cubes_lite which is maintained by Sergey Kolesnik.

Major contributing authors:

* Stefan Urbanek <stefan.urbanek@gmail.com>, @Stiivi at Twitter
* Robin Thomas <rthomas900@gmail.com>, @rthomas900 at Twitter

People who have submitted patches, reported bugs, consulted features or
generally made Cubes better:

* Jose Juan Montes (jjmontesl)
* Jonathan Camile (deytao)
* Cristian Salamea
* Travis Truman
* Brad Willard
* Mathew Thomas
* Ryan Berlew
* Andrew Bartholomew
* Emily Wagner
Original cubes was created and is maintained by Stefan Urbanek.
You can find the original version and all contributing authors here: https://github.com/DataBrewery/cubes
5 changes: 0 additions & 5 deletions CHANGES

This file was deleted.

2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Copyright (c) 2011-2012 Stefan Urbanek, see AUTHORS for more details
Copyright (c) 2018 Sergey Kolesnik, see AUTHORS for more details

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
137 changes: 28 additions & 109 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,134 +1,53 @@
Cubes - Online Analytical Processing Framework for Python
=========================================================
Cubes-Lite - Online Analytical Processing Framework for Python
==============================================================

[![Join the chat at https://gitter.im/DataBrewery/cubes](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/DataBrewery/cubes?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Cubes-Lite is a Python framework based on Cubes with breaking changes.
It stands for easily constructing non-standard
queries to several cubes at the same time with custom joining rules.

[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=Stiivi&url=https://github.com/databrewery/cubes&title=Cubes&language=&tags=github&category=software)

Cubes is a light-weight Python framework and set of tools for Online
Analytical Processing (OLAP), multidimensional analysis and browsing of
aggregated data.

*Focus on data analysis, in human way*
Cubes is a light-weight Python framework for Online
Analytical Processing (OLAP) and browsing of aggregated data
(https://github.com/DataBrewery/cubes)


Overview
========

Purpose is to provide a framework for giving analyst or any application
end-user understandable and natural way of presenting the multidimensional
data. One of the main features is the logical model, which serves as
abstraction over physical data to provide end-user layer.
Purpose is to provide a framework for constructing complex queries
on several cubes and be a little bit smarter than raw queries, but as much simple.

Features:

* OLAP and aggregated browsing (default backend is for relational databse -
ROLAP)
* multidimensional analysis
* logical view of analysed data - how analysts look at data, how they think of
data, not not how the data are physically implemented in the data stores
* hierarchical dimensions (attributes that have hierarchical dependencies,
such as category-subcategory or country-region)
* localizable metadata and data
* SQL query generator for multidimensional aggregation queries
* OLAP server – HTTP server based on Flask Blueprint, can be [easily
integrated](http://pythonhosted.org/cubes/deployment.html) into your
application.

Download
========

Current recommended version is 1.1.x. It hasn't been yet tagged so please use the *master* branch.
This version includes SQL backend support out of the box, and other backends have been moved to separate
projects (ie. MongoDB). This branch (currently *master*) will be soon tagged as 1.1 release.

Previous stable version was 1.0.1. This version included all backend types, but no further
development will be done on this branch.


Documentation
=============

[Latest documentation](http://cubes.readthedocs.org/en/latest)

Examples
--------

See `examples` directory in the source code repository
for simple examples and use-cases.

See https://github.com/DataBrewery/cubes-examples
for more complex examples.

Models
------

For cubes models see
https://github.com/DataBrewery/cubes-models


Development
============
* OLAP and aggregated browsing
* Custom joining rules between each cube in model
* Use sqlalchemy to construct queries and to get the most optimized query

Source code is in a Git repository [on GitHub](https://github.com/DataBrewery/cubes)

git clone git://github.com/DataBrewery/cubes
Breaking changes
----------------

After you've cloned, you might want to install all of the development dependencies.
* removed slicer server
* removed visualizer
* removed localization
* removed authorization
* removed stores, providers, workspaces
* removed hierarchies

pip install -e .[dev]
* added optional cuts (for different dimensions)

Build the documentation like so. ::
* redesigned model loading
* redesigned a way of aggregation

cd doc
make help
make html

Outputs will go in ``doc/_*``.
* speedup: runtime inspection of 'expression' field replaced with
manual dependencies specification


Requirements
------------

Python >= 2.7 and Python >= 3.4.1

Most of the requirements are soft (optional) and need to be satisfied only if
certain parts of cubes are being used.

* SQLAlchemy from http://www.sqlalchemy.org/ version >= 0.7.4 - for SQL
backend
* Flask from http://flask.pocoo.org/ for Slicer server
* Jinja2 from http://jinja.pocoo.org/docs/ for HTML presenters

Support
=======

If you have questions, problems or suggestions, you can send a message to the
[Google group cubes-discuss](http://groups.google.com/group/cubes-discuss).

IRC channel #databrewery on server irc.freenode.net

Report bugs using [github issue
tracking](https://github.com/DataBrewery/cubes/issues).


Development
-----------

If you are browsing the code and you find something that:

* is over-complicated or not obvious
* is redundant
* can be done in better Python-way

... please let it be known.

Authors
=======
* Python >= 2.7 and Python >= 3.4.1

Cubes is written and maintained by Stefan Urbanek (@Stiivi on Twitter)
<stefan.urbanek@gmail.com> and various contributors. See AUTHORS file for more
information.
* SQLAlchemy from http://www.sqlalchemy.org/ version >= 0.7.4


License
Expand Down
36 changes: 0 additions & 36 deletions Roadmap.md

This file was deleted.

45 changes: 0 additions & 45 deletions Visualizer.md

This file was deleted.

62 changes: 0 additions & 62 deletions bin/slicer-indexer

This file was deleted.

Loading