VIMuRe

Latent Network Models to Account for Noisy, Multiply-Reported Social Network Data.

If you use this code please cite this article (preprint).

De Bacco C, Contisciani M, Cardoso-Silva J, Safdari H, Baptista D, Sweet T, Young JG, Koster J, Ross CT, McElreath R, Redhead D. Latent Network Models to Account for Noisy, Multiply-Reported Social Network Data. arXiv preprint arXiv:2112.11396. 2021.

Notebooks

To understand how you could use the code or to replicate our research, check the notebooks folder:

• Notebook 01 - Generate Synthetic Networks
• Notebook 02 - Run Model
• Notebook 03 - Experiment Under and Over Reporters
• Notebook 04 - Karnataka data - Single Run
• Notebook 04 - Karnataka data (Full)
• Notebook 05 - Experiment varying reciprocity
• Notebook 06 - Nicaragua data

Setup

Instructions on how to replicate our research either downloading our package via pip or by using the Docker setup used for developing the package.

Alternative 01: using pip

Install vimure==0.1 with the following command:

pip install git+https://github.com/latentnetworks/vimure.git#egg=vimure\&subdirectory=src/python/

Alternative 02: using Docker

If you are familiar with Docker, you could use the Docker containers provided in this repository. Use this setup if you want to modify anything in the package.

1. Clone the repository to a directory in your machine
2. Install Docker and docker-compose on your machine
3. Open the terminal and build the project:

cd vimure
docker-compose build

The first time you run this build, it will take several minutes to complete. Trust me, it is better to run this and wait the building time than having to install each multiple python dependencies by hand and having to figure out why your colleague gets a weird and mysterious, previously unseen Exception when running the same code as you!

4. Still on the terminal, run Jupyter server with the command:

docker-compose up

A URL will show up on your screen, either click on it or copy-paste to your browser and run the notebooks.

License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.