{"id":17658819,"url":"https://github.com/volfpeter/uspto-patent-citation-graph","last_synced_at":"2025-05-07T13:44:08.768Z","repository":{"id":47134731,"uuid":"241940394","full_name":"volfpeter/uspto-patent-citation-graph","owner":"volfpeter","description":"Graph that downloads patent citation data from USPTO's PatentsView API on-demand and stores it locally in an SQL database (and in memory) for fast access later.","archived":false,"fork":false,"pushed_at":"2023-07-26T07:21:32.000Z","size":14,"stargazers_count":13,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-31T10:42:23.649Z","etag":null,"topics":["citation-network","database","graph","patent","patents","patentsview","patentsview-api","sql","sqlalchemy","uspto"],"latest_commit_sha":null,"homepage":null,"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/volfpeter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-20T17:00:31.000Z","updated_at":"2025-03-28T15:54:58.000Z","dependencies_parsed_at":"2023-01-24T21:45:47.463Z","dependency_job_id":null,"html_url":"https://github.com/volfpeter/uspto-patent-citation-graph","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volfpeter%2Fuspto-patent-citation-graph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volfpeter%2Fuspto-patent-citation-graph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volfpeter%2Fuspto-patent-citation-graph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volfpeter%2Fuspto-patent-citation-graph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/volfpeter","download_url":"https://codeload.github.com/volfpeter/uspto-patent-citation-graph/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251860978,"owners_count":21655836,"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":["citation-network","database","graph","patent","patents","patentsview","patentsview-api","sql","sqlalchemy","uspto"],"created_at":"2024-10-23T15:43:23.372Z","updated_at":"2025-05-07T13:44:08.716Z","avatar_url":"https://github.com/volfpeter.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# USPTO-patent-citation-graph\n\nGraph that downloads patent citation data from USPTO's [PatentsView](https://www.patentsview.org) API on-demand and stores it locally in an SQL database (and in memory) for fast access later.\n\nThe project is based on the [graphscraper](https://pypi.org/project/graphscraper/) project, please see that project for the details of the graph API.\n\n## Installation\n\nInstall the latest version of the project from the Python Package Index using `pip install uspto-patent-citation-graph`.\n\n## Getting started\n\nCreating a graph instance that will use a default, on-disk SQLite database:\n\n```Python\nfrom uspto_patent_citation_graph import USPTOPatentCitationGraph\n\ngraph = USPTOPatentCitationGraph(None)\n```\n\nLoading a node that is not in the local database yet:\n\n```Python\n# `can_validate_and_load=True` tells the graph's node list that it is allowed to\n# load data from the PatentsView API. Its default value is `False`, and the\n# argument can be omitted if the given patent is already in the local database.\npatent_number = \"4733665\"  # Stent patent\nstent_patent = graph.nodes.get_node_by_name(patent_number, can_validate_and_load=True)\n```\n\nAccessing a node's neighbors (cited and cited-by patents):\n\n```Python\nprint(f\"Neighbors of {stent_patent.name}:\")\nfor neighbor in stent_patent.neighbors:\n    print(f\" - {neighbor.name}: {neighbor.external_id}\")\n```\n\n## Related projects\n\nYou can find related projects here:\n\n- [graphscraper](https://github.com/volfpeter/graphscraper)\n- [localclustering](https://github.com/volfpeter/localclustering)\n\n## Community guidelines\n\nAny form of constructive contribution is welcome:\n\n- Questions, feedback, bug reports: please open an issue in the issue tracker of the project or contact the repository owner by email, whichever you feel appropriate.\n- Contribution to the software: please open an issue in the issue tracker of the project that describes the changes you would like to make to the software and open a pull request with the changes. The description of the pull request must references the corresponding issue.\n\nThe following types of contribution are especially appreciated:\n\n## License - MIT\n\nThe library is open-sourced under the conditions of the [MIT license](https://choosealicense.com/licenses/mit/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolfpeter%2Fuspto-patent-citation-graph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolfpeter%2Fuspto-patent-citation-graph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolfpeter%2Fuspto-patent-citation-graph/lists"}