charty 0.1.5.dev → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3042ae173ae222d23df24223a8ee26487449738db74b1624a7a476ca55f6c57d
-  data.tar.gz: 214f33498365cb53a561ef688d9f363682540dda9043c959519cbda88257832a
+  metadata.gz: 4cf18b5e31bf29099d3d9386b8b022e38013bba339c129a0292af39983e2bccb
+  data.tar.gz: 4eb934400a4fc7c60354bf7f7f31e33d4be8cdbdeafb1d47762264d94c8c5a2a
 SHA512:
-  metadata.gz: 30241e82d124030645f9f0d8f550f2e11de8e529ecec1d7a602243f773b55304aceca7e3328ee965082dccec38c1fb81e3790b85257a2bad1344cf23efa81ce5
-  data.tar.gz: 0e537f9f7e868ddd96c602fb98e14d649a2671ea5edab9245b99e5a8c6e235cb13d70209b3c243fcf2d4503ba5887f28aa37a6a88a3888461103b7f0930f09c6
+  metadata.gz: 33f5c4ea51ea77a66538e62e43222aaa4f77942b526461ef881cd0ff092eb17a16830937eab032995361a1e7b9e0063e79f682b75fa1c0011644410f02c23b11
+  data.tar.gz: cd0c31ae974c4efc6192dc0fa74c93db41cdacac6e5a82cfded9ca1b4285e706c925641df483020d620f22e3aed5fae7263d2364ac0cfb5df35bbf4fc72ad034

