Skip to content

Latest commit

 

History

History
136 lines (92 loc) · 5.79 KB

README.md

File metadata and controls

136 lines (92 loc) · 5.79 KB
Raw

osparc-simcore platform

Code style: black Requires.io

Github-CI Push/PR coveralls.io codecov.io github.io itis.dockerhub license

The SIM-CORE, named o2S2PARC – Open Online Simulations for Stimulating Peripheral Activity to Relieve Conditions – is one of the three integrative cores of the SPARC program’s Data Resource Center (DRC). The aim of o2S2PARC is to establish a comprehensive, freely accessible, intuitive, and interactive online platform for simulating peripheral nerve system neuromodulation/ stimulation and its impact on organ physiology in a precise and predictive manner. To achieve this, the platform will comprise both state-of-the art and highly detailed animal and human anatomical models with realistic tissue property distributions that make it possible to perform simulations ranging from the molecular scale up to the complexity of the human body.

Getting Started

This is the common workflow to build and deploy locally:

  # clone repo
  git clone https://github.com/ITISFoundation/osparc-simcore.git
  cd osparc-simcore

  # show setup info and build core services
  make info build

  # starts swarm and deploys services
  make up-prod

  # display swarm configuration
  make info-swarm

  # open front-end in the browser
  #  localhost:9081 - simcore front-end site
  #
  xdg-open http://localhost:9081/

  # stops
  make down

Services are deployed in two stacks:simcore-stack comprises all core-services in the framework and ops-stack is a subset of services from ITISFoundation/osparc-ops used for operations during development. This is a representation of simcore-stack:

Requirements

To verify current base OS, Docker and Python build versions have a look at:

To build and run:

  • docker
  • make >=4.2
  • awk, jq (optional tools within makefiles)

To develop, in addition:

  • python 3.6 (this dependency will be deprecated soon)
  • nodejs for client part (this dependency will be deprecated soon)
  • swagger-cli (make sure to have a recent version of nodejs)
  • vscode (highly recommended)

This project works and is developed under linux (Ubuntu recommended).

Setting up Other Operating Systems

When developing on these platforms you are on your own.

In windows, it works under WSL (windows subsystem for linux). Some details on the setup:

In MacOS, replacing the MacOS utilities with GNU utils might be required.

Releases

WARNING This application is still under development.

Contributing

Would you like to make a change or add something new? Please read the contributing guidelines.

License

This project is licensed under the terms of the MIT license.