X-Git-Url: https://code.communitydata.science/social-media-chapter.git/blobdiff_plain/967637e742de5ee2a071352f608cceab83ae3df7..9e0cdeefb742c2c6284195a22e1b7412d43dcbf7:/MacInstallNotes

diff --git a/MacInstallNotes b/MacInstallNotes
new file mode 100644
index 0000000..df6f63f
--- /dev/null
+++ b/MacInstallNotes
@@ -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
+