charty 0.1.4.dev → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac0ecbfb31a75423c412a90df4e17bb155485a0cec9cc9cea06b93d92759ae57
-  data.tar.gz: 75010b133927cfc7e7a028b3b0abf9424aa1138b268712375a76a2cd1c5149bf
+  metadata.gz: 6d70645a4ca621ee142714f3079e85dc843585fa6364c4476d4fdd86761c3b6f
+  data.tar.gz: b4fa589a9b2c5ba31a6869399c5e90e79767d9e8e4a9a0bf0c5e2d4997725dbf
 SHA512:
-  metadata.gz: 2c2d710b65fccbf44338f3f42780130ad55ecff5a86a908664bfa448438d77ecd78e493b1c3a3d4ab30e53b2b4125096cf5784bf77d0df6cde2a11454efbde29
-  data.tar.gz: bed880d3aee1c5d6bd16b2ab30d4ea877cf4ede53609d100703042aefc6f2376adb0df188fb8f11a648ed6343f8c434664c715dd9b08b1a7b57693715995ce36
+  metadata.gz: 6588c1c0105d0994cd024d08f328a6bf10241975abf4ee1b332be0a956f32d7073aed9867b5ddf708ef578e570caf733d422153a479ecae6fedef81daab391c1
+  data.tar.gz: 47999e4ce59f7cfb4263a5002b3dc070c128971257d7fed81fc23bd7314632cd441bba2ac93a0fdbeb3644d739434dad3d1cad7b465a093af6c53a5766555991

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,135 @@ 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
+```
+
+#### 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::Backends.use(:pyplot)
+Charty.bar_plot(data: penguins, x: :species, y: :body_mass_g).render
+```
+
+![](images/penguins_species_body_mass_g_bar_plot_v.png)
+
+Exchanging x and y axes alternates the orientation of the resulting chart.
+
+```ruby
+Charty::Backends.use(:pyplot)
+Charty.bar_plot(data: penguins, x: :body_mass_g, y: :species).render
+```
+
+![](images/penguins_species_body_mass_g_bar_plot_h.png)
+
+Adding color axis introduces color grouping in the bar plot.
+
+```ruby
+Charty::Backends.use(:pyplot)
+Charty.bar_plot(data: penguins, x: :species, y: :body_mass_g, color: :sex).render
+```
+
+![](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::Backends.use(:pyplot)
+Charty.box_plot(data: penguins, x: :species, y: :body_mass_g).render
+```
+
+![](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::Backends.use(:pyplot)
+Charty.box_plot(data: penguins, x: :body_mass_g, y: :species).render
+```
+
+![](images/penguins_species_body_mass_g_box_plot_h.png)
+
+Adding color axis introduces color grouping in the box plot.
+
+```ruby
+Charty::Backends.use(:pyplot)
+Charty.box_plot(data: penguins, x: :species, y: :body_mass_g, color: :sex).render
+```
+
+![](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::Backends.use(:pyplot)
+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::Backends.use(:pyplot)
+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::Backends.use(:pyplot)
+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 +473,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
 

data/Rakefile

@@ -1,10 +1,9 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
 
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList['test/**/*_test.rb']
+desc "Run tests"
+task :test do
+  ruby("test/run.rb")
 end
 
-task :default => :test
+task default: :test