adds a MacInstallNotes file and links it to the README
This commit is contained in:
66
MacInstallNotes
Normal file
66
MacInstallNotes
Normal file
@@ -0,0 +1,66 @@
|
||||
|
||||
Purpose
|
||||
=======
|
||||
This document is what I'd call a "ridealong" -- it's intended a quick
|
||||
repository of observations and hints that I kept as annotation to the project
|
||||
README and install guides I found online. It's not a substitute for your own
|
||||
research and good judgment. That said, I found the whole process relatively
|
||||
straightforward, so the other purpose here is to encourage Mac users to just
|
||||
give it a try.
|
||||
|
||||
Software Setup
|
||||
===================
|
||||
|
||||
- Python and R
|
||||
I initially thought I would use my IDEs (R Studio and Spyder via Anaconda) for
|
||||
a lot of this project, but it turned out that command line was the easier way
|
||||
to go when running the python scripts.
|
||||
|
||||
- iGraph. I installed this as part of all the python lib installs rather than
|
||||
dealing with it standalone. It's "python-igraph" in that case.
|
||||
|
||||
- Python libraries install. These were almost all present in Spyder/Anaconda,
|
||||
except for python-igraph and sklearn. Just calling install didn't work, so I
|
||||
ended up installing them via pip -- conda didn't work. Here's an interesting
|
||||
link about conda vs pip:
|
||||
https://jakevdp.github.io/blog/2017/12/05/installing-python-packages-from-jupyter/
|
||||
Later on, I ended up installing homebrew package manager to get the final
|
||||
make to work -- I could've probably saved a bit of time by installing it
|
||||
earlier.
|
||||
|
||||
- R libraries install. This worked fine from inside R studio, but later in
|
||||
the process I ended up using Terminal to run the scripts from the chapter
|
||||
build process itself.
|
||||
|
||||
Data Cleaning
|
||||
===============
|
||||
I copy-pasted all these commands into Terminal, and they just worked. Yay.
|
||||
|
||||
Running Analyses
|
||||
================
|
||||
To get infomap, I had to clone with:
|
||||
git clone http://github.com/mapequation/infomap
|
||||
|
||||
My old Macbook Air handled the computational load just fine, so don't be scared
|
||||
about the memory warnings in the general README.
|
||||
|
||||
The Gephi analysis did run forever (I didn't stay up long enough to watch it
|
||||
do its thing, if you want to know what kind of forever I mean), but it stopped
|
||||
actually updating or changing after a while. Just hit stop when the rainbow
|
||||
jelly ball starts trembling instead of really moving around. I never did get
|
||||
it to look like the one in the paper TBH but I took that to be aesthetic.
|
||||
|
||||
Chapter-Building
|
||||
================
|
||||
Here's where I found I needed to install homebrew, so that I could install all
|
||||
the moreutils (sponge!) and run the compile.
|
||||
|
||||
The LateX build process spit out a ton of errors -- not just the usual whining
|
||||
about underfull hbox badness, but also stopping on various reference compiling
|
||||
errors. Never fear: if you page through them, it'll work in the end.
|
||||
|
||||
And done!
|
||||
-Kaylea Champion
|
||||
2.23.2018
|
||||
kaylea@uw.edu
|
||||
|
||||
Reference in New Issue
Block a user