- FTU User Interface (FTU)
- Production: https://apps.humanatlas.io/ftu-explorer/
- Staging: https://hra-ui.netlify.app/apps/ftu-ui/
For more information about the Human Reference Atlas (HRA) and the Functional Tissue Unit Explorer (FTU), see the HuBMAP HRA Portal at https://humanatlas.io.
See the ChangeLog for the latest developments.
This software is developed by the Cyberinfrastructure for Network Science Center at Indiana University.
The CCF ASCT Reporter is a basic visualization tool for displaying the flattened ASCT tables built using Angular 10.
The CCF ASCT+B Reporter includes a partonomy tree that presents relationships between various anatomical structures and substructures, that is combined with their respective cell types and biomarkers via a bimodal network. The reporter also presents an indented list tree for a more traditional look. Along with visualizing, the reporter has a report generator that enlists various meta data for the visualized ASCT table, which is download-able. There is also an in-house debug logger that lists any issues related to the data provided in the table. The reporter is also accompanied by a backend server, ASCT+B API.
- Production Site: https://hubmapconsortium.github.io/ccf-asct-reporter/ (staging)
- Documentation: https://hubmapconsortium.github.io/ccf-asct-reporter/docs (staging)
- ASCT+B API: https://apps.humanatlas.io/asctb-api/ (staging)
- Change Log: CHANGELOG.md
$ git clone https://github.com/hubmapconsortium/ccf-asct-reporter
$ cd ccf-asct-reporter
# Reporter
$ npm install
$ ng serve
# linting
$ ng lint
# API
$ cd asctb-api
$ npm install
$ npm start # default port is 5000
# linting
$ npm run lint
$ npm run lint-fixDeployment is accomplished via GitHub Actions based on the branch. The main branch deploys to production (both the web application and ASCT+B API server) and develop deploys to staging.
Below are a list of ASCT+B tables supported by the Reporter:
- Bone Marrow & Blood
- Brain
- Heart
- Intestine, Large
- Kidney
- Lung
- Lymph Nodes
- Skin
- Spleen
- Thymus
- Vasculature
- Visualization
- Compare
- Playground
- Indented List
- Report Generator
- Indented List
- Search
- Export
- Visualization Functions
- Visualization Controls
Click here to view the documentation.
The reporter is also accompanied by a backend server ASCT+B API. In the event of Google Sheets blocking requests by the Reporter or any error, the Reporter fetches the data from the ASCT+B API which runs a simple Node script to fetch the data from Google Sheets. By supplying the SheetId and GID to the ASCT+B API, the data from the flattened tables can be retrieved. If for some reason the ASCT+B API also fails to retrieve the data, the Reporter falls to its system cache, which contains a snapshot of the flattened tables.
The Miner can also be used as a stand-alone tool to retrieve the data from the flattened Google sheets. Below is the API that you'll have to use,
https://asctb-api.herokuapp.com/asctb-reporter/<sheetID>/<gid>
This will either return the data, or will return a 500 HTTP code.
Since the ASCT+B API is a dynamic script, Heroku has been used to deploy the server. Heroky is free to use for this usage. Deployment is accomplished via GitHub Actions based on the branch. The main branch deploys to production and develop deploys to staging.
Visualization
Hovering over a node
Clicking on a node
Report
Indented List
Info Sheet
Debug Log
If you'd like to contribute, follow the steps below,
$ git clone https://github.com/hubmapconsortium/ccf-asct-reporter
$ cd ccf-asct-reporter
$ git checkout -b <new_branch_name>Commit the changes to the new feature branch and make a pull request!
- Production URL: https://humanatlas.io/
- Staging URL: https://humanatlas-io.netlify.app/
Steps to update content for pages on humanatlas.io is documented here
Video Tutorial: Steps to update content for pages on humanatlas.io