Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
168 lines (128 sloc) 10.2 KB

NICAR 2018 install guide

Drop by our install party at 10:15 a.m. on Sunday, March 11, in Clark, and we'll help you get your rig set up.

ow wow

Meantime, Here's how IRE set up the PC and Mac laptops for #NICAR18. (Keep in mind that you may not need all of these tools at once.)

A note on Python packages: To simplify things, we didn't use virtual environments to isolate dependencies for each Python session. You should do this for your projects, though! A variety of tools can help you manage project dependencies in a virtual environment, including pyenv, pipenv and virtualenv (plus, optionally, virtualenvwrapper). (The conference computers have virtualenv and virtualenvwrapper available, FWIW.)

Also, we didn't include instructions for setting up a virtualbox to run the programs used in the "CAR Throwback" session. (If you really get the urge to party like it's 1998, let us know and we'll hook you up.)

Windows

Spreadsheets and general office software

Coding and statistics

  • Python 3.6.4 (Make sure that the "Install launcher for all users" and the "Add Python 3.6 to PATH" checkboxes on the install screen are checked)

  • Python packages:

    beautifulsoup4 ipython requests csvkit csvdedupe probablepeople usaddress sklearn pandas matplotlib lxml jupyter xlrd html5lib csvmatch matplotlib seaborn visidata pyshp coverage freezegun flake8 numpy nltk spacy tabula-py pypdfocr

  • Node.js 8.9.4

  • Install some node packages globally (again, you probably won't need all of these installed for every project you do in life, so def take advantage of node's package management workflow to handle project dependencies):

    npm install -g gulp gulp-cli grunt grunt-cli http-server hot-server yo generator-yeogurt

  • R

  • RStudio

  • Install R libraries:

    "tidyverse", "fivethirtyeight", "nycflights", "babynames", "XML", "rtweet", "splines", "gee", "lme4", "nlme", "survival", "Ecdat", "DT", "here", "evaluate", "digest", "highr", "Rcpp", "htmltools", "knitr", "rprojroot", "rmarkdown", "leaflet", "shinycssloaders", "rgdal", "tigris", "packrat"

  • PSPP

Web browsers

Text editors

Data cleaning, extraction, preparation

  • OpenRefine
  • Tabula
  • cometdocs desktop app
  • The Tableau Reshaper Tool for Excel (ZIP)
    • Once the file is on your computer, extract the file from the ZIP file and double-click it to install
    • Open Excel, click the File tab, click Options, and then click Add-Ins
    • From the Manage box, select Excel Add-ins, and then click Go
    • In the Add-Ins dialog box, verify the check box next to the Tableau add-in is selected, and click OK

Command-line tools

  • pdftk
  • tesseract
  • ghostscript
  • imagemagick
  • git (setup guide)
  • xpdf tools (ZIP)
    • Extract the folder to a directory somewhere
    • Add the path to the bin64 folder to the Environmental Variable path:
      • Right click on "This PC"
      • Click Properties, then Advanced System Settings
      • Click Environmental Variables
      • Select Path and click Edit
      • Add the path to the bin64 folder you extracted, ensuring that you separate the path from the rest of the values in Path with a semicolon, then press OK

Mapping

SQL and graph databases

  • DB Browser for SQLite
  • WAMP
  • Neo4j
  • Postgres and PgAdmin - check out this @anthonydb installation guide
  • MySQL Web Community Installer
    • Choose the "Developer Default" install option
    • It will begin to check for requirements. The requirement for MySQL For Excel is the Microsoft Visual Studio Tools for Office Runtime 2010 setup.
    • A screen with a list of the products to be installed will appear. If you see this, press Execute, then Next, then Next
    • On the next screen, select Standalone MySQL Server / Classic MySQL Replication
    • Click Next. On the next screen, choose "Development Machine" for Config Type. Make sure that the checkboxes next to TCP/IP and Open Firewall port for network access are checked. Set the Port Number to 3306 (default)
    • Click Next. On the following screen, set the MySQL Root Password and make a note of it somewhere. Do not add any user accounts, for now.
    • Click Next. Check the boxes to Configure MySQL Server as a Windows Service and allow the default name to persist. Also check the box to Start the MySQL Server at System Startup. Run the Windows Service as a Standard System Account by selecting the button next to that option.
    • Once you click Next, you'll see a screen for Plugins and Extensions. Do not do anything on the page when asked to change settings for MySQL as a Document Store. Click Next.
    • On the next screen, press Execute to apply the configuration. Then click Finish. You’ll be back at the Product Configuration screen. Press Next.
    • On the MySQL Router Configuration screen, do not make any selections. Simply click Finish.
    • You will then see a screen to Connect to Server. Make sure MySQL Server 5.7.21 has a checkbox marked next to it. Supply the credentials below that. Username is root and password is whatever password you set earlier. Press Check to see if the connection was successful.
    • Click Next. On the following screen, press Execute. You'll see a screen indicating the Installation is complete. Click Finish.

Misc.

Mac

Spreadsheets and general office software

Web browsers

Coding and statistics

  • Homebrew -- in your terminal, run:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  • In your terminal, run: xcode-select --install

  • Brew install python3, git, node, tesseract, xpdf, imagemagick, ghostscript:

    brew install python3 git node tesseract xpdf imagemagick ghostscript

  • Python packages:

    beautifulsoup4 ipython requests csvkit csvdedupe probablepeople usaddress sklearn pandas matplotlib lxml jupyter xlrd html5lib csvmatch matplotlib seaborn visidata pyshp coverage freezegun flake8 numpy nltk spacy tabula-py pypdfocr

  • Install some node packages globally (again, you probably won't need all of these installed for every project you do in life, so def take advantage of node's package management workflow to handle project dependencies):

    npm install -g gulp gulp-cli grunt grunt-cli http-server hot-server yo generator-yeogurt

  • R

  • RStudio

  • Install R libraries:

    "tidyverse", "fivethirtyeight", "nycflights", "babynames", "XML", "rtweet", "splines", "gee", "lme4", "nlme", "survival", "Ecdat", "DT", "here", "evaluate", "digest", "highr", "Rcpp", "htmltools", "knitr", "rprojroot", "rmarkdown", "leaflet", "shinycssloaders", "rgdal", "tigris", "packrat"

  • PSPP

Data cleaning, extraction, preparation

Command-line tools

SQL and graph databases

Mapping

Text editors

Misc.

More in-depth installation guides