{"id":22794829,"url":"https://github.com/menchelab/cartographs_app","last_synced_at":"2026-03-03T05:40:36.068Z","repository":{"id":48413963,"uuid":"305842051","full_name":"menchelab/cartoGRAPHs_app","owner":"menchelab","description":"A webbased visualization framework for networks.","archived":false,"fork":false,"pushed_at":"2023-10-22T20:07:08.000Z","size":116528,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-20T01:16:55.517Z","etag":null,"topics":[],"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/menchelab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-20T21:52:25.000Z","updated_at":"2025-03-06T06:38:05.000Z","dependencies_parsed_at":"2024-12-12T04:20:41.816Z","dependency_job_id":null,"html_url":"https://github.com/menchelab/cartoGRAPHs_app","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/menchelab/cartoGRAPHs_app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/menchelab%2FcartoGRAPHs_app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/menchelab%2FcartoGRAPHs_app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/menchelab%2FcartoGRAPHs_app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/menchelab%2FcartoGRAPHs_app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/menchelab","download_url":"https://codeload.github.com/menchelab/cartoGRAPHs_app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/menchelab%2FcartoGRAPHs_app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30033499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T05:09:26.876Z","status":"ssl_error","status_checked_at":"2026-03-03T05:09:23.944Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-12-12T04:10:34.274Z","updated_at":"2026-03-03T05:40:36.050Z","avatar_url":"https://github.com/menchelab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![webapplication](cartoGRAPHs_app/img/theapp_cube.png)\n\n# cartoGRAPHs WEB APPLICATION\n\nThis repository is part of the project *menchelab/cartoGRAPHs* and contains the code for the web-based network visualization framework complementing the manuscript \"Network cartoGRAPHs for Interpretable Visualizations\". \n\n---\n\n## A BASIC INTRODUCTION \n\nThe Web application can be accessed [here](http://cartographs.xyz/) \nTo explore different network layouts, we provide a model network of a cube lattice. The app is divided into sections, indicating the different steps of usage. \n\n#### STEP 1 - FILE UPLOAD\nTo generate layouts for a selected graph, please upload a graph edge list and a feature matrix. File requirements and structure can be found in the next section. \nFind an example file of an edge list [here](input/zacharygraph_edgelist.txt) and a feature matrix [here](input/zacharygraph_featurematrix.csv).  \n\n#### STEP 2+3 - CHOOSE LAYOUT / MAP\nChoose a network layout and a map in the dropdowns. To update the visualization, click on the button \"DRAW LAYOUT\". \nFor more information on the individual layouts, please check out our manuscript and the github repo \n\n#### STEP 4 - MODIFY VISUAL SETTINGS\nIn this section, the node size, link size and transparency can be modified and adapted individually. \nTo update the settings, again click on \"DRAW LAYOUT\".\n\n#### STEP 5 - DOWNLOADS\nThe layouts can be downloaded the following: \n+ visualization (html)\n+ table (csv) for the VRNetzer Platform (Pirch et al., Nat. Comm. 2021)\n+ 3D model (obj) to be used for with our 3D printing extension in blender (see further instructions below)\n+ cytoscape graph (xgmml)\n\n---\n\n## FILE STRUCTURE / FILE INPUT REQUIREMENTS\n\nWe provide four different graphs to test and get familiar with different layouts and maps.  \nPlease find one edgelist and one feature matrix per graph [here](cartoGRAPHs_app/input).  \n\nThe files look like the following:  \nThe edgelist should be a .txt file with one graph edge per line, i.e. nodeID1 nodeID2.  \nFind an example [here](cartoGRAPHs_app/img/edgelist.png).  \n\nThe feature matrix is the basis for the functional layout and can contain any feature per node. \nThe data should be stored in a dataframe and saved as a .csv file. It should include node IDs as strings in the first column and one feature per additional column.\nFind an example [here](cartoGRAPHs_app/img/features.png).  \n\nPlease make sure that node IDs match both files, when producing your own graph files. \nThe feature matrix is not required to include all nodes in the graph, but only the nodes which are associated to a feature. \n\n---\n\n## FRAMEWORK EXTENSIONS\nHere we introduce options to use the file formats that can be downloaded from the Web application.  \nThe layout table (.csv file) can be uploaded to the VRNetzer Platform to explore it immersively in Virtual Reality.  \nFor more information please check out the [repository](https://github.com/menchelab/VRNetzer) and [publication](https://www.nature.com/articles/s41467-021-22570-w).  \n  \nWe also provide a 3D printable version of a graph. For 3Dprinting we suggest to use an .stl file, which can be generated using our framework extension. \nPlease download an obj file of your graph from the web app and use our blender/python script extension provided [here](cartoGRAPHs_app/3Dprint_extension).\n\nSome background info:   \nBlender is an open-source 3D modeling software with an built-in python interpreter.  \nTo generate a 3Dprintable file from you graph please download blender [here](https://www.blender.org/) and check out the documentation on the python API [here](https://docs.blender.org/api/current/info_overview.html#:~:text=Blender%20has%20an%20embedded%20Python,active%20while%20Blender%20is%20running.\u0026text=Blender%20provides%20its%20Python%20modules,data%2C%20classes%2C%20and%20functions.).  \n\nOpen blender and the provided files and change the filepath and filename to your .obj file and edgelist of your graph.  \nOptionally you can change a scaling factor for node- and link size to influence the final output mesh.  \nThe blender interface looks like the following, with highlighted modifications needed, such as choosing the obj-file and edgelist of your graph.   \n\n![webapplication](cartoGRAPHs_app/img/blender_01.png)\n\n\nSave the mesh as an .stl file and use for example the free [Ultimaker CURA slicer](https://ultimaker.com/software/ultimaker-cura) for slicing to retrieve a 3Dprintable .gcode file to plug into your 3D printer. Happy printing! \n\n---\n\n### COMPUTATION\nDepending on network size (number of nodes and edges), the calculations will take between seconds or up to a few minutes.  \n*Please note that this application is a work in progress and will be frequently updated and improved.*   \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmenchelab%2Fcartographs_app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmenchelab%2Fcartographs_app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmenchelab%2Fcartographs_app/lists"}