Replication
Follow the steps below to install the Linguistomics Repository on your computer.
Download and install GitHub Desktop
•
Click here to go to the GitHub
Download Page
.
•
Follow the instructions for installing GitHub Desktop on your computer.
Clone repo
Open GitHub Desktop and choose "File..Clone Repository..." from the menu bar.
Clone a repository
GitHub.com
GitHub Enterprise
URL
Repository URL or GitHub username and repository
https://github.com/jhuelsenbeck/Linguistomics
Local Path
Documents/Linguistomics
Choose...
Clone
Cancel
Input names
•
Type the url of the repository on GitHub.
•
Type the name of the folder on your computer where you want the repository to be stored. If
you change this folder, remember it, because you will need it in a later step.
•
Click "Clone" and wait for the repo to download.
Download and install Nytril
•
Click here to go to
Nytril.com
.
•
Click "Download" at the top of the page.
•
Choose your platform and download the installer.
•
Run and Complete the installation
Nytril Development Environment
Welcome to Nytril Setup
Setup will guide you through the
installation of Nytril.
Click Next to continue.
Next
Cancel
Run Nytril Desktop
•
On a Mac, the Nytril icon will be in your Applications folder
•
On Windows, the icon will be on the desktop.
Nytril Development Environment
File
Edit
View
Git
Build
Repo
Project
Documents
Data
Device
Help
Open Linguistomics Repo
•
Choose File..Open..Repository...
•
The Local Folder should be set to the repo download folder from step 2.
•
Cllck OK.
Open Repo
Local Folder
Documents/Linguistomics
(from step 2)
Repository Name
Linguistomics
OK
Cancel
Open the "Paper" Project
•
The following dialog box will appear.
•
Input the text as shown and cllck OK.
Open Project
Existing Main File
Nytril/Main
Name
Papers
OK
Cancel
Open the "Create Data Files" Project
•
Select "File..Open..Project".
•
Input the text as shown and cllck OK.
Open Project
Existing Main File
Nytril/Create Data Files
Name
Create Data Files
OK
Cancel
Using the two projects
Now that the installation is complete, you can review the documents inside each project. There are 2
projects in the Linguistomics repo that comprise the two main stages of the experiment. You can see
these by clicking on the "Projects" menu. Choosing a project reloads all the source files and documents
to the way that they were the last time you viewed that project, so you can switch back and forth
between the two, without losing your way.
A handy feature of this environment is that by holding down the Ctrl-key and clicking anything in the
document, you will be taken to the source of the information in the left-hand pane. Holding down
Ctrl-Shift and hovering over an element shows its layout lines. Ctrl-Shift-Click on a diagram to see how
the diagram was created in code.
The two projects are:
•
Create Data Files
This project uses the raw cognate words and segment definitions to build the data files for the
MCMC part of the experiment. There are 4 docments in this project:
1
Diagnostics
Shows the raw data from the data files in a variety of ways in order to allow the
researcher to find mistakes in the data.
2
Create Experiment Files
A control panel with a button that triggers the creation of the experiment files from the
raw cognate data. Use this button when the raw data changes and you want to re-run
the whole experiment.
3
Configuration File
Shows the JSON file that is used to initialize the TongueTwister program.
4
Word File
A copy of the raw data for an experiment.
•
Papers
This contains the result of the completed experiment.
1
Paper JOLE
Shows the finished manuscript.
2
Supplemental
Extra narrative, equations and figures that did not fit into the main paper.
If you have trouble with any of these steps, send an email to
Shawn
and he will walk you through any
trouble spots.