├── gifs └── judgejudy.gif ├── README.md ├── LICENSE └── car18.md /gifs/judgejudy.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ireapps/install-guides/HEAD/gifs/judgejudy.gif -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # IRE/NICAR conference install guides 2 | Set up your computer like we set up the IRE and NICAR conference laptops! 3 | 4 | Install guides for each conference are in a markdown file following the format: `.md`. The guide for NICAR 2018, for instance, lives at `car18.md`. -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2018 IRE/NICAR 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /car18.md: -------------------------------------------------------------------------------- 1 | # NICAR 2018 install guide 2 | 3 | Drop by our [install party](https://www.ire.org/events-and-training/event/3189/3588/) at 10:15 a.m. on Sunday, March 11, in Clark, and we'll help you get your rig set up. 4 | 5 | ![ow wow](gifs/judgejudy.gif "judge judy can't even with this") 6 | 7 | _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.) 8 | 9 | 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](https://github.com/pyenv/pyenv), [pipenv](https://pipenv.readthedocs.io/en/latest/) and [virtualenv](https://virtualenv.pypa.io/en/stable/) (plus, optionally, [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/)). (The conference computers have `virtualenv` and `virtualenvwrapper` available, FWIW.) 10 | 11 | Also, we didn't include instructions for setting up a virtualbox to run the programs used in the ["CAR Throwback" session](https://www.ire.org/events-and-training/event/3189/3666/). (If you really get the urge to party like it's 1998, let us know and we'll hook you up.) 12 | 13 | ## Windows 14 | 15 | ### Spreadsheets and general office software 16 | - [Microsoft Office](https://www.office.com/): Word, Excel, Powerpoint, Access 17 | - [Flash](https://get.adobe.com/flashplayer/) 18 | - [Java](https://java.com/en/download/) 19 | - [VLC Media Player](http://www.videolan.org/vlc/index.html) 20 | 21 | ### Coding and statistics 22 | - [Python 3.6.4](https://www.python.org/downloads/) (Make sure that the "Install launcher for all users" and the "Add Python 3.6 to PATH" checkboxes on the install screen are checked) 23 | - Python packages: 24 | 25 | ```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``` 26 | 27 | - [Node.js 8.9.4](https://nodejs.org/en/download/) 28 | - 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): 29 | 30 | ```npm install -g gulp gulp-cli grunt grunt-cli http-server hot-server yo generator-yeogurt``` 31 | - [R](https://www.r-project.org/) 32 | - [RStudio](https://www.rstudio.com/) 33 | - Install R libraries: 34 | 35 | ```"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"``` 36 | - [PSPP](https://www.gnu.org/software/pspp/) 37 | 38 | ### Web browsers 39 | - [Google Chrome](https://www.google.com/chrome/browser/desktop/) 40 | - [Firefox](https://www.mozilla.org/en-US/firefox/new/) 41 | 42 | ### Text editors 43 | - [Notepad++](https://notepad-plus-plus.org/) 44 | - [Sublime Text](https://sublimetext.com/) 45 | - [atom](https://atom.io/) 46 | 47 | ### Data cleaning, extraction, preparation 48 | - [OpenRefine](http://openrefine.org/) 49 | - [Tabula](http://tabula.technology/) 50 | - [cometdocs desktop app](https://www.cometdocs.com/) 51 | - [The Tableau Reshaper Tool for Excel](https://community.tableau.com/servlet/JiveServlet/download/10394-2-178585/tableau_data_tool.zip) (ZIP) 52 | - Once the file is on your computer, extract the file from the ZIP file and double-click it to install 53 | - Open Excel, click the File tab, click Options, and then click Add-Ins 54 | - From the Manage box, select Excel Add-ins, and then click Go 55 | - In the Add-Ins dialog box, verify the check box next to the Tableau add-in is selected, and click OK 56 | 57 | ### Command-line tools 58 | - [pdftk](https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/) 59 | - [tesseract](https://github.com/UB-Mannheim/tesseract/wiki) 60 | - [ghostscript](https://www.ghostscript.com/) 61 | - [imagemagick](http://imagemagick.org/script/index.php) 62 | - [git](https://gitforwindows.org/) ([setup guide](https://help.github.com/articles/set-up-git/)) 63 | - [xpdf tools](https://xpdfreader-dl.s3.amazonaws.com/XpdfReader-win64-4.00.01.exe) (ZIP) 64 | - Extract the folder to a directory somewhere 65 | - Add the path to the `bin64` folder to the Environmental Variable path: 66 | - Right click on "This PC" 67 | - Click Properties, then Advanced System Settings 68 | - Click Environmental Variables 69 | - Select Path and click Edit 70 | - 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 71 | 72 | ### Mapping 73 | - [QGIS 2.14](http://qgis.org) 74 | - [ArcGIS for Office](https://doc.arcgis.com/en/maps-for-office/install-and-configure/about-esri-maps-for-office.htm) 75 | 76 | ### SQL and graph databases 77 | - [DB Browser for SQLite](http://sqlitebrowser.org/) 78 | - [WAMP](http://www.wampserver.com/en/) 79 | - [Neo4j](https://neo4j.com/) 80 | - Postgres and PgAdmin - check out this [@anthonydb](https://github.com/anthonydb) [installation guide](https://www.dropbox.com/s/bdvs6gglfu6hopv/PostgresWindowsInstallation.pdf?dl=0) 81 | - [MySQL Web Community Installer](https://dev.mysql.com/downloads/installer/) 82 | - Choose the "Developer Default" install option 83 | - It will begin to check for requirements. The requirement for MySQL For Excel is the Microsoft Visual Studio Tools for Office Runtime 2010 setup. 84 | - A screen with a list of the products to be installed will appear. If you see this, press Execute, then Next, then Next 85 | - On the next screen, select Standalone MySQL Server / Classic MySQL Replication 86 | - 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) 87 | - 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. 88 | - 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. 89 | - 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. 90 | - On the next screen, press Execute to apply the configuration. Then click Finish. You’ll be back at the Product Configuration screen. Press Next. 91 | - On the MySQL Router Configuration screen, do not make any selections. Simply click Finish. 92 | - 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. 93 | - Click Next. On the following screen, press Execute. You'll see a screen indicating the Installation is complete. Click Finish. 94 | 95 | ### Misc. 96 | - [MiKTeX](https://miktex.org/) ([follow these instructions](https://miktex.org/howto/install-miktex)) 97 | - [Postman](https://www.getpostman.com/) 98 | - [GIMP](https://gimp.org/) 99 | 100 | 101 | ## Mac 102 | 103 | ### Spreadsheets and general office software 104 | - [Microsoft Office](https://www.office.com/): Word, Excel, Powerpoint 105 | - [Flash](https://get.adobe.com/flashplayer/) 106 | - [Java](https://java.com/en/download/) 107 | - [VLC Media Player](http://www.videolan.org/vlc/index.html) 108 | - [Filezilla](https://filezilla-project.org/) 109 | 110 | ### Web browsers 111 | - [Google Chrome](https://www.google.com/chrome/browser/desktop/) 112 | - [Firefox](https://www.mozilla.org/en-US/firefox/new/) 113 | 114 | ### Coding and statistics 115 | - [Homebrew](https://brew.sh/) -- in your terminal, run: 116 | 117 | ```/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"``` 118 | 119 | - In your terminal, run: `xcode-select --install` 120 | - Brew install python3, git, node, tesseract, xpdf, imagemagick, ghostscript: 121 | 122 | ```brew install python3 git node tesseract xpdf imagemagick ghostscript``` 123 | 124 | - Python packages: 125 | 126 | ```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``` 127 | 128 | - 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): 129 | 130 | ```npm install -g gulp gulp-cli grunt grunt-cli http-server hot-server yo generator-yeogurt``` 131 | - [R](https://www.r-project.org/) 132 | - [RStudio](https://www.rstudio.com/) 133 | - Install R libraries: 134 | 135 | ```"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"``` 136 | - [PSPP](https://www.gnu.org/software/pspp/) 137 | 138 | ### Data cleaning, extraction, preparation 139 | - [Tabula](http://tabula.technology/) 140 | - [OpenRefine](http://openrefine.org/) 141 | 142 | ### Command-line tools 143 | - [pdftk](https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/) 144 | 145 | ### SQL and graph databases 146 | - [Postgres app](http://postgresapp.com/) 147 | - [DB Browser for SQLite](http://sqlitebrowser.org/) 148 | - [Neo4j](https://neo4j.com/) 149 | - [MAMP](https://www.mamp.info/en/) 150 | 151 | ### Mapping 152 | - [QGIS 2.14](http://qgis.org) 153 | 154 | ### Text editors 155 | - [Sublime Text](https://sublimetext.com/) 156 | - [atom](https://atom.io/) 157 | 158 | ### Misc. 159 | - [Postman](https://www.getpostman.com/) 160 | - [MacTeX](http://www.tug.org/mactex/) 161 | - [GIMP](https://gimp.org/) 162 | 163 | ## More in-depth installation guides 164 | 165 | - [NYT: Set up your Mac like an interactive news developer](https://open.nytimes.com/set-up-your-mac-like-an-interactive-news-developer-bb8d2c4097e5) 166 | - [NPR: How to setup your Mac to develop news applications like we do](http://blog.apps.npr.org/2013/06/06/how-to-setup-a-developers-environment.html) 167 | - [The Hitchhiker's Guide to Python](http://docs.python-guide.org/en/latest/) 168 | - [Anthony Debarros: Setting up Python in Windows 10](http://www.anthonydebarros.com/2015/08/16/setting-up-python-in-windows-10/) --------------------------------------------------------------------------------