<h1 align=center><font size = 5>Як інсталювати R, R Studio, Jupyter notebook та підключити RKernel</font></h1>
<h1 align=center><font size = 5>Покрокова інструкція</font></h1>

Як інсталювати R, R Studio, Jupyter notebook та підключити RKernel

Покрокова інструкція

 
### Вітаємо!
​
Слідуючи покроковим інструкціям цього зошита, Ви зможете підключити ключові програми більшості Data Scientist'ів

Вітаємо!

Слідуючи покроковим інструкціям цього зошита, Ви зможете підключити ключові програми більшості Data Scientist'ів

 
## Зміст
​
<div class="alert alert-block alert-info" style="margin-top: 20px">
<li><p><a href="#ref0">Інсталяція R</a></p></li>
<li><p><a href="#ref1">Інсталяція R Studio</a></p></li>
<li><p><a href="#ref2">Інсталяція і запуск Jupyter notebook</a></p></li>
<li><p><a href="#ref3">Підключення RKernel</a></p></li>
<br>
<p></p>
Очікувана тривалість: <strong>25 хв</strong> 
</div>
​
<hr>

Зміст

  • Інсталяція R

  • Інсталяція R Studio

  • Інсталяція і запуск Jupyter notebook

  • Підключення RKernel


    • Очікувана тривалість: 25 хв
     
    <a id="ref0"></a>
    <h2 align=center>Інсталяція R</h2>

    Інсталяція R

     
    Щоб інсталювати базовий пакет R, необхідно:

    Щоб інсталювати базовий пакет R, необхідно:

     
    - відвідати сайт **[www.cran.r-project.org/bin/windows/base/](https://cran.r-project.org/bin/windows/base/)**
    - скачати файл на локальний диск, клікнувши **Download R 3.4.3 for Windows** 
    - відкрити отриманий .exe файл на своєму комп'ютері та інсталювати програму R, слідуючи інструкціям.
    ​
    * Якщо у вас замість Windows стоїть MAC або LINUX, оберіть відповідні файли для інсталяції з головної сторінки [www.cran.r-project.org](https://cran.r-project.org/)
    • відвідати сайт www.cran.r-project.org/bin/windows/base/
    • скачати файл на локальний диск, клікнувши Download R 3.4.3 for Windows

    • відкрити отриманий .exe файл на своєму комп'ютері та інсталювати програму R, слідуючи інструкціям.

    • Якщо у вас замість Windows стоїть MAC або LINUX, оберіть відповідні файли для інсталяції з головної сторінки www.cran.r-project.org

     
    <hr></hr>
    <div class="alert alert-success alertsuccess" style="margin-top: 20px">
    **Лайфхак**: Для старту роботи в R рекомендую:
    </div>

    Лайфхак: Для старту роботи в R рекомендую:
     
    - переглянути перші хвилини **[відео-ролику](https://www.youtube.com/watch?v=lVKMsaWju8w&feature=youtu.be)** і завантажити та інсталювати R та R Studio
    ​
    - створити на своєму ноутбуці папку **"DSCF"**, в ній - підпапки **"lesson1"**, **"lesson2"**, ... **"lessonN"**, і завантажувати туди розархівовані файли із даними та скриптами, які будемо опрацьовувати впродовж курсу.
    ​
    - для швидкого підвантаження усіх додаткових пекеджів: відкрити файл **install_packages.R** в R Studio,  Виділити усі рядки від *must-have* до *additional*, клінути комбінацію клавіш CONTROL+R і чекати поки інсталюються всі пекеджі (має внизу зліва про всі рядки написати про успішну загрузку)

    • переглянути перші хвилини відео-ролику і завантажити та інсталювати R та R Studio

    • створити на своєму ноутбуці папку "DSCF", в ній - підпапки "lesson1", "lesson2", ... "lessonN", і завантажувати туди розархівовані файли із даними та скриптами, які будемо опрацьовувати впродовж курсу.

    • для швидкого підвантаження усіх додаткових пекеджів: відкрити файл install_packages.R в R Studio, Виділити усі рядки від must-have до additional, клінути комбінацію клавіш CONTROL+R і чекати поки інсталюються всі пекеджі (має внизу зліва про всі рядки написати про успішну загрузку)

     
    ### Корисна інформація на майбутнє (для оновлень / або деінсталяції)

    Корисна інформація на майбутнє (для оновлень / або деінсталяції)

    In [ ]:
     
    # After installation of new R version :
    ​
    # 2.8 What’s the best way to upgrade?
    # 
    # That’s a matter of taste. 
    # For most people the best thing to do is to
    # uninstall R (see the previous Q), 
    # install the new version, 
    # copy any installed packages to the library folder in the new installation, 
    # run update.packages(checkBuilt=TRUE, ask=FALSE) in the new R 
    ​
    update.packages(checkBuilt=TRUE, ask=FALSE)
    ​
    # and then delete anything left of the old installation. 
    # Different versions of R are quite deliberately installed 
    # in parallel folders so you can keep old versions around if you wish.
    # For those with a personal 
    # library (folder R\win-library\x.y of your home directory, 
    #          R\win64-library\x.y on 64-bit builds), 
    # you will need to update that too when the minor version of R changes 
    # (e.g. from 3.0.2 to 3.1.0). A simple way to do so is to copy (say) 
    # R\win-library\3.0 to R\win-library\3.1 
    # before running update.packages(checkBuilt=TRUE, ask=FALSE).
    ​
    # 2.7 How do I UNinstall R?
    # 
    # Normally you can do this from the ‘Programs and Features’ group in the Control Panel. If it does not appear there, run unins000.exe in the top-level installation directory. On recent versions of Windows you may be asked to confirm that you wish to run a program from an ‘unknown’ or ‘unidentified’ publisher.
    # Uninstalling R only removes files from the initial installation, not (for example) packages you have installed or updated.
    # If all else fails, you can just delete the whole directory in which R was installed.
     
    <hr>
     
    <a id="ref1"></a>
    <h2 align=center>Інсталяція R Studio</h2>

    Інсталяція R Studio

     
    RStudio is a set of integrated tools designed to help you be more productive with R. It includes a console, syntax-highlighting editor that supports direct code execution, and a variety of robust tools for plotting, viewing history, debugging and managing your workspace.

    RStudio is a set of integrated tools designed to help you be more productive with R. It includes a console, syntax-highlighting editor that supports direct code execution, and a variety of robust tools for plotting, viewing history, debugging and managing your workspace.

     
    Для інсталяції R Studio необхідно:
    ​
    - **Зайти на сторінку** https://www.rstudio.com/products/rstudio/download/ 
    - **Скачати та інсталювати** 'RStudio Desktop Open Source License' (FREE)

    Для інсталяції R Studio необхідно:

     
    <img src = "img/RStudio download.png" width = 90% align="left">

     
    <hr></hr>
    <div class="alert alert-success alertsuccess" style="margin-top: 20px">
    **Лайфхак**: У майбутньому при оновленні R, можуть бути проблеми із запуском R Studio. Для рішення проблеми і вибору нової версії R, під час запуску R Studio необхідно натискати кнопку 'CTRL', після чого з'явится діалогове вікно, у якому просто вкажіть бажану версію R - і програма знову запрацює коректно.
    </div>

    Лайфхак: У майбутньому при оновленні R, можуть бути проблеми із запуском R Studio. Для рішення проблеми і вибору нової версії R, під час запуску R Studio необхідно натискати кнопку 'CTRL', після чого з'явится діалогове вікно, у якому просто вкажіть бажану версію R - і програма знову запрацює коректно.
     
    <a id="ref2"></a>
    <h2 align=center>Інсталяція і запуск Jupyter notebook</h2>

    Інсталяція і запуск Jupyter notebook

     
    Детальну інформацію про Jupyter notebook знайдете тут:
    ​
    <a href="http://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/index.html">Jupyter/IPython Notebook Quick Start Guide</a>
    ​
    Ми ж зупинимось на практичних аспектах інсталяції та запуску цього потужного інструменту для аналізу даних.

    Детальну інформацію про Jupyter notebook знайдете тут:

    Jupyter/IPython Notebook Quick Start Guide

    Ми ж зупинимось на практичних аспектах інсталяції та запуску цього потужного інструменту для аналізу даних.

     
    ### Інсталюємо дистрибутив Anaconda
    Найлегший спосіб інсталювати <em>Jupyter Notebook App</em> полягає у використанні дистрибутиву Anaconda. Для цього треба:
    <ul class="simple">
    <li>Скачати <a class="reference external" href="https://store.continuum.io/cshop/anaconda/">Continuum Anaconda</a>
    (free version, approx. 400MB), python 3, 64 bits.</li>
    <li>Інсталювати його використовуючи 'the default settings for a single user'. (детальний алгоритм інсталяції: <a class="reference external" href="https://docs.anaconda.com/anaconda/install/">Anaconda Distribution</a>)</li>
    </ul>
    <p><em>Офіційні документи:</em> <a class="reference external" href="https://jupyter.readthedocs.org/en/latest/install.html#new-to-python-and-jupyter">Installation: If you are new to Python and Jupyter</a>.</p>

    Інсталюємо дистрибутив Anaconda

    Найлегший спосіб інсталювати Jupyter Notebook App полягає у використанні дистрибутиву Anaconda. Для цього треба:

    • Скачати Continuum Anaconda (free version, approx. 400MB), python 3, 64 bits.

    • Інсталювати його використовуючи 'the default settings for a single user'. (детальний алгоритм інсталяції: Anaconda Distribution)

    Офіційні документи: Installation: If you are new to Python and Jupyter.

     
    ### Запускаємо Jupyter Notebook
    ​
    The Jupyter Notebook App can be launched by clicking on the Jupyter Notebook icon installed by Anaconda in the start menu (Windows) or by typing in a terminal (cmd on Windows):

    Запускаємо Jupyter Notebook

    The Jupyter Notebook App can be launched by clicking on the Jupyter Notebook icon installed by Anaconda in the start menu (Windows) or by typing in a terminal (cmd on Windows):

    In [ ]:
     
    jupyter notebook
     
    <a id="ref3"></a>
    <h2 align=center>Підключення RKernel</h2>

    Підключення RKernel

     
    Підключення RKernel дає змогу програмувати мовою R в Jupyter notebooks, які за умовчанням використовують python, а не R. 
    ​
    Відтак в одному браузері ви зможете насолоджуватись перевагами обох інструментів.
    ​
    Для підключення необхідно (після успішного запуску Jupyter Notebook):
    ​
    1) створити R-script в R Studio 
    ​
    2) записати і виконати код для інсталяції пекеджів:

    Підключення RKernel дає змогу програмувати мовою R в Jupyter notebooks, які за умовчанням використовують python, а не R.

    Відтак в одному браузері ви зможете насолоджуватись перевагами обох інструментів.

    Для підключення необхідно (після успішного запуску Jupyter Notebook):

    1) створити R-script в R Studio

    2) записати і виконати код для інсталяції пекеджів:

    In [ ]:
     
    # install.packages('devtools')
    install.packages(c('repr', 'IRdisplay', 'evaluate', 'crayon', 'pbdZMQ', 'devtools', 'uuid', 'digest'))
    devtools::install_github('IRkernel/IRkernel')
    # or devtools::install_local('IRkernel-master.tar.gz')
     
    3) Інсталювати RKernel, що під'єднає функціонал R до вашого Jupyter notebook:

    3) Інсталювати RKernel, що під'єднає функціонал R до вашого Jupyter notebook:

    In [ ]:
     
    # Don’t forget this step
    IRkernel::installspec()
     
    Якщо у майбутньому будете оновлювати R, необхідно буде повторити ці операції ще раз.

    Якщо у майбутньому будете оновлювати R, необхідно буде повторити ці операції ще раз.

     
    ### Альтернативний спосіб 
    ​
    Деталі - на [форумі](https://discuss.analyticsvidhya.com/t/how-to-run-r-on-jupyter-ipython-notebooks/5512/2) і в цьому [відео-туторіалі](https://www.youtube.com/watch?v=psfSxvMOXyo)

    Альтернативний спосіб

    Деталі - на форумі і в цьому відео-туторіалі

     
    <hr></hr>
    <div class="alert alert-success alertsuccess" style="margin-top: 20px">
    <h4> [Автор:]</h4>  
    ​
    Роман Корнилюк, Ph.D
    <p></p>
    </div>
    ​
    <hr></hr>

    [Автор:]


    Роман Корнилюк, Ph.D