view README.md @ 92:9cde0dc0699e default tip

fix README.md
author aka
date Wed, 27 Jun 2018 00:10:30 +0900
parents ee031a093708
children
line wrap: on
line source

# Minimal CbC kernel for Jupyter
It is CbC kernel for Jupyter. 

Referenced from https://github.com/brendan-rius/jupyter-c-kernel

## Install

### Local Jupyter



CbC install
```
hg clone http://www.cr.ie.u-ryukyu.ac.jp/hg/CbC/CbC_gcc/
mkdir build-gcc && cd build-gcc
../CbC_gcc/configure CFLAGS="-g3 -O0" \
             --prefix=/usr/ --disable-nls \
             --disable-bootstrap --enable-languages=c \
             --enable-checking=tree,rtl,assert,types 
             
make && make install
```

after, kernel install.

```
hg clone http://www.cr.ie.u-ryukyu.ac.jp/hg/Members/aka/jupyter_CbC_kernel
cd jupyter_CbC_kernel
pip3 install --upgrade pip jupyter ipykernel
pip3 install .
cd jupyter_CbC_kernel && install_CbC_kernel --user
cd ..
jupyter notebook
```

### Use with Docker (recommended)

```
hg clone http://www.cr.ie.u-ryukyu.ac.jp/hg/Members/aka/jupyter_CbC_kernel
cd jupyter_CbC_kernel
docker build -t aka/jupyter_cbc_kernel .
docker run -p 8888:8888 --name jupyter_cbc_kernel aka/jupyter_cbc_kernel start-notebook.sh

< 略 >

    Copy/paste this URL into your browser when you connect for the first time,
    to login with a token:
        http://0205e0a0e8b6:8888/?token=934058629ebd810e26f1c37a3cbb350fbb8edb95fcf4e0bd&token=934058629ebd810e26f1c37a3cbb350fbb8edb95fcf4e0bd

```

change host name "localhost".

and open above link  "http://localhost:8888/?token=934058629ebd810e26f1c37a3cbb350fbb8edb95fcf4e0bd&token=934058629ebd810e26f1c37a3cbb350fbb8edb95fcf4e0bd"


## Example of notebook

![Example](Example.jpg)

## Custom compilation flags

You can use custom compilation flags like so:

![Custom compulation flag](custom_flags.png?raw=true "Example of notebook using custom compilation flags")

Here, the `-lm` flag is passed so you can use the math library.

## License

[MIT](LICENSE.txt)