data/.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches:
+    - master
+  pull_request:
+    types:
+    - opened
+    - synchronize
+    - reopened
+
+jobs:
+  test:
+    name: ${{ matrix.os }}/${{ matrix.ruby }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+        - ubuntu-20.04
+        - ubuntu-18.04
+        ruby:
+        - "3.0"
+        - 2.7
+        - 2.6
+        include:
+        - { os: ubuntu-20.04 , ruby: head }
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+
+    - uses: actions/cache@v2
+      if: runner.os == 'Linux'
+      with:
+        path: ~/.cache/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - uses: actions/cache@v2
+      if: |
+        runner.os == 'macOS'
+      with:
+        path: |
+          ~/Library/Caches/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - uses: actions/cache@v2
+      if: |
+        runner.os == 'Windows'
+      with:
+        path: |
+          ~/AppData/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - run: sudo apt install build-essential libsqlite3-dev
+
+    - run: bundle install --jobs 4 --retry 3 --without "nmatrix python"
+
+    - run: bundle exec rake
+
+    - run: rake build
+
+    - run: gem install --user pkg/*.gem

data/.github/workflows/nmatrix.yml

@@ -0,0 +1,67 @@
+name: CI with NMatrix
+
+on:
+  push:
+    branches:
+    - master
+  pull_request:
+    types:
+    - opened
+    - synchronize
+    - reopened
+
+jobs:
+  test:
+    name: ${{ matrix.os }}/${{ matrix.ruby }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+        - ubuntu-20.04
+        ruby:
+        - 2.7
+        - 2.6
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+
+    - uses: actions/cache@v2
+      if: runner.os == 'Linux'
+      with:
+        path: ~/.cache/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - uses: actions/cache@v2
+      if: |
+        runner.os == 'macOS'
+      with:
+        path: |
+          ~/Library/Caches/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - uses: actions/cache@v2
+      if: |
+        runner.os == 'Windows'
+      with:
+        path: |
+          ~/AppData/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - run: sudo apt install build-essential libsqlite3-dev
+
+    - run: bundle install --jobs 4 --retry 3 --without "numo python"
+
+    - run: bundle exec rake
+
+    - run: rake build
+
+    - run: gem install --user pkg/*.gem

data/.github/workflows/pycall.yml

@@ -0,0 +1,86 @@
+name: CI with matplotlib and pandas
+
+on:
+  push:
+    branches:
+    - master
+  pull_request:
+    types:
+    - opened
+    - synchronize
+    - reopened
+
+jobs:
+  test:
+    name: ${{ matrix.os }}/${{ matrix.ruby }}/${{ matrix.python }}-${{ matrix.python_architecture }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+        - ubuntu-20.04
+        - ubuntu-18.04
+        ruby:
+        - "3.0"
+        - 2.7
+        - 2.6
+        python:
+        - 3.x
+        - 2.x
+        python_architecture:
+        - x64
+        include:
+        - { os: ubuntu-20.04 , ruby: head , python: 3.x , python_architecture: x64 }
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Setup Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+
+    - name: Setup Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python }}
+        architecture: ${{ matrix.python_architecture }}
+
+    - uses: actions/cache@v2
+      if: runner.os == 'Linux'
+      with:
+        path: ~/.cache/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - uses: actions/cache@v2
+      if: |
+        runner.os == 'macOS'
+      with:
+        path: |
+          ~/Library/Caches/red-datasets
+          key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+          restore-keys: ${{ runner.os }}-
+
+    - uses: actions/cache@v2
+      if: |
+        runner.os == 'Windows'
+      with:
+        path: |
+          ~/AppData/red-datasets
+        key: ${{ runner.os }}-${{ hashFiles('lib/**') }}
+        restore-keys: ${{ runner.os }}-
+
+    - run: sudo apt install build-essential libsqlite3-dev
+
+    - run: pip install --user matplotlib pandas
+
+    - run: bundle install --jobs 4 --retry 3 --without "nmatrix numo"
+
+    - run: python -V
+
+    - run: bundle exec rake
+      env:
+        PYTHON: python
+      continue-on-error: ${{ matrix.python == '2.x' }}

data/Dockerfile.dev

@@ -1,2 +1,10 @@
-ARG BASE_IMAGE_TAG=c9ca70040856
+ARG BASE_IMAGE_TAG=e1a22a2
 FROM rubydata/minimal-notebook:$BASE_IMAGE_TAG
+
+USER root
+RUN mkdir -p /charty && \
+    chown ${NB_USER}:users /charty
+
+USER ${NB_USER}
+
+WORKDIR /charty

data/Gemfile

@@ -4,3 +4,21 @@ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in charty.gemspec
 gemspec
+
+group :cruby do
+  gem "enumerable-statistics"
+end
+
+group :nmatrix do
+  gem "nmatrix"
+end
+
+group :numo do
+  gem "numo-narray"
+end
+
+group :python do
+  gem "matplotlib"
+  gem "numpy"
+  gem "pandas"
+end

data/README.md

@@ -1,7 +1,9 @@
 # Charty - Visualizing your data in Ruby
 
-[![Build Status](https://travis-ci.org/red-data-tools/charty.svg?branch=master)](https://travis-ci.org/red-data-tools/charty)
+![Build Status](https://github.com/red-data-tools/charty/workflows/CI/badge.svg)
+[![Gem Version](https://badge.fury.io/rb/charty.svg)](https://badge.fury.io/rb/charty)
 [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/red-data-tools/charty/master?filepath=iris_dataset.ipynb)
+[![Docs](https://img.shields.io/badge/docs-stable-blue.svg)](https://rubydoc.info/gems/charty)
 
 Charty is open-source Ruby library for visualizing your data in a simple way.
 In Charty, you need to write very few lines of code for representing what you want to do.
@@ -32,8 +34,8 @@ $ CONFIGURE_OPTS="--enable-shared" pyenv install 3.x.x
 ### With Matplotlib
 
 ```
-sudo gem install charty --pre
-sudo gem install matplotlib
+gem install charty --pre
+gem install matplotlib
 sudo apt install python3-pip
 sudo python3 -m pip install -U pip matplotlib
 ```
@@ -43,18 +45,183 @@ sudo python3 -m pip install -U pip matplotlib
 e.g.
 
 ```
-$ bundle install
-$ docker build -f ./Dockerfile.dev -t charty-dev:0.1 .
-$ docker run -it -v ${PWD}:/charty -w /charty charty-dev:0.1 ./bin/console
+$ docker build -f ./Dockerfile.dev -t charty-dev:latest .
+$ docker run --rm -v $(pwd):/charty charty-dev:latest bundle install
+$ docker run --rm -it -v $(pwd):/charty charty-dev:latest ./bin/console
 irb(main):001:0> Charty::VERSION
-=> "0.1.4-dev"
+=> "0.2.2"
 
 # When using jupyter notebook
-$ docker run -it -v ${PWD}:/charty -w /charty -p 8888:8888 charty-dev:0.1
+$ docker run --rm -it -v $(pwd):/charty -p 8888:8888 charty-dev:latest
 ```
 
 ## Usage
 
+### Statistical plotting interface
+
+Charty supports statistical plotting as Python's seaborn.
+
+In the following examplles, we use the `penguins` dataset provided in red-datasets.
+
+```ruby
+require "datasets"
+
+penguins = Datasets::Penguins.new
+```
+
+#### A basic workflow
+
+The following code shows a basic workflow of the visualization with Charty.
+
+First you need to load the Charty library.
+
+```ruby
+require "charty"
+```
+
+Next you msut have a dataset you want to visualize.  Here, we use the penguins dataset provided in red-datasets library.
+
+```ruby
+require "datasets"
+penguins = Datasets::Penguins.new
+```
+
+Next you need to create a plotter object by a plotting method.  Here, we use `scatter_plot` method to show the relationship
+among `body_mass_g`, `flipper_length_mm`, and `species` columns in the penguins dataset.
+
+```ruby
+plot = Charty.scatter_plot(data: penguins, x: :body_mass_g, y: :flipper_length_mm, color: :species)
+```
+
+If you want to render and save this plotter object into an HTML file by plotly backend, you can do it like below.
+
+```ruby
+Charty::Backends.use(:plotly)  # select plotly backend
+plot.save("scatter.html")      # save the plot as  an HTML file
+```
+
+If you want to save the plotter into a PNG file, you can do it by specifying a output filename with `.png` extension.
+
+```ruby
+plot.save("scatter.png")
+```
+
+#### Jupyter Notebook
+
+If you use Charty on Jupyter Notebook with IRuby kerenl (a.k.a. IRuby notebook),
+you can render the plot just evaluate a plotter object.  For example, the code below shows a scatter plot figure in
+the output area.
+
+```ruby
+Charty::Backends.use(:plotly)
+
+Charty.scatter_plot(data: penguins, x: :body_mass_g, y: :flipper_length_mm, color: :species)
+```
+
+Note that if you want to use the pyplot backend, you need to activate the integration between the pyplot backend and IRuby.
+You can activate the integration by the following two lines.
+
+```ruby
+Charty::Backends.use(:pyplot)
+Charty::Backends::Pyplot.activate_iruby_integration
+```
+
+#### Bar plot
+
+Charty's statistical bar plot shows the relationship between a categorical variable and estimated means of a numeric variable.
+This plot automatically calculates mean estimation and its 95% confidence interval of the numeric variable.
+
+When we specify the categorical varaible as x-axis, the plot draws a vertical bar chart.
+Instead, when we specify the categorical variable as y-axis, the plot draws a horizontal bar chart.
+
+The following code shows the relationship between species and the mean body masses of penguins in a vertical bar chart.
+
+```ruby
+Charty.bar_plot(data: penguins, x: :species, y: :body_mass_g)
+```
+
+![](images/penguins_species_body_mass_g_bar_plot_v.png)
+
+Exchanging x and y axes alternates the orientation of the resulting chart.
+
+```ruby
+Charty.bar_plot(data: penguins, x: :body_mass_g, y: :species)
+```
+
+![](images/penguins_species_body_mass_g_bar_plot_h.png)
+
+Adding color axis introduces color grouping in the bar plot.
+
+```ruby
+Charty.bar_plot(data: penguins, x: :species, y: :body_mass_g, color: :sex)
+```
+
+![](images/penguins_species_body_mass_g_sex_bar_plot_v.png)
+
+#### Box plot
+
+Charty's statistical box plot shows distributions of a numeric variable per categories.
+The distributions are showed by boxes with whiskers that characterized by five-number summary.
+This plot automatically calculates five-number summary the numeric variable per categories.
+
+When we specify the categorical varaible as x-axis, the plot draws a vertical box plot chart.
+Instead, when we specify the categorical variable as y-axis, the plot draws a horizontal box plot chart.
+
+The following code draws a vertical box plot to show distributions of penguins' body mass per species.
+
+```ruby
+Charty.box_plot(data: penguins, x: :species, y: :body_mass_g)
+```
+
+![](images/penguins_species_body_mass_g_box_plot_v.png)
+
+As `bar_plot` above, exchanging x and y axes alternates the orientation of the resulting chart.
+
+```ruby
+Charty.box_plot(data: penguins, x: :body_mass_g, y: :species)
+```
+
+![](images/penguins_species_body_mass_g_box_plot_h.png)
+
+Adding color axis introduces color grouping in the box plot.
+
+```ruby
+Charty.box_plot(data: penguins, x: :species, y: :body_mass_g, color: :sex)
+```
+
+![](images/penguins_species_body_mass_g_sex_box_plot_v.png)
+
+#### Scatter plot
+
+Charty's scatter plot shows the relationship between two numeric variables.
+
+```ruby
+Charty.scatter_plot(data: penguins, x: :body_mass_g, y: flipper_length_mm)
+```
+
+![](images/penguins_body_mass_g_flipper_length_mm_scatter_plot.png)
+
+Adding color axis introduces color grouping in the scatter plot.
+The following example specifies `:species` variable in the color axis.
+It shows the different species by the different colors.
+
+```ruby
+Charty.scatter_plot(data: penguins, x: :body_mass_g, y: flipper_length_mm, color: :species)
+```
+
+![](images/penguins_body_mass_g_flipper_length_mm_species_scatter_plot.png)
+
+Moreover, size and style axes can be specified.
+The following example specifies `:sex` variable in the style axis.
+
+```ruby
+Charty.scatter_plot(data: penguins, x: :body_mass_g, y: flipper_length_mm, color: :species, style: :sex)
+```
+
+![](images/penguins_body_mass_g_flipper_length_mm_species_sex_scatter_plot.png)
+
+### Old-style plotting interface
+
 ```ruby
 require 'charty'
 charty = Charty::Plotter.new(:pyplot)
@@ -354,7 +521,7 @@ hist.render("sample_images/hist_pyplot.png")
 
 #### Gruff
 
-Not supported
+![hist_gruff](https://raw.githubusercontent.com/red-data-tools/charty/master/examples/sample_images/hist_gruff.png)
 
 #### Rubyplot