{"id":21842777,"url":"https://github.com/davidemiceli/basic-influence-roles","last_synced_at":"2025-03-21T16:15:13.150Z","repository":{"id":227220657,"uuid":"769627833","full_name":"davidemiceli/basic-influence-roles","owner":"davidemiceli","description":"Detect and measure the Basic Influence Role each node plays in a Directed Network.","archived":false,"fork":false,"pushed_at":"2024-03-22T07:23:37.000Z","size":893,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-23T13:37:21.115Z","etag":null,"topics":["clustering","complex-networks","data-science","graph-algorithms","graph-theory","network-analysis","network-science","social-network-analysis","social-sciences"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidemiceli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-09T15:59:35.000Z","updated_at":"2024-03-16T11:54:26.000Z","dependencies_parsed_at":"2024-11-27T22:13:17.743Z","dependency_job_id":"9dd74f88-6175-4ad0-b30d-11dfe923be64","html_url":"https://github.com/davidemiceli/basic-influence-roles","commit_stats":null,"previous_names":["davidemiceli/basic-influence-roles"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidemiceli%2Fbasic-influence-roles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidemiceli%2Fbasic-influence-roles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidemiceli%2Fbasic-influence-roles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidemiceli%2Fbasic-influence-roles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidemiceli","download_url":"https://codeload.github.com/davidemiceli/basic-influence-roles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244825654,"owners_count":20516592,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clustering","complex-networks","data-science","graph-algorithms","graph-theory","network-analysis","network-science","social-network-analysis","social-sciences"],"created_at":"2024-11-27T22:13:06.683Z","updated_at":"2025-03-21T16:15:13.123Z","avatar_url":"https://github.com/davidemiceli.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Basic Influence Roles (BIRs) \u0026middot; [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/davidemiceli/basic-influence-roles/blob/master/LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/davidemiceli/basic-influence-roles/pulls)\n\n_**A deterministic scalable algorithm to detect and measure the basic influence role each node plays within a directed network.**_\n\nEvery node plays a certain role in the network and affects the other nodes in its own different way.\nGiven a large dataset of nodes as input, the algorithm provides:\n- A ranking of all nodes by influence score\n- The typology of influence, the basic influence role\n- The influence measure based on influence role\n- The level (the role's subcategory based on influence measure)\n- An influence score based on generic indegree and outdegree\n\nThe algorithm is implemented in the following programming languages:\n- [**Python**](/python)\n- [**JavaScript**](/javascript)\n\n## Basic Influence Roles (BIRs)\n\nWe have six basic influence roles summarized below.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"figs/roles.svg\" width=\"600\"\u003e\n\u003c/p\u003e\n\nRole | Description | Levels\n--- | --- | --- |\n`Emitter` | A node that spreads information without receiving. | `branch`, `weak`, `strong`, `top`\n`Amplifier` | A node with significantly more outgoing connections than incoming ones. | `weak`, `strong`, `top`\n`Hub` | A node balanced as production and reception of information. | `branch`, `weak`, `strong`, `top`\n`Reducer` | A node with significantly more incoming connections than outcoming ones | `weak`, `strong`, `top`\n`Receiver` | A node which receives only interactions, but does not produce any. | `branch`, `weak`, `strong`, `top`\n`Isolated` | A totally non-participatory (or totally disconnected) node | `none`\n\n## BIRs' Levels\n\nThe levels of BIRs are subcategories based on the influence magnitude of every role. Below we have the description of every level and a graph representation of the branch nodes.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"figs/branch-roles.svg\" width=\"400\"\u003e\n\u003c/p\u003e\n\nLevel | Description\n--- | --- |\n`None` | A total absence of influence.\n`Branch` | The lowest influence related to a given role.\n`Weak` | A weak role influence.\n`Strong` | A strong role influence.\n`Top` | The greatest influence related to a given role.\n\n## BIRs' Influence Measure\n\nInfluence measure is a normalized value to quantify the magnitude of influence for each role.\n\n## Research Notebooks\n\nFor reliability aims, we provide two research notebooks, that can be also useful as examples, under the folder [`/research-notebooks`](/research-notebooks), to test the algorithm behavior across both static and dynamic network structures using synthetic datasets.\n\n## Citing\n\nIf you use this software in your work, please cite it as below:\n\n\u003e Miceli, D. (2024). Basic Influence Roles (BIRs) [Computer software]. https://github.com/davidemiceli/basic-influence-roles\n\nOr the BibTeX version:\n\n```bibtex\n@software{MiceliBasicInfluenceRoles2024,\n  author = {Miceli, Davide},\n  license = {MIT},\n  month = mar,\n  title = {{Basic Influence Roles (BIRs)}},\n  url = {https://github.com/davidemiceli/basic-influence-roles},\n  year = {2024}\n}\n```\n\n## License\n\nBasic Influence Roles is an open source project available under the [MIT license](https://github.com/davidemiceli/basic-influence-roles/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidemiceli%2Fbasic-influence-roles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidemiceli%2Fbasic-influence-roles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidemiceli%2Fbasic-influence-roles/lists"}