https://github.com/cumbof/honto

A novel method for assessing and measuring homophily in networks

https://github.com/cumbof/honto

Science Score: 39.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.5%) to scientific vocabulary

Keywords

graphs homophily networks
Last synced: 5 months ago · JSON representation

Repository

A novel method for assessing and measuring homophily in networks

Basic Info
  • Host: GitHub
  • Owner: cumbof
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 147 MB
Statistics
  • Stars: 9
  • Watchers: 2
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Topics
graphs homophily networks
Created almost 4 years ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.md

honto

HOmophily Network TOol

honto is a tool designed for assessing and measuring homophily in networks whose nodes have categorical attributes, namely when the nodes of networks come partitioned into classes.

Homophily evaluation is performed through the comparison between the relative edge density of the subgraphs, induced by each class, and the corresponding expected relative edge density under a null model.

The novelty of our approach consists in prescribing an endogenous null model, namely, the sample space of the null model is built on the input network itself. This allows us to give exact explicit expressions for the z-scores of the relative edge density of each class as well as other related statistics.

Install

The tool is available through pip and conda. Please, use one of the following commands to start working with honto:

```

Install with pip

pip install honto

Install with conda

conda install -c conda-forge honto ```

Please note that honto is also available as a Galaxy tool. It's wrapper is available under the official Galaxy ToolShed at https://toolshed.g2.bx.psu.edu/view/fabio/honto

Usage

Once installed, you can start running honto by specifying some arguments:

honto --input_edges ~/edges.txt \ --input_nodes ~/nodes.txt \ --verbose

List of standard arguments: --input_edges -- Path to the file with the list of edges --input_nodes -- Path to the file with nodes and colors --weight_threshold -- Threshold for considering edges based in their weight --isolated -- Insert isolated nodes --nproc -- Make the computation of the z-scores parallel for singletons --overwrite -- Overwrite results if already exist --verbose -- Print results in real time -v, --version -- Print current honto version and exit

List of arguments for log-transforming z-scores: --log_transform -- Log-transform z-scores --scale_factor -- Rescale z-scores with this constant before log-transforming values --scale_from_one -- Set z-scores to 1 if lower than 1 before log-transforming values

List of arguments for customizing the heatmap --cmap -- Heatmap colormap --vmin -- Min value to anchor the colormap --vmax -- Max value to anchor the colormap --center -- The value at which to center the colormap when plotting divergant data --cbar -- Whether to draw a colorbar

Credits

Please credit our work in your manuscript by citing:

Nicola Apollonio, Daniel Blankenberg, Fabio Cumbo, Paolo G Franciosa, and Daniele Santoni. Evaluating homophily in networks via HONTO (HOmophily Network TOol): a case study of chromosomal interactions in human PPI networks. Bioinformatics, 39(1), 2023, https://doi.org/10.1093/bioinformatics/btac763

Nicola Apollonio, Paolo G Franciosa, and Daniele Santoni. A novel method for assessing and measuring homophily in networks through second-order statistics. Scientific reports, 12(1):118, 2022, https://doi.org/10.1038/s41598-022-12710-7

Contributing

Long-term discussion and bug reports are maintained via GitHub Issues, while code review is managed via GitHub Pull Requests.

Please, (i) be sure that there are no existing issues/PR concerning the same bug or improvement before opening a new issue/PR; (ii) write a clear and concise description of what the bug/PR is about; (iii) specifying the list of steps to reproduce the behavior in addition to versions and other technical details is highly recommended.

Owner

  • Name: Fabio Cumbo
  • Login: cumbof
  • Kind: user
  • Location: Cleveland, OH, USA
  • Company: Genomic Medicine Institute, Lerner Research Institute, Cleveland Clinic

Ph.D. in Computer Science and Automation Engineering, Postdoctoral Research Fellow @BlankenbergLab, GMI, LRI, Cleveland Clinic, USA

GitHub Events

Total
  • Push event: 1
Last Year
  • Push event: 1

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 35
  • Total Committers: 2
  • Avg Commits per committer: 17.5
  • Development Distribution Score (DDS): 0.057
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
fabio-cumbo f****o@g****m 33
paolofranciosa 5****a 2

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 5 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 2
  • Total maintainers: 1
pypi.org: honto

A novel method for assessing and measuring homophily in networks

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 5 Last month
Rankings
Dependent packages count: 10.1%
Dependent repos count: 21.6%
Stargazers count: 23.1%
Forks count: 29.8%
Average: 32.2%
Downloads: 76.6%
Maintainers (1)
Last synced: 6 months ago

Dependencies

requirements.txt pypi
  • matplotlib >=3.5.2
  • networkx >=2.8
  • pandas >=1.0.1
  • seaborn >=0.11.2
  • tqdm >=4.38.0
setup.py pypi
  • matplotlib *
  • networkx *
  • pandas *
  • seaborn *
  • tqdm *