Skip to content

Latest commit

 

History

History
118 lines (87 loc) · 2.72 KB

readme.md

File metadata and controls

118 lines (87 loc) · 2.72 KB
Raw

RedAmber Minimal Notebook

This is a docker image containing RedAmber created from jupyter/minimal-notebook

Contents

  • From jupyter/minimal-notebook:
    • Based on 2023-05-15 (513d0cb8a67c)
    • x86-64
    • Ubuntu-22.04
    • python-3.10.11
    • lab-3.6.3
    • notebook-6.5.4
  • System ruby-dev:
    • Ruby 3.0.2
  • Arrow 11.0.0 for Ubuntu:
    • libarrow-dev
    • libarrow-glib-dev
    • libparquet-dev
    • libparquet-glib-dev
  • Locally installed iruby:
    • Using Ruby 3.0.2
  • Locally installed bundler and Gemfile:
    • RedAmber 0.5.0
    • Others (see Gemfile)

Install

git clone https://github.com/heronshoes/red_amber.git
cd  docker

Edit ENV variable in .env as you like.

[note] NB_USER is fixed for jovyan, the common user name in Jupyter, can not change it in this version.

If TZ is not used in your host system, define it here. Otherwise UTC is used in the container.

TOKEN will be used for token-based authentication.

# Example
TZ=Asia/Tokyo
TOKEN='something'

Then build red_amber-minimal-notebook container. It will take a while.

docker-compose build

Start Jupyter Lab

After build, start the container. Adding -d option will detach it in background.

docker-compose up

You can access Jupyter Lab from http://localhost:8888/ in your browser.

Example in REPL

You can try RedAmber in irb with pre-loaded datasets.

Start terminal in Jupyter.

For the first run,

source ~/.bashrc
../example

It will take a while for the first run to fetch and prepare red-datasets cache.

If irb starts you can see:

    69: # Welcome to RedAmber example!
    70: # This environment will offer these pre-loaded datasets:
    71: #   penguins, diamonds, iris, starwars, simpsons_paradox_covid,
    72: #   mtcars, band_members, band_instruments, band_instruments2
    73: #   (original) import_cars, comecome, dataframe, subframes
 => 74: binding.irb

irb(main):001:0>

RedAmber is already loaded in this environment with some datasets shown above.

irb(main):002:0> dataframe
=> 
#<RedAmber::DataFrame : 6 x 3 Vectors, 0x0000000000003818>
        x y        z
  <uint8> <string> <boolean>
0       1 A        false
1       2 A        true
2       3 B        false
3       4 B        (nil)
4       5 B        true
5       6 C        false

Next time you start this environment, you can simply invoke as ../example.