## BiCM package
This is a Python package for the computation of the maximum entropy bipartite configuration model (BiCM) and the projection of bipartite networks on one layer. It was developed with Python 3.5.
You can install this package via pip:
pip install bicm
Documentation is available at https://bipartite-configuration-model.readthedocs.io/en/latest/ .
This package is also a module of NEMtropy that you can find at https://github.com/nicoloval/NEMtropy .
For more solvers of maximum entropy configuration models visit https://meh.imtlucca.it/ .
NOTE of the developer: there was an error in the projection threshold, validating less links than it should have.
Please re-run your analysis after updating to the last version (>=3.1)
## Basic functionalities
To install:
pip install bicm
To import the module:
import bicm
To generate a Graph object and initialize it (with a biadjacency matrix, edgelist or degree sequences):
from bicm import BipartiteGraph
myGraph = BipartiteGraph()
myGraph.set_biadjacency_matrix(my_biadjacency_matrix)
myGraph.set_adjacency_list(my_adjacency_list)
myGraph.set_edgelist(my_edgelist)
myGraph.set_degree_sequences((first_degree_sequence, second_degree_sequence))
Or alternatively, with the respective data structure as input:
from bicm import BipartiteGraph
myGraph = BipartiteGraph(biadjacency=my_biadjacency_matrix, adjacency_list=my_adjacency_list, edgelist=my_edgelist, degree_sequences=((first_degree_sequence, second_degree_sequence)))
To compute the BiCM probability matrix of the graph or the relative fitnesses coefficients as dictionaries containing the nodes names as keys:
my_probability_matrix = myGraph.get_bicm_matrix()
my_x, my_y = myGraph.get_bicm_fitnesses()
This will solve the bicm using recommended settings for the solver.
To customize the solver you can alternatively use (in advance) the following method:
myGraph.solve_tool(light_mode=False, method='newton', initial_guess=None, tolerance=1e-8, max_steps=None, verbose=False, linsearch=True, regularise=False, print_error=True, exp=False)
To get the rows or columns projection of the graph:
myGraph.get_rows_projection()
myGraph.get_cols_projection()
Alternatively, to customize the projection:
myGraph.compute_projection(rows=True, alpha=0.05, method='poisson', threads_num=4, progress_bar=True)
Now version 3 is online, and you can use the package with weighted networks as well using the BiWCM models!
See a more detailed walkthrough in **tests/bicm_test** or **tests/biwcm_test** notebooks, or check out the API in the documentation.
## How to cite
If you use the `bicm` module, please cite its location on Github
[https://github.com/mat701/BiCM](https://github.com/mat701/BiCM) and the
original articles [Vallarano2021], [Saracco2015] and [Saracco2017].
If you use the weighted models BiWCM_c or BiMCM you might consider citing also the paper introducing the solvers of this package [Bruno2023].
### References
[Vallarano2021] [N. Vallarano, M. Bruno, E. Marchese, G. Trapani, F. Saracco, T. Squartini, G. Cimini, M. Zanon, Fast and scalable likelihood maximization for Exponential Random Graph Models with local constraints, Nature Scientific Reports](https://doi.org/10.1038/s41598-021-93830-4)
[Bruno2023] [M. Bruno, D. Mazzilli, A. Patelli, T. Squartini, F. Saracco, Inferring comparative advantage via entropy maximization. Journal of Physics: Complexity, Volume 4, Number 4 (2023)](https://doi.org/10.1088/2632-072X/ad1411)
[Saracco2015] [F. Saracco, R. Di Clemente, A. Gabrielli, T. Squartini, Randomizing bipartite networks: the case of the World Trade Web, Scientific Reports 5, 10595 (2015)](http://www.nature.com/articles/srep10595).
[Saracco2017] [F. Saracco, M. J. Straka, R. Di Clemente, A. Gabrielli, G. Caldarelli, and T. Squartini, Inferring monopartite projections of bipartite networks: an entropy-based approach, New J. Phys. 19, 053022 (2017)](http://stacks.iop.org/1367-2630/19/i=5/a=053022)
_Author_:
[Matteo Bruno](https://csl.sony.it/member/matteo-bruno/) (BiCM) (a.k.a. [mat701](https://github.com/mat701))
Raw data
{
"_id": null,
"home_page": "https://github.com/mat701/BiCM",
"name": "bicm",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": null,
"keywords": null,
"author": "Matteo Bruno",
"author_email": "matteobruno180@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ce/70/b03813334a9214bc3b8cb90a3e842b36e34b40c89a0893b7c69d9abe9005/bicm-3.3.0.tar.gz",
"platform": null,
"description": "\ufeff## BiCM package\n\nThis is a Python package for the computation of the maximum entropy bipartite configuration model (BiCM) and the projection of bipartite networks on one layer. It was developed with Python 3.5.\n\nYou can install this package via pip: \n\n pip install bicm\n\nDocumentation is available at https://bipartite-configuration-model.readthedocs.io/en/latest/ .\n\nThis package is also a module of NEMtropy that you can find at https://github.com/nicoloval/NEMtropy .\n\nFor more solvers of maximum entropy configuration models visit https://meh.imtlucca.it/ .\n\nNOTE of the developer: there was an error in the projection threshold, validating less links than it should have.\nPlease re-run your analysis after updating to the last version (>=3.1)\n\n\n## Basic functionalities\n\nTo install:\n \n pip install bicm\n\nTo import the module:\n \n import bicm\n\nTo generate a Graph object and initialize it (with a biadjacency matrix, edgelist or degree sequences):\n \n from bicm import BipartiteGraph\n myGraph = BipartiteGraph()\n myGraph.set_biadjacency_matrix(my_biadjacency_matrix)\n myGraph.set_adjacency_list(my_adjacency_list)\n myGraph.set_edgelist(my_edgelist)\n myGraph.set_degree_sequences((first_degree_sequence, second_degree_sequence))\n\nOr alternatively, with the respective data structure as input:\n \n from bicm import BipartiteGraph\n myGraph = BipartiteGraph(biadjacency=my_biadjacency_matrix, adjacency_list=my_adjacency_list, edgelist=my_edgelist, degree_sequences=((first_degree_sequence, second_degree_sequence)))\n\nTo compute the BiCM probability matrix of the graph or the relative fitnesses coefficients as dictionaries containing the nodes names as keys:\n\n my_probability_matrix = myGraph.get_bicm_matrix()\n my_x, my_y = myGraph.get_bicm_fitnesses()\n\nThis will solve the bicm using recommended settings for the solver. \nTo customize the solver you can alternatively use (in advance) the following method:\n \n myGraph.solve_tool(light_mode=False, method='newton', initial_guess=None, tolerance=1e-8, max_steps=None, verbose=False, linsearch=True, regularise=False, print_error=True, exp=False)\n\nTo get the rows or columns projection of the graph:\n\n myGraph.get_rows_projection()\n myGraph.get_cols_projection()\n\nAlternatively, to customize the projection:\n\n myGraph.compute_projection(rows=True, alpha=0.05, method='poisson', threads_num=4, progress_bar=True)\n \nNow version 3 is online, and you can use the package with weighted networks as well using the BiWCM models!\n\nSee a more detailed walkthrough in **tests/bicm_test** or **tests/biwcm_test** notebooks, or check out the API in the documentation.\n\n## How to cite\n\nIf you use the `bicm` module, please cite its location on Github\n[https://github.com/mat701/BiCM](https://github.com/mat701/BiCM) and the\noriginal articles [Vallarano2021], [Saracco2015] and [Saracco2017].\n\nIf you use the weighted models BiWCM_c or BiMCM you might consider citing also the paper introducing the solvers of this package [Bruno2023].\n\n### References\n\n[Vallarano2021] [N. Vallarano, M. Bruno, E. Marchese, G. Trapani, F. Saracco, T. Squartini, G. Cimini, M. Zanon, Fast and scalable likelihood maximization for Exponential Random Graph Models with local constraints, Nature Scientific Reports](https://doi.org/10.1038/s41598-021-93830-4)\n\n[Bruno2023] [M. Bruno, D. Mazzilli, A. Patelli, T. Squartini, F. Saracco, Inferring comparative advantage via entropy maximization. Journal of Physics: Complexity, Volume 4, Number 4 (2023)](https://doi.org/10.1088/2632-072X/ad1411)\n\n[Saracco2015] [F. Saracco, R. Di Clemente, A. Gabrielli, T. Squartini, Randomizing bipartite networks: the case of the World Trade Web, Scientific Reports 5, 10595 (2015)](http://www.nature.com/articles/srep10595).\n\n[Saracco2017] [F. Saracco, M. J. Straka, R. Di Clemente, A. Gabrielli, G. Caldarelli, and T. Squartini, Inferring monopartite projections of bipartite networks: an entropy-based approach, New J. Phys. 19, 053022 (2017)](http://stacks.iop.org/1367-2630/19/i=5/a=053022)\n\n\n_Author_:\n\n[Matteo Bruno](https://csl.sony.it/member/matteo-bruno/) (BiCM) (a.k.a. [mat701](https://github.com/mat701))\n",
"bugtrack_url": null,
"license": null,
"summary": "Package for bipartite configuration model",
"version": "3.3.0",
"project_urls": {
"Homepage": "https://github.com/mat701/BiCM"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "726725b82da6ef2a21dc1b7e181e17238b94efee9b42a4bcfe8acea50f49f40b",
"md5": "be50abfd21edc87d0d11ee793770cee0",
"sha256": "61a2ea9224915e7356fdd3ce3e6084c8435bb9119f76dbb42f985c7cf7f3ccdd"
},
"downloads": -1,
"filename": "bicm-3.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "be50abfd21edc87d0d11ee793770cee0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 32750,
"upload_time": "2024-06-20T15:49:36",
"upload_time_iso_8601": "2024-06-20T15:49:36.453126Z",
"url": "https://files.pythonhosted.org/packages/72/67/25b82da6ef2a21dc1b7e181e17238b94efee9b42a4bcfe8acea50f49f40b/bicm-3.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ce70b03813334a9214bc3b8cb90a3e842b36e34b40c89a0893b7c69d9abe9005",
"md5": "c84d6c473bd9640834dba33bd46da6f6",
"sha256": "0cce195a3a65e4c1b933d59f007d15bed16900203a16dc25f23cbcba08958560"
},
"downloads": -1,
"filename": "bicm-3.3.0.tar.gz",
"has_sig": false,
"md5_digest": "c84d6c473bd9640834dba33bd46da6f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 32733,
"upload_time": "2024-06-20T15:49:39",
"upload_time_iso_8601": "2024-06-20T15:49:39.954728Z",
"url": "https://files.pythonhosted.org/packages/ce/70/b03813334a9214bc3b8cb90a3e842b36e34b40c89a0893b7c69d9abe9005/bicm-3.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-20 15:49:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mat701",
"github_project": "BiCM",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": [
[
"~=",
"1.20.1"
]
]
},
{
"name": "scipy",
"specs": [
[
"~=",
"1.6.0"
]
]
},
{
"name": "tqdm",
"specs": [
[
"~=",
"4.56.0"
]
]
},
{
"name": "numba",
"specs": [
[
"~=",
"0.52.0"
]
]
},
{
"name": "setuptools",
"specs": [
[
"~=",
"53.0.0"
]
]
}
],
"lcname": "bicm"
}
JSON
