{"id":40038140,"url":"https://github.com/caleydo/coral_product","last_synced_at":"2026-01-19T05:01:36.332Z","repository":{"id":38315130,"uuid":"362496421","full_name":"Caleydo/coral_product","owner":"Caleydo","description":"Cohort Analysis App with public gene/tissue/cell line data.","archived":false,"fork":false,"pushed_at":"2023-09-25T08:50:43.000Z","size":101,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-07T11:43:03.437Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Caleydo.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,"governance":null}},"created_at":"2021-04-28T14:24:56.000Z","updated_at":"2021-12-16T14:37:54.000Z","dependencies_parsed_at":"2023-02-09T15:01:09.034Z","dependency_job_id":"1f135f43-ebcb-40ac-938b-59b9066bed35","html_url":"https://github.com/Caleydo/coral_product","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Caleydo/coral_product","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caleydo%2Fcoral_product","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caleydo%2Fcoral_product/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caleydo%2Fcoral_product/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caleydo%2Fcoral_product/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Caleydo","download_url":"https://codeload.github.com/Caleydo/coral_product/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caleydo%2Fcoral_product/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28561842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T03:31:16.861Z","status":"ssl_error","status_checked_at":"2026-01-19T03:31:15.069Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":"2026-01-19T05:01:35.830Z","updated_at":"2026-01-19T05:01:36.326Z","avatar_url":"https://github.com/Caleydo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"coral_product [![Phovea][phovea-image]][phovea-url]\n=====================\n\nCoral is a web-based visual analysis tool for creating and characterizing cohorts.  \nThis repository described how to setup a Coral instance. Please have a look into the [Coral repository](https://github.com/Caleydo/coral) for more information on Coral.\n\n---\n\nCoral is based on the [Target Discovery Platform](https://github.com/datavisyn/tdp_core) and [Phovea framework](http://phovea.caleydo.org/), runs the backend with [Phovea Server](https://github.com/phovea/phovea_server), and uses multiple other plugins.\nTo ease the set up process, this repository describes all required components for the front and back end of Coral, as used by the public Coral instances:\n\n| [Coral Branch](https://github.com/Caleydo/coral/branches)          | app                                          | status   |\n|-----------------------|----------------------------------------------|----------|\n| [main](https://github.com/Caleydo/coral)                | https://coral.caleydoapp.org                 | [![CircleCI](https://circleci.com/gh/Caleydo/coral_product.svg?style=svg)](https://circleci.com/gh/Caleydo/coral_product)  |\n| [develop](https://github.com/Caleydo/coral/tree/develop)               | https://coral-daily.caleydoapp.org           | [![CircleCI](https://circleci.com/gh/Caleydo/coral_product/tree/develop.svg?style=svg)](https://circleci.com/gh/Caleydo/coral_product?branch=develop)  |\n\nA running Coral instance consists of:\n\n* **Frontend** = [Coral](https://github.com/Caleydo/coral) web app, using:\n  * [tdp_core](https://github.com/datavisyn/tdp_core/), as framework with session management, data connectors, and more; see [TDP Documentation](https://wiki.datavisyn.io/tdp/tdp-documentation)\n  * [phovea_clue](https://github.com/phovea/phovea_clue), to track interaction provenance; see [doi:10.1111/cgf.12925](https://dx.doi.org/10.1111/cgf.12925)\n  * [phovea_ui](https://github.com/phovea/phovea_ui), for basic UI components\n  * [phovea_security_flask](https://github.com/phovea/phovea_security_flask), for security and user handling\n  * [phovea_security_store_generated](https://github.com/datavisyn/phovea_security_store_generated), to automatically create dummy users\n\n* **Backend** = [Phovea Server](https://github.com/phovea/phovea_server), a python server using these plugins:\n  * [coral](https://github.com/Caleydo/coral), server side plugin to create cohorts in the database and read their data\n  * [tdp_core](https://github.com/datavisyn/tdp_core/), as framework for db communication\n  * [tdp_publicdb](https://github.com/Caleydo/tdp_publicdb), connector to access the data used in the public Coral instance.\n  * [phovea_security_flask](https://github.com/phovea/phovea_security_flask) and [phovea_security_store_generated](https://github.com/datavisyn/phovea_security_store_generated), again for user handling\n  * [phovea_clue](https://github.com/phovea/phovea_clue), server side part for provenance tracking\n  * [phovea_data_redis](https://github.com/phovea/phovea_data_redis/) and [phovea_data_mongo](https://github.com/phovea/phovea_data_mongo/), as connectors to respective db types\n    * A redis databse  is used for [ID mapping](https://wiki.datavisyn.io/tdp/tdp-documentation#id-management-and-id-mapping)\n    * A mongo database is used to store the provenance and session data\n\n* **Database** = A Postgres database with the data to analyse and where the created cohorts get stored.\n\n:wrench: Setup a Coral workspace\n------------\n\nFollow the steps below the set up a workspace with the above components.\n\n1. Make sure that you meet all the prerequisites described in the [Wiki](https://wiki.datavisyn.io/phovea/development/workspace/general-prerequisites)\n2. The [phovea generator](https://wiki.datavisyn.io/phovea/fundamentals/phovea-yeoman-generator) will check out repositories and setup a workspace for you. Check the [package.json](package.json) for the generator version compatible with this build.\n3. To prepare the workpace, run:\n  ```\n  yo phovea:setup-workspace coral_product -b main\n  ```\n4. Follow the instructions of the generator and Coral will be ready to use.\n5. The database credentials and location are not included in the repositories. Provde them via the `config.jon` file at the root of the workspace:\n\n```json\n {\n \"tdp_publicdb\" : {\n   \"dburl\": \"postgresql://read_user:password@postgres.db.url/database_name\"\n  },\n  \"coral\": {\n    \"dburl\": \"postgresql://read_write_user:password@postgres.db.url/database_name\"\n  }\n}\n```\n\nThat's it! 🎉  \nFor any questions or problems, wirte us an email to coral@caleydo.org or [create an issue on GitHub](https://github.com/Caleydo/coral/issues).\n\n:arrow_up_small: Update the Coral workspace\n------------\n\nUpdating an exisiting workspace is a straight forward process:\n\n1. Fetch the latest commits from the repositories in your workspace. There is a `forEach` script to ease the process. Run: `./forEach git pull`\n2. Incorporate possible changes into the workspace: `yo phovea:update`\n3. If necessary, update npm dependencies : `npm install`\n4. Restart Docker and webpack builds.\n\n***\n\nThis repository is part of **[Phovea](http://phovea.caleydo.org/)**, a platform for developing web-based visualization applications.\n\n\u003ca href=\"https://caleydo.org\"\u003e\u003cimg src=\"http://caleydo.org/assets/images/logos/caleydo.svg\" align=\"left\" width=\"200px\" hspace=\"10\" vspace=\"6\"\u003e\u003c/a\u003e\nFor tutorials, API docs, and more information about the build and deployment process, see the [documentation page](http://phovea.caleydo.org).\n\n\n[phovea-image]: https://img.shields.io/badge/Phovea-Product-FABC15.svg\n[phovea-url]: https://phovea.caleydo.org\n[npm-image]: https://badge.fury.io/js/coral_product.svg\n[npm-url]: https://npmjs.org/package/coral_product\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaleydo%2Fcoral_product","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaleydo%2Fcoral_product","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaleydo%2Fcoral_product/lists"}