This repository hosts notebooks, images, and data for the XSwap project. The results of these analyses are described in the manuscript titled:

The probability of edge existence due to node degree: a baseline for network-based predictions

Along with the manuscript, this project produced an open-source implementation of our network permutation algorithm. Available on PyPI as xswap and source on GitHub in hetio/xswap.

The analyses for this repository are performed by sequentially numbered Jupyter notebooks in the nb directory. Data is written to the data directory and figures are exported to the img directory.

The analyses depend on the Hetionet HetMat dataset, which can be downloaded by running the following Python command from this repo's root directory:

from hetmatpy.hetmat.archive import load_archive
load_archive(
    archive_path="https://github.com/hetio/hetionet/raw/b467b8b41087288390b41fdb796577ada9f03bda/hetnet/matrix/hetionet-v1.0.hetmat.zip",
    destination_dir="data/task1/hetionet-v1.0.hetmat",
)

This repository uses conda to manage its environment as specified in environment.yml. Install the environment with:

# install new xswap-analysis environment
conda env create --file=environment.yml
# update existing xswap-analysis environment
conda env update --file=environment.yml
# export the locked environment specification, which lists every package
# installed in the environment including implicit dependencies.
# Includes build numbers and is operating system specific.
conda env export --name=xswap-analysis > environment-lock-linux.yml

Then use conda activate xswap-analysis and conda deactivate to activate or deactivate the environment.

The entire repository is released under a BSD 3-Clause License. Furthermore:

• the contents of the data directory are released under CC0 (public domain dedication).
• the contents of the img directory are released under CC BY 4.0 (public domain dedication). For images that are used in the xswap-manuscript, please attribute this manuscript as the source.