add examples and instructions to readme

Added instructions for single canvas and orthoviewer usage, including examples and latency measurement.

Author: kevinyamauchi

README.md

@@ -8,6 +8,52 @@
 
 A viewer for ome-zarr images.
 
+## Single canvas viewer
+
+You can load a v0.4 or v0.5 OME-Zarr file into a single-canvas 2d/3d viewer using the `oz-viewer view` CLI. See the example below. Replace the file path with the path to your image. This works for both local and remote data.
+
+```sh
+oz-viewer view path/to/image.ome.zarr
+```
+
+Example viewing a https://livingobjects.ebi.ac.uk/idr/zarr/v0.5/idr0066/ExpA_VIP_ASLM_on.zarr (1937, 2048, 2048), anisotropic voxels (file was on local SSD).
+
+https://github.com/user-attachments/assets/59c31e89-db42-4cec-ae4f-373d997c227f
+
+## Orthoviewer
+
+You can load a v0.4 or v0.5 OME-Zarr file into an orthoviewer using the `oz-viewer ortho ` CLI. See the example below. Replace the file path with the path to your image. This works for both local and remote data.
+
+```sh
+oz-viewer ortho path/to/image.ome.zarr
+```
+
+Example viewing https://livingobjects.ebi.ac.uk/idr/zarr/v0.5/idr0066/ExpA_VIP_ASLM_on.zarr (1937, 2048, 2048), anisotropic voxels (file was on local SSD).
+
+https://github.com/user-attachments/assets/a6c0cab9-0cd9-4fe0-80c2-c77207b4fd77
+
+You can click the multichannel button in the upper left-hand corner to toggle berween single/multichannel rendering. Example viewing the scikit-image cells3d (converted to ome-zarr) multichannel image
+
+https://github.com/user-attachments/assets/b6655863-b8fb-4eea-be84-eb031283494e
+
+
+
+## Test dataset latency
+
+The latency for fetching chunks greatly impacts the rendering performance of the viewer. High latency means that fetching chunks from the data store is slow and thus rendering feels slow. If the latency for fetching data from your image is high, you can offset it by increasing the lod_bias which causes the renderer to prefer loading lower resolution chunks. This reduces the aount of data that needs to be loaded, but sacrifices detail.
+
+To measure the latency, you can use the `oz-viewer ping` CLI. See the example below. Replace the path with the path to your data. You can use both URL and file paths.
+
+```sh
+oz-viewer ping https://livingobjects.ebi.ac.uk/idr/share/ome2024-ngff-challenge/idr0066/ExpC_TPH2_left_cerebellum.zarr
+```
+
+To view the options, you can run
+
+```sh
+oz-viewer ping --help
+```
+  
 ## Orthoviewer startup performance diagnostics
 
 Use the orthoviewer performance flags to print startup timings