{"id":18736688,"url":"https://github.com/digitalslidearchive/dsa_girder_webix_base_viewer","last_synced_at":"2025-11-16T18:30:12.949Z","repository":{"id":142811938,"uuid":"77180837","full_name":"DigitalSlideArchive/dsa_girder_webix_base_viewer","owner":"DigitalSlideArchive","description":"This is a Webix Based Viewing application template for the DSA that uses Girder API","archived":false,"fork":false,"pushed_at":"2019-10-08T18:10:16.000Z","size":12029,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-12-28T16:46:37.389Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DigitalSlideArchive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2016-12-22T22:46:57.000Z","updated_at":"2019-10-08T18:10:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a2d0be1-05f8-42bc-a57e-89f75ad0db76","html_url":"https://github.com/DigitalSlideArchive/dsa_girder_webix_base_viewer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalSlideArchive%2Fdsa_girder_webix_base_viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalSlideArchive%2Fdsa_girder_webix_base_viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalSlideArchive%2Fdsa_girder_webix_base_viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalSlideArchive%2Fdsa_girder_webix_base_viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DigitalSlideArchive","download_url":"https://codeload.github.com/DigitalSlideArchive/dsa_girder_webix_base_viewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239611992,"owners_count":19668274,"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":[],"created_at":"2024-11-07T15:22:08.004Z","updated_at":"2025-11-16T18:30:12.918Z","avatar_url":"https://github.com/DigitalSlideArchive.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"Digital Slide Archive\n=============================\n\nThis version of the Digital Slide Archive (DSA) uses Girder for the backend and Webix UI for the frontend. \nIt also provides two types of UIs that you can set in the app/config.js file. Those UIs are the TCGA UI and the standard\nUI, which I will discuss in more details below. The repo provides the base version for this DSA, but you can also create plugins and widgets\nto add mroe functionalities, which you will find examples of in app/plugins. This keeps the DSA components independent and the code cleaner.\n\nDependencies:\n-----------------------------\nBefore installing the DSA make sure you install the following:\n\n* bower\n\n\nInstallation:\n-----------------------------\nClone the github repo:\n\n`git clone https://github.com/DigitalSlideArchive/dsa_girder_webix_base_viewer.git`\n\ncd into dsa_girder_webix_base_viewer\n\n`cd dsa_girder_webix_base_viewer/web`\n\n### Please note, the default version of NodeJS on Ubuntu 16.04 is quite old, and you will likely have issues installing bower, use the following link to add a Package Repository/PPA that has a more recent version to make installing nodejs (and then bower) easier\n\nhttps://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-16-04\n\nRun bower install\n\n`bower install`\n\nRename app/config.js.example\n\n`mv app/config.js.example app/config.js`\n\nConfigurations:\n------------------------------\nThere are few parameters you need to change in config.js before making the DSA live.\n\n`BASE_URL`: this is the base URL for the Girder API\n\n`COLLECTION_NAME`: collection name (required only if you are using non TCGA data)\n\n`UI`: type of UI. Either **tcga** if you are using TCGA endpoints or **standard** for non-TCGA data/endpoints\n\nDeployment:\n-------------------------------\nDeployment is easy once the installation and configurations are completed. If you are working locally, simply\nopen index.html in the browser. If you are deploying on a server there are two options. The second option is what you should \nuse for production deployment.\n\n#### Option 1: SimpleHTTPServer\nMake sure you are in the `web` directory and run the following command\n\n`python -m SimpleHTTPServer 8000`\n\nYou can use whatever port, 8000 is just for illustration.\n\n#### Option 2: NGINX\nFor this option make you have NGINX installed\n\n`sudo apt-get install nginx`\n\n`cd /etc/nginx/sites-enabled`\n\nOpen the file default in whatever text editor you like and in the server block we need to add the following three lines\n\n```\nlocation /dsa {\n    alias /path/to/dsa_girder_webix_base_viewer/web;\n}\n```\n\nYour server block will look like that\n\n```\nserver {\n    listen 80 default_server;\n    listen [::]:80 default_server ipv6only=on;\n     \n    ...\n    ...\n\n    location /dsa {\n        alias /path/to/dsa_girder_webix_base_viewer/web;\n    }\n}\n```\n\nSave the file and restart NGINX\n\n`sudo service nginx restart`\n\nPoint your browser to http://yourdomain.com/dsa to access the DSA.\n\nPlugins:\n----------------------------\n\n#### Available plugins:\n\nThe following plugins are currenty included in the base DSA:\n\n* **Annotations**: This plugin uses GeoJS to draw annotations on the slide, allows to change opacity, color and stroke for each annotation and delete annotations.\n\n* **Aperio**: loads aperio annotations into a window.\n\n* **Derm**: derm path plugin enables users to review slides using predefined set of questions (designed for Micheal Sargen study)\n\n* **Filters**: filter widget for the slides where you can adjust contrast, brightness, etc.\n\n* **Metadata**: metadata widget to render the TCGA metadata (TCGA ONLY)\n\n* **Pathology Reports**: pathology report widget for TCGA data (TCGA ONLY)\n\n#### Enable plugins:\n\n1. All plugins should be defined in main.js under `paths`\n\n2. Plugins are enabled in app/app.js\n\n3. Enabled plugins should be listed in the require([]) as follows:\n\n```\nrequire([\"routes\", \"aperio\", \"filters\", \"derm\"]);\n```\n\nwhere routes, aperio, etc are plugin names defined in main.js\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalslidearchive%2Fdsa_girder_webix_base_viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalslidearchive%2Fdsa_girder_webix_base_viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalslidearchive%2Fdsa_girder_webix_base_viewer/lists"}