imaging-server-kit 0.0.8__tar.gz → 0.0.9__tar.gz

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imaging-server-kit
-Version: 0.0.8
+Version: 0.0.9
 Summary: Deploy image processing algorithms in FastAPI servers. 
 Author-email: Mallory Wittwer <mallory.wittwer@epfl.ch>
 License: Copyright (c) 2024, EPFL
@@ -31,8 +31,8 @@ License: Copyright (c) 2024, EPFL
         OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
         OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
         
-Project-URL: homepage, https://imaging-server-kit.github.io/imaging-server-kit
 Project-URL: repository, https://github.com/Imaging-Server-Kit/imaging-server-kit
+Project-URL: documentation, https://imaging-server-kit.github.io/imaging-server-kit
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
@@ -61,6 +61,7 @@ Requires-Dist: jinja2
 Requires-Dist: PyYAML
 Requires-Dist: pydantic>=2.0
 Requires-Dist: cookiecutter
+Requires-Dist: opencv-contrib-python-headless
 Provides-Extra: docs
 Requires-Dist: jupyter-book; extra == "docs"
 Requires-Dist: jupytext; extra == "docs"

imaging_server_kit-0.0.9/docs/index.md

@@ -0,0 +1,50 @@
+# Welcome to the Imaging Server Kit's documentation!
+
+The **Imaging Server Kit** is an open-source Python package for deploying image analysis algorithms as web services.
+
+- Run computations remotely, while client applications remain focused on visualization.
+- Connect to an algorithm server and run algorithms from [QuPath](https://github.com/Imaging-Server-Kit/qupath-extension-serverkit), [Napari](https://github.com/Imaging-Server-Kit/napari-serverkit), and Python.
+
+## Key Features
+
+- Turn standard Python functions into fully-featured image processing web servers with minimal effort.
+
+```python
+@algorithm_server({"image": ImageUI()})
+def segmentation_server(image):
+    segmentation = # your code here
+    return [(segmentation, {}, "mask")]
+```
+
+## Supported image analysis tasks
+
+| Task              | Examples                        | Napari | QuPath |
+|-------------------|---------------------------------| ------ | ------ |
+| Segmentation     | [StarDist](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples/servers/serverkit-stardist), [CellPose](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples/servers/serverkit-cellpose), [Rembg](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples/servers/serverkit-rembg), [SAM-2](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-sam2), [InstanSeg](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-instanseg)               | ✅ | ✅ |
+| Object detection | [Spotiflow](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-spotiflow), [LoG detector](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples/servers/serverkit-skimage-log)    | ✅ | ✅ |
+| Vector fields    | [Orientationpy](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples/servers/serverkit-orientationpy)                   | ✅ | ✅ |
+| Object tracking  | [Trackpy](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples/servers/serverkit-trackpy), [Trackastra]()         | ✅ |  |
+| Image-to-Image   | [SPAM](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-spam), [Noise2Void](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-n2v)         | ✅ |  |
+| Text-to-Image    | [Stable Diffusion](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-stable-diffusion)         | ✅ |  |
+| Image-to-Text    | [Image captioning](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-blip-captioning)         | ✅ |  |
+| Classification   | [ResNet50](https://github.com/Imaging-Server-Kit/extra-examples/tree/main/examples/serverkit-resnet50)         | ✅ |  |
+
+## Installation
+
+Install the `imaging-server-kit` package with `pip`:
+
+```
+pip install imaging-server-kit
+```
+
+or clone the project and install the development version:
+
+```
+git clone https://github.com/Imaging-Server-Kit/imaging-server-kit.git
+cd imaging-server-kit
+pip install -e .
+```
+
+## License
+
+This software is distributed under the terms of the [BSD-3](http://opensource.org/licenses/BSD-3-Clause) license.

imaging_server_kit-0.0.9/examples/servers/serverkit-cellpose/README.md

@@ -0,0 +1,34 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# serverkit-cellpose
+
+Implementation of a web server for [CellPose](https://github.com/MouseLand/cellpose).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.
+
+## Sample images provenance
+
+- `nuclei_2d.tif`: Fluorescence microscopy image and mask from the 2018 kaggle DSB challenge (Caicedo et al. "Nucleus segmentation across imaging experiments: the 2018 Data Science Bowl." Nature methods 16.12).

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/examples/servers/serverkit-cellpose/main.py

@@ -70,7 +70,7 @@ def cellpose_server(
     cellprob_threshold: float,
 ) -> List[tuple]:
     """Runs the algorithm."""
-    model = models.Cellpose(
+    model = models.CellposeModel(
         gpu=False,  # For now
         model_type=model_name,
     )
@@ -81,7 +81,7 @@ def cellpose_server(
             "Diameter is set to None. The size of the cells will be estimated on a per image basis"
         )
 
-    segmentation, flows, styles, diams = model.eval(
+    segmentation, flows, styles = model.eval(
         image,
         diameter=diameter,
         flow_threshold=flow_threshold,

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/examples/servers/serverkit-cellpose/requirements.txt

@@ -3,4 +3,4 @@ cellpose
 torch
 torchvision 
 torchaudio
-opencv-python-headless
+opencv-contrib-python-headless

imaging_server_kit-0.0.9/examples/servers/serverkit-orientationpy/README.md

@@ -0,0 +1,34 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# serverkit-orientationpy
+
+Implementation of a web server for [Orientationpy](https://gitlab.com/epfl-center-for-imaging/orientationpy).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.
+
+## Sample images provenance
+
+- `image1_from_OrientationJ.tif`: Example image from [OrientationJ](https://bigwww.epfl.ch/demo/orientationj/).

imaging_server_kit-0.0.9/examples/servers/serverkit-rembg/README.md

@@ -0,0 +1,30 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# Rembg API in docker
+
+Implementation of a web API server for [rembg](https://github.com/danielgatis/rembg).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.

imaging_server_kit-0.0.9/examples/servers/serverkit-skimage-log/README.md

@@ -0,0 +1,30 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# Scikit-image LoG detector API in docker
+
+Implementation of a web API server for [Scikit Image's LoG detector](https://scikit-image.org/docs/stable/api/skimage.feature.html#skimage.feature.blob_log).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.

imaging_server_kit-0.0.9/examples/servers/serverkit-stardist/README.md

@@ -0,0 +1,34 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# serverkit-stardist
+
+Implementation of a web server for [StarDist (2D)](https://github.com/stardist/stardist).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.
+
+## Sample images provenance
+
+- `nuclei_2d.tif`: Fluorescence microscopy image and mask from the 2018 kaggle DSB challenge (Caicedo et al. "Nucleus segmentation across imaging experiments: the 2018 Data Science Bowl." Nature methods 16.12).

imaging_server_kit-0.0.9/examples/servers/serverkit-stardist/requirements.txt

@@ -0,0 +1,5 @@
+imaging-server-kit
+tensorflow
+stardist
+numpy==1.26.4
+opencv-contrib-python-headless

imaging_server_kit-0.0.9/examples/servers/serverkit-trackpy/README.md

@@ -0,0 +1,33 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# serverkit-trackpy
+
+Implementation of a web server for [Trackpy](https://soft-matter.github.io/trackpy/) (linking only).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.
+## Sample images provenance -->
+
+- `tracks.tif`: Example image from the [Trackmate](https://imagej.net/plugins/trackmate/tutorials/getting-started) getting started guide.

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/pyproject.toml

@@ -36,6 +36,7 @@ dependencies = [
     "PyYAML",
     "pydantic>=2.0",
     "cookiecutter",
+    "opencv-contrib-python-headless",
 ]
 
 [project.optional-dependencies]
@@ -48,8 +49,8 @@ all = ["imaging-server-kit[docs,test,users]"]
 serverkit = "imaging_server_kit.cli:main"
 
 [project.urls]
-homepage = "https://imaging-server-kit.github.io/imaging-server-kit"
 repository = "https://github.com/Imaging-Server-Kit/imaging-server-kit"
+documentation = "https://imaging-server-kit.github.io/imaging-server-kit"
 
 [build-system]
 requires = ["setuptools>=42.0.0", "wheel", "setuptools_scm"]

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/src/imaging_server_kit/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.0.8'
-__version_tuple__ = version_tuple = (0, 0, 8)
+__version__ = version = '0.0.9'
+__version_tuple__ = version_tuple = (0, 0, 9)

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/src/imaging_server_kit/core/decorator.py

@@ -20,6 +20,7 @@ def decode_image_array(cls, v, dimensionality) -> "np.ndarray":
 
     return image_array
 
+# TODO - we could also validate the points or vectors dimensionality
 
 def parse_params(parameters: dict) -> BaseModel:
     fields = {}
@@ -47,7 +48,7 @@ def parse_params(parameters: dict) -> BaseModel:
                 "widget_type"
             ] = param_details.widget_type
 
-            if param_details.widget_type == "image":
+            if param_details.widget_type in ["image", "mask"]:
                 validated_func = partial(
                     decode_image_array, dimensionality=param_details.dimensionality
                 )
@@ -55,7 +56,7 @@ def parse_params(parameters: dict) -> BaseModel:
                 validators[validator_name] = field_validator(param_name, mode="after")(
                     validated_func
                 )
-
+            
             fields[param_name] = (param_details.type, Field(**field_constraints))
 
     return create_model(

imaging_server_kit-0.0.9/src/imaging_server_kit/template/serverkit-{{ cookiecutter.project_slug }}/README.md

@@ -0,0 +1,34 @@
+![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
+# serverkit-{{ cookiecutter.project_slug }}
+
+Implementation of a web server for [{{ cookiecutter.project_name }}]({{ cookiecutter.project_url }}).
+
+## Installing the algorithm server with `pip`
+
+Install dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+Run the server:
+
+```
+python main.py
+```
+
+The server will be running on http://localhost:8000.
+
+## Using `docker-compose`
+
+To build the docker image and run a container for the algorithm server in a single command, use:
+
+```
+docker compose up
+```
+
+The server will be running on http://localhost:8000.
+
+<!-- ## Sample images provenance -->
+
+<!-- Fill if necessary. -->

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/src/imaging_server_kit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imaging-server-kit
-Version: 0.0.8
+Version: 0.0.9
 Summary: Deploy image processing algorithms in FastAPI servers. 
 Author-email: Mallory Wittwer <mallory.wittwer@epfl.ch>
 License: Copyright (c) 2024, EPFL
@@ -31,8 +31,8 @@ License: Copyright (c) 2024, EPFL
         OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
         OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
         
-Project-URL: homepage, https://imaging-server-kit.github.io/imaging-server-kit
 Project-URL: repository, https://github.com/Imaging-Server-Kit/imaging-server-kit
+Project-URL: documentation, https://imaging-server-kit.github.io/imaging-server-kit
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
@@ -61,6 +61,7 @@ Requires-Dist: jinja2
 Requires-Dist: PyYAML
 Requires-Dist: pydantic>=2.0
 Requires-Dist: cookiecutter
+Requires-Dist: opencv-contrib-python-headless
 Provides-Extra: docs
 Requires-Dist: jupyter-book; extra == "docs"
 Requires-Dist: jupytext; extra == "docs"

{imaging_server_kit-0.0.8 → imaging_server_kit-0.0.9}/src/imaging_server_kit.egg-info/requires.txt

@@ -11,6 +11,7 @@ jinja2
 PyYAML
 pydantic>=2.0
 cookiecutter
+opencv-contrib-python-headless
 
 [all]
 imaging-server-kit[docs,test,users]

imaging_server_kit-0.0.8/docs/index.md

@@ -1,54 +0,0 @@
-# Welcome to the Imaging Server Kit's documentation!
-
-The **Imaging Server Kit** is an open-source Python package for deploying image analysis algorithms as web services.
-
-- Run computations remotely, while client applications remain focused on visualization.
-- Connect to an algorithm server and run algorithms from [QuPath](https://github.com/Imaging-Server-Kit/qupath-extension-serverkit), [Napari](https://github.com/Imaging-Server-Kit/napari-serverkit), and Python.
-
-## Key Features
-
-- Turn standard Python functions into fully-featured image processing web servers with minimal effort.
-
-```python
-@algorithm_server({"image": ImageUI()})
-def segmentation_server(image):
-    segmentation = # your code here
-    return [(segmentation, {}, "mask")]
-```
-
-<!-- - Automatically generate UIs in Napari and QuPath to test your tools. -->
-
-## Supported image analysis tasks
-
-| Task              | Examples                        | Napari | QuPath |
-|-------------------|---------------------------------| ------ | ------ |
-| Segmentation     | [StarDist](https://github.com/Imaging-Server-Kit/serverkit-stardist), [CellPose](https://github.com/Imaging-Server-Kit/serverkit-cellpose), [Rembg](https://github.com/Imaging-Server-Kit/serverkit-rembg), [SAM-2](https://github.com/Imaging-Server-Kit/serverkit-sam2), [InstanSeg](https://github.com/Imaging-Server-Kit/serverkit-instanseg)               | ✅ | ✅ |
-| Object detection | [Spotiflow](https://github.com/Imaging-Server-Kit/serverkit-spotiflow), [LoG detector](https://github.com/Imaging-Server-Kit/serverkit-skimage-LoG)    | ✅ | ✅ |
-| Vector fields   | [Orientationpy](https://github.com/Imaging-Server-Kit/serverkit-orientationpy)                   | ✅ | ✅ |
-| Object tracking  | [Trackastra](https://github.com/Imaging-Server-Kit/serverkit-trackastra), [Trackpy](https://github.com/Imaging-Server-Kit/serverkit-trackpy)         | ✅ |  |
-| Image-to-Image  | [SPAM](https://github.com/Imaging-Server-Kit/serverkit-spam), [Noise2Void](https://github.com/Imaging-Server-Kit/serverkit-n2v)         | ✅ |  |
-| Text-to-Image   | [Stable Diffusion](https://github.com/Imaging-Server-Kit/serverkit-stable-diffusion)         | ✅ |  |
-| Image-to-Text   | [Image captioning](https://github.com/Imaging-Server-Kit/serverkit-blip-captioning)         | ✅ |  |
-| Classification   | [ResNet50](https://github.com/Imaging-Server-Kit/serverkit-resnet50)         | ✅ |  |
-
-A gallery of example implementations for commonly used algorithms is available in the [repository](https://github.com/Imaging-Server-Kit/imaging-server-kit/tree/main/examples).
-
-## Installation
-
-Install the `imaging-server-kit` package with `pip`:
-
-```
-pip install imaging-server-kit
-```
-
-or clone the project and install the development version:
-
-```
-git clone https://github.com/Imaging-Server-Kit/imaging-server-kit.git
-cd imaging-server-kit
-pip install -e .
-```
-
-## License
-
-This software is distributed under the terms of the [BSD-3](http://opensource.org/licenses/BSD-3-Clause) license.

imaging_server_kit-0.0.8/examples/servers/serverkit-cellpose/README.md

@@ -1,89 +0,0 @@
-![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
-# serverkit-cellpose
-
-Implementation of a web server for [CellPose](https://github.com/MouseLand/cellpose).
-
-## Installing the algorithm server with `pip`
-
-Install dependencies:
-
-```
-pip install -r requirements.txt
-```
-
-Run the server:
-
-```
-uvicorn main:app --host 0.0.0.0 --port 8000
-```
-
-The server will be running on http://localhost:8000.
-
-## Endpoints
-
-A documentation of the endpoints is automatically generated at http://localhost:8000/docs.
-
-**GET endpoints**
-
-- http://localhost:8000/ : Running algorithm message.
-- http://localhost:8000/version: Version of the `imaging-server-kit` package.
-- http://localhost:8000/cellpose/info: Web page displaying project metadata.
-- http://localhost:8000/cellpose/parameters: Json Schema representation of algorithm parameters.
-- http://localhost:8000/cellpose/sample_images: Byte string representation of the sample images.
-
-**POST endpoints**
-
-- http://localhost:8000/cellpose/process: Processing endpoint to run the algorithm.
-
-## Running the server with `docker-compose`
-
-To build the docker image and run a container for the algorithm server in a single command, use:
-
-```
-docker compose up
-```
-
-The server will be running on http://localhost:8000.
-
-## Running the server with `docker`
-
-Build the docker image:
-
-```
-docker build -t serverkit-cellpose .
-```
-
-Run the server in a container:
-
-```
-docker run -it --rm -p 8000:8000 serverkit-cellpose:latest
-```
-
-The server will be running on http://localhost:8000.
-
-## Running unit tests
-
-If you have implemented unit tests in the [tests/](./tests/) folder, you can run them using pytest:
-
-```
-pytest
-```
-
-if you are developing your server locally, or
-
-```
-docker run --rm serverkit-cellpose:latest pytest
-```
-
-to run the tests in a docker container.
-
-## [EPFL only] Publishing a docker image to [registry.rcp.epfl.ch](https://registry.rcp.epfl.ch/)
-
-```
-docker tag serverkit-cellpose registry.rcp.epfl.ch/imaging-server-kit/serverkit-cellpose
-docker push registry.rcp.epfl.ch/imaging-server-kit/serverkit-cellpose
-```
-
-## Sample images provenance
-
-- `nuclei_2d.tif`: Fluorescence microscopy image and mask from the 2018 kaggle DSB challenge (Caicedo et al. "Nucleus segmentation across imaging experiments: the 2018 Data Science Bowl." Nature methods 16.12).

imaging_server_kit-0.0.8/examples/servers/serverkit-orientationpy/README.md

@@ -1,50 +0,0 @@
-![EPFL Center for Imaging logo](https://imaging.epfl.ch/resources/logo-for-gitlab.svg)
-# serverkit-orientationpy
-
-Implementation of a web server for [Orientationpy](https://gitlab.com/epfl-center-for-imaging/orientationpy).
-
-## Installation
-
-Install dependencies:
-
-```
-pip install -r requirements.txt
-```
-
-Run the server:
-
-```
-python main.py
-```
-
-The server will be running on http://localhost:8000.
-
-## Endpoints
-
-A documentation of the endpoints is automatically generated at http://localhost:8000/docs.
-
-**GET endpoints**
-
-- http://localhost:8000/ : Running algorithm message.
-- http://localhost:8000/version: Version of the `imaging-server-kit` package.
-- http://localhost:8000/orientationpy/info: Web page displaying project metadata.
-- http://localhost:8000/orientationpy/parameters: Json Schema representation of algorithm parameters.
-- http://localhost:8000/orientationpy/sample_images: Byte string representation of the sample images.
-
-**POST endpoints**
-
-- http://localhost:8000/orientationpy/process: Processing endpoint to run the algorithm.
-
-## Running the server with `docker-compose`
-
-To build the docker image and run a container for the algorithm server in a single command, use:
-
-```
-docker compose up
-```
-
-The server will be running on http://localhost:8000.
-
-## Sample images provenance
-
-- `image1_from_OrientationJ.tif`: Example image from [OrientationJ](https://bigwww.epfl.ch/demo/orientationj/).