https://github.com/cytoscape/py4cytoscape

Python library for calling Cytoscape Automation via CyREST

https://github.com/cytoscape/py4cytoscape

Science Score: 23.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
  • DOI references
  • Academic publication links
  • Committers with academic emails
    4 of 14 committers (28.6%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.6%) to scientific vocabulary

Keywords

cytoscape cytoscape-interfaces py2cytoscape python workflow workflow-automation
Last synced: 6 months ago · JSON representation

Repository

Python library for calling Cytoscape Automation via CyREST

Basic Info
Statistics
  • Stars: 85
  • Watchers: 30
  • Forks: 15
  • Open Issues: 27
  • Releases: 18
Topics
cytoscape cytoscape-interfaces py2cytoscape python workflow workflow-automation
Created about 6 years ago · Last pushed 7 months ago
Metadata Files
Readme License

README.md

py4cytoscape

This project recreates the R-based RCy3 Cytoscape Automation library as a Python package. The idea is to allow a Cytoscape workflow to be written in one language (R or Python) and translated to another language (Python or R) without having to learn different Cytoscape interfaces. The previous Cytoscape Python interface (Py2Cytoscape) has different features than the Cytoscape R library, and is therefore deprecated.

Additionally, this project attempts to maintain the same function signatures, return values, function implementation and module structure as the RCy3, thereby enabling smooth maintenance and evolution of both RCy3 and py4cytoscape.

This project uses PyCharm because of its excellent code management and debugging features.

Over time, py4cytoscape functionality should match RCy3 functionality. Once that occurs, novel Py2Cytoscape functions will be added to both as appropriate. The official Automation API definition met by both RCy3 and py4cytoscape is here. The API is versioned, and you can see which API version RCy3 or py4cytoscape implements by executing the cytoscapeversioninfo() or cytoscapeVersionInfo() function.

An overall scorecard comparing Py2Cytoscape, RCy3 and py4cytoscape can be found here. Pay close attention to columns E and F, which show how much of RCy3 is reflected in py4cytoscape.

Documentation

To understand the API structure and see calling examples, see the py4cytoscape documentation.

Quick Start

The quickest way to see py4cytoscape in action is via the Overview of py4cytoscape Jupyter-based workflow.

You can avoid installing Python or py4cytoscape by clicking on the Open in Colab button, and running the Python workflow in the Google Cloud, though you will still have to install Cytoscape on your workstation.

You can follow the notes in the Jupyter Notebook as the workflow automates Cytoscape execution.

How to install and test

For an explanation of py4cytoscape installation and testing, see the INSTALL.rst file.

How to learn more about py4cytoscape

A broad set of Cytoscape Automation samples and tutorials is available on the Cytoscape Automation Wiki.

How to configure logging

py4cytoscape logging is based on the Python logging package, which is based on the Java logging framework.

For an explanation of log configuration and use, see the LOGGING.rst file.

How to build and release

py4cytoscape maintainers can build a new release using the process in BUILDING.rst.

How to test

py4cytoscape has extensive test suites. Maintainers can learn more about testing in the TESTING.rst file.

License

py4cytoscape is released under the MIT License (see LICENSE.rst file):

Copyright (c) 2018-2022 The Cytoscape Consortium Barry Demchak <bdemchak@ucsd.edu>

Owner

  • Name: Cytoscape Consortium
  • Login: cytoscape
  • Kind: organization

GitHub Events

Total
  • Create event: 2
  • Release event: 1
  • Issues event: 8
  • Watch event: 14
  • Issue comment event: 45
  • Push event: 12
  • Fork event: 1
Last Year
  • Create event: 2
  • Release event: 1
  • Issues event: 8
  • Watch event: 14
  • Issue comment event: 45
  • Push event: 12
  • Fork event: 1

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 999
  • Total Committers: 14
  • Avg Commits per committer: 71.357
  • Development Distribution Score (DDS): 0.109
Past Year
  • Commits: 23
  • Committers: 2
  • Avg Commits per committer: 11.5
  • Development Distribution Score (DDS): 0.087
Top Committers
Name Email Commits
Barry Demchak i****k@g****m 890
Kozo Nishida k****a@g****m 59
Jorge Boucas J****s@a****e 18
Yihang Xin y****n@L****l 15
xinsg0@gmail.com M****1 4
Chris Churas c****a@g****m 3
GeneCodeSavvy h****9@g****m 2
Yihang Xin y****n@g****u 2
dotasek d****v@g****m 1
Yihang Xin 4****x 1
Kreijstal r****b@t****f 1
Alexander Pico a****o@g****u 1
Yasir Demirtaş t****d@h****m 1
Nils Oberg n****g@i****u 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 106
  • Total pull requests: 40
  • Average time to close issues: 2 months
  • Average time to close pull requests: 9 days
  • Total issue authors: 31
  • Total pull request authors: 12
  • Average comments per issue: 4.13
  • Average comments per pull request: 1.13
  • Merged pull requests: 33
  • Bot issues: 0
  • Bot pull requests: 1
Past Year
  • Issues: 7
  • Pull requests: 4
  • Average time to close issues: 3 days
  • Average time to close pull requests: 2 days
  • Issue authors: 5
  • Pull request authors: 2
  • Average comments per issue: 6.43
  • Average comments per pull request: 2.0
  • Merged pull requests: 4
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • bdemchak (34)
  • gmhhope (12)
  • kozo2 (8)
  • AlexanderPico (6)
  • nilsoberg (5)
  • carissableker (4)
  • jorgeboucas (4)
  • matthiaskoenig (3)
  • tyasird (2)
  • yihangx (2)
  • eirinland (2)
  • mehmetdirenc (1)
  • Jiafi (1)
  • StefanR-github (1)
  • pkrezel (1)
Pull Request Authors
  • kozo2 (22)
  • bdemchak (7)
  • GeneCodeSavvy (6)
  • Kreijstal (2)
  • dependabot[bot] (2)
  • coleslaw481 (2)
  • jorgeboucas (1)
  • szhorvat (1)
  • tyasird (1)
  • nilsoberg2 (1)
  • mikekucera (1)
Top Labels
Issue Labels
enhancement (10) RCy3 Sync (10) bug (9) documentation (3) duplicate (2) good first issue (1) question (1)
Pull Request Labels
dependencies (2) enhancement (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 2,725 last-month
  • Total dependent packages: 3
  • Total dependent repositories: 8
  • Total versions: 21
  • Total maintainers: 1
pypi.org: py4cytoscape

Cytoscape Automation API

  • Versions: 21
  • Dependent Packages: 3
  • Dependent Repositories: 8
  • Downloads: 2,725 Last month
Rankings
Dependent packages count: 2.3%
Dependent repos count: 5.2%
Average: 7.6%
Stargazers count: 9.0%
Forks count: 10.5%
Downloads: 10.9%
Maintainers (1)
Last synced: 6 months ago

Dependencies

doc/requirements.txt pypi
  • backoff *
  • chardet *
  • colorbrewer *
  • colour *
  • decorator *
  • ipykernel *
  • networkx *
  • pandas *
  • python-igraph *
  • requests *
  • sphinx ==3.5.4
  • sphinx_autodoc_typehints *
  • sphinx_rtd_theme *
setup.py pypi
  • backoff *
  • chardet *
  • colorbrewer *
  • colour *
  • decorator *
  • networkx *
  • pandas *
  • python-igraph *
  • requests *