Merge pull request #86 from CAVEconnectome/polyline

Adding polyline annotations

Author: ceesem

docs/usage/parser.md

@@ -49,4 +49,5 @@ state_parser.annotation_dataframe()
 
 will give you a dataframe where each row is an annotation, and columns show layer name, points locations, annotation type, annotation id, linked segmentations, tags, etc. If you are using tags, the `expand_tags=True` argument will create a column for every tag and assign a boolean value to the row based on whether the tag is present in the annotation.
 Another option that is sometimes useful is `split_points=True`, which will create a separate column for each x, y, or z coordinate in the annotation.
+Note that polyline annotations will come back with all points in the "point" field.
 

docs/usage/statebuilder.md

@@ -374,7 +374,7 @@ Once you have a shader you want to use, you can set it with the `add_shader` met
 
 ### Annotation Layers
 
-Annotation layers let a user define various types of annotations like points, lines, bounding boxes, and ellipses.
+Annotation layers let a user define various types of annotations like points, lines, bounding boxes, ellipses, and polylines (a series of points, each connected to the next by lines).
 Annotations can also be associated with segmentations, allowing you to filter annotations by the data that's being selected.
 
 Annotation layers come in two types, **local** annotation layers that store their annotations directly in the Neuroglancer state and **cloud** annotation layers that get their annotations from a cloud-hosted source.
@@ -391,7 +391,7 @@ annotation_layer = AnnotationLayer(name='my_annotations')
 viewer_state.add_layer(annotation_layer)
 ```
 
-The simplest way to add annotations is through the `add_points`, `add_lines`, `add_boxes`, and `add_ellipses` methods.
+The simplest way to add annotations is through the `add_points`, `add_lines`, `add_boxes`, `add_ellipses`, and `add_polylines` methods.
 These methods work similarly, taking a dataframe where each row represents an annotation and the columns are specified by parameters.
 
 For example, to add points to the annotation layer, you can do:
@@ -559,7 +559,7 @@ viewer_state.map(
 This will replace the DataMap keys with the actual data and produce a Neuroglancer link with the specified sources.
 Applying this across a list of data sources can easily generate a large collection of neuroglancer states.
 
-The other principle use of DataMaps is to support annotation creation by replacing the `data` argument in the `add_points`, `add_lines`, `add_boxes`, and `add_ellipses` methods.
+The other principle use of DataMaps is to support annotation creation by replacing the `data` argument in the `add_points`, `add_lines`, `add_boxes`, `add_ellipses`, and `add_polylines` methods.
 For example, you can create a DataMap for the annotation data and then use it to add points to the annotation layer with the following pattern:
 
 ``` pycon

pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nglui"
-version = "4.6.0"
+version = "4.6.1"
 description = "Framework for data-driven generation of neuroglancer states."
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "attrs>=24.6.0",
+    "attrs>=24.6.1",
     "caveclient>=7.0.0",
     "ipython>=8.18.1",
     "numpy>=1.26.4",
@@ -18,11 +18,11 @@ dependencies = [
     "requests>=2.32.3",
     "six>=1.16.0",
     "webcolors>=24.11.1",
-    "neuroglancer==2.40.1",
     "cachetools>=5.5.2",
-    "palettable>=3.3.3,<4.6.0",
+    "palettable>=3.3.3,<4.6.1",
     "typing-extensions>=4.13.2,<5.0.0 ; python_full_version < '3.11'",
     "pyperclip>=1.9.0",
+    "neuroglancer>=2.41.2",
 ]
 authors = [
     { name = "Casey Schneider-Mizell", email = "caseysm@gmail.com" },
@@ -47,6 +47,7 @@ Issues = "https://github.com/CAVEconnectome/nglui/issues"
 [project.optional-dependencies]
 full = [
     "cloud-volume>=12.3.1",
+    "pysimdjson>=7.0.0 ; python_version >= '3.13'",
 ]
 
 [dependency-groups]
@@ -57,6 +58,7 @@ dev = [
     "responses",
     "ipykernel",
     "bump-my-version",
+    "cloud-volume",
 ]
 docs = [
     "mkdocs",
@@ -70,7 +72,7 @@ lint = [
 default-groups = ["dev", "docs", "lint"]
 
 [tool.bumpversion]
-current_version = "4.6.0"
+current_version = "4.6.1"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

src/nglui/__init__.py

@@ -1,3 +1,3 @@
 # from . import parser, segmentprops, site_utils, statebuilder
 
-__version__ = "4.6.0"
+__version__ = "4.6.1"