Miniconda・Atom Hydrogenを用いたPython環境構築

Python入門書では，Anacondaを用いた環境構築方法が掲載されていることが多いです。しかし，Anacondaはディスクの容量をとるうえに，不要なパッケージが多く入っています。

Minicondaは，Anacondaの縮小版で，必要最小限のパッケージのみがインストールされています。

この記事は，Windowsへのインストールの手順の備忘録的です。

### 環境
- Windows 10 Home(64bit)
- Miniconda3 4.3.31(64bit)

### 手順の概要
1. Minicondaをインストールする。
2. 仮想環境を構築する。
3. Atomをインストールする。
4. AtomにHydrogenパッケージをインストールする。

# Minicondaのインストール

1.[Minicondaのダウンロードページ](https://conda.io/miniconda.html)から，自分のOSに合わせてインストーラをダウンロードします。

2.ダウンロードしたインストーラを実行します。次のようなダイアログが表示されます。[Next]を押して進みます。

![MinicondaInstallDialog](https://qiita-image-store.s3.amazonaws.com/0/215040/faf5d6bf-ce5c-da0f-920c-b6861b1f1ba5.png)

3.インストールディレクトリを選択する際に，空白文字のあると警告されます。"This can cause problems with several Conda packages."とのことなので，素直に空白文字のないディレクトリを選びます。

![SpaceWarning](https://qiita-image-store.s3.amazonaws.com/0/215040/e791ead8-bfc4-b05f-4ad4-a989038da632.png)

4.[Install]を押して，インストールを開始します。

![Miniconda_2.png](https://qiita-image-store.s3.amazonaws.com/0/215040/a730f38e-219e-ff5b-78e2-41434f92ad0f.png)

Minicondaのインストールは終了です。

# 仮想環境を構築
condaを使って，仮想環境を構築します。

1.`conda create -n py36_dw python=3.6` を実行します。

2.`conda info -e`あるいは`conda env list`を実行して，仮想環境の確認をします。

```:実行例
>conda info -e
# conda environments:
#
py36_dw                  C:\Miniconda3\envs\py36_dw
root                  *  C:\Miniconda3
```
3.`activate py36_dw`を実行し，仮想環境を切り替えます。

4.`conda install jupyter`を実行する。これは，**AtomでHydrogenを使うために必要**です。

5.`ipython kernel install --user --name py36_dw --display-name Python3-DataWrangling`を実行して，Jupyterのカーネルを作成します。

6.`jupyter kernelspec list`を実行して，カーネルを確認します。

```:実行例（[USERNAME]にはユーザ名が入ります）
>jupyter kernelspec list
Available kernels:
  py35_dw    C:\Users\[USERNAME]\AppData\Roaming\jupyter\kernels\py35_dw
  python3    C:\Miniconda3\envs\py36_dw\share\jupyter\kernels\python3
```

7.`conda install <パッケージ名>`を実行して必要なパッケージをインストールする。

8.`jupyter notebook`を実行する。ウェブブラウザが起動して，Jupyter Notebookが開かれます。（画像内水色部分はフォルダ・ファイル名です。）

デフォルトで表示されるディレクトリが気に食わない場合，`>jupyter notebook --generate-config`を実行し，生成されたconfigファイルの`#c.NotebookApp.notebook_dir = ''`という部分を書き換えてください。（私の環境では`C:\Users\[USERNAME]\.jupyter`に生成されました。）

![JupyterStart](https://qiita-image-store.s3.amazonaws.com/0/215040/79f0e76f-587c-fb52-a1f3-5069beb2f617.png)

9.試しにNotebookを作成して，ちゃんとパッケージがインストールされているか調べてみます。

![matplotlib_test.png](https://qiita-image-store.s3.amazonaws.com/0/215040/4c76bb5d-455f-fc12-2263-fddaa2effd6a.png)

仮想環境の構築は終了です。

# Atomのインストール
[Atom公式ページ](https://atom.io/)からインストーラをダウンロードして，実行すれば自動的にインストールされます。
さまざまな便利なパッケージがあります。本記事では詳しくは触れず，ほかの素晴らしい記事のリンクを張るにとどめたいと思います。

- [[Qiita] WindowsでAtomをインストールして使ってみる](https://qiita.com/purini-to/items/caca2a0c56e984b2f9d8)
- [[Qiita] 2017年 Atomオススメパッケージ](https://qiita.com/sayama0402/items/3bd8d905619c514179b7)

# Hydrogenのインストール
他のパッケージと同様にHydrogenをインストールします。

うまくいかない場合は，コマンドラインで

```:Hydrogenのインストール（コマンドライン）
>apm install hydrogen
```

を実行してみるといいかもしれません。

apmコマンドへのPATHが通っていない場合は，手動でPATHを通すか，apmのあるディレクトリに移動して実行して下さい。私の環境では，`C:\Users\[USERNAME]\AppData\Local\atom\bin`にありました。

Hydrogenのインストールは終了です。
うまくいきましたでしょうか？試しに実行してみましょう。

![Matplotlib Test](https://qiita-image-store.s3.amazonaws.com/0/215040/15ca54fb-c1aa-12cd-34f6-52c3a07696df.gif)

# よくあるエラー
## Miniconda 関連
問題が起こった場合，まず初めに次のことを実行してみてください。

- すでにPythonがインストールされている場合，アンインストールする。
- 環境変数に以前インストールしたPythonの記述がある場合，それらを削除する。
- インストールするパスをASCII文字のみにする。

これでも解決しない場合，次のサイトを参考にしてみてください。

- [[シラベタ]Anacondaのインストールでエラーになった時に試してみるべきこと](http://shirabeta.net/Anaconda-install-error.html)
- [[GitHub]Failed to Create Anaconda Menus, Directories, etc.](https://github.com/ContinuumIO/anaconda-issues/issues/1775)

## Jupyter 関連
次のサイトを参考にしてみてください。

- [[Qiita] Jupyter上でkernel切り替えをしてもうまく機能しない場合の解決方法](https://qiita.com/wac2/items/9d3961e386714b67f732)
- [[marorikaのブログ] Jupyter Notebookのブラウザ起動エラーの解消方法](http://marorika0405.hatenablog.com/entry/2017/06/19/021130)