# SeqSee
`SeqSee` (pronounced "seek-see") is a generic visualization tool for spectral sequence data. It aims
to decouple the challenge of working with spectral sequences mathematically from the challenge of
displaying them graphically. We present a [JSON schema](#input-schema) that can serve as a lingua
franca between these two aspects.
By way of example, we have included a tool called `jsonmaker`, which can convert the CSV files found
[here](https://zenodo.org/records/6987157) and [here](https://zenodo.org/records/6987227) into JSON
files following our schema. This script is specific to the format of those CSV files, but serves as
a template for creating tools to generate JSON data that `SeqSee` can display. It is expected that
any software that outputs spectral sequence data will require a customized tool to produce JSON
files that follow the SeqSee schema.
`SeqSee` takes a JSON file as input, conforming to the SeqSee schema, and outputs a self-contained
HTML file. This file includes an SVG figure representing the spectral sequence along with JavaScript
for interactivity.
The HTML files generated by `SeqSee` have a few dependencies and cannot be used offline.
Specifically, they depend on:
- `svg-pan-zoom` 3.6.1 for interactivity.
- `katex` 0.16.2, along with its CSS and `auto-render` extension, for rendering LaTeX in titles and
labels.
- `hammer` 2.0.8 to handle touch inputs.
- `path-data-polyfill` 1.0.9 to handle curved edges.
- The "Computer Modern" font for the axis labels.
For demonstration purposes, the script `seqsee-convert-all` takes every CSV file in `csv/`, converts
them to JSON using `seqsee-jsonmaker`, and then converts each JSON file in `json/` into an HTML file
using `seqsee`.
## Collections
Spectral sequences consist of multiple pages $E_2$, $E_3$, ..., $E_\infty$. SeqSee supports bundling
these into a single HTML file called a _collection_.
When you open a collection, you'll see an index page with links to all charts. Navigate between
charts using the W/S keys, or press Escape to return to the index. This makes it easy to explore a
spectral sequence across multiple pages.
Examples of collections can be found in `html/Adams-classical.html` and `html/Adams-motivic.html`.
## Controls
- Chart controls
- `-`: Zoom out
- `+`: Zoom in
- `0` or Backspace: Reset view
- Arrow keys: Pan
- `c`: Copy current hovertext to clipboard
- Collection controls
- Esc: Return to index page
- `w`: Previous chart
- `s`: Next chart
## Installation
Install SeqSee from PyPI:
```bash
pip install seqsee
```
## Usage
Once installed, you can use the following commands:
- **Generate a Spectral Sequence Chart**:
```bash
seqsee input_file.json output_chart.html
```
- **Convert CSV to JSON**: To convert CSV data to a JSON file compatible with SeqSee:
```bash
seqsee-jsonmaker input_file.csv output_file.json
```
- **Convert Multiple Files**: For batch conversion or processing:
```bash
seqsee-convert-all
```
This script converts every CSV file in `csv/` to a JSON file in `json/`, then converts every JSON
file in `json/` to an HTML chart in `html/`.
## Development
For contributors and developers, see [DEVELOPMENT.md](DEVELOPMENT.md) for setup instructions and
development workflows.
## Input Schema
SeqSee accepts JSON input defining either a single chart or a collection of charts:
- **Collections**: Include a [`charts`](#charts) section to bundle multiple charts. The
[`nodes`](#nodes) and [`edges`](#edges) sections are ignored.
- **Single charts**: Omit the [`charts`](#charts) section. Use [`nodes`](#nodes) and
[`edges`](#edges) to define chart content.
The [`header`](#header) section configures chart appearance and behavior. All sections are optional.
**Schema validation**: Add `"$schema":
"https://raw.githubusercontent.com/JoeyBF/SeqSee/refs/heads/master/seqsee/input_schema.json"` for
IDE validation support.
### Sections
#### `header`
Contains global settings for chart configuration.
- **`metadata`**: Chart metadata and display information.
- **`htmltitle`**: Sets the HTML document title (shown in browser tabs). Defaults to an empty
string.
- **`displaytitle`**: The title shown in the top-left corner of the chart. LaTeX is automatically
rendered. For collections, this appears as the chart label on the index page. Defaults to an
empty string.
- **`title`**: The main title displayed at the top of collection index pages. LaTeX is
automatically rendered. Has no effect for standalone charts. Defaults to an empty string.
- **`id`**: A numerical identifier for the chart. This is typically set to the page number (e.g.,
`2` for the $E_2$ page). Defaults to `0`.
- Any other key-value pair is accepted, but will have no effect on the output. This is useful for
tagging output files, since the JSON format does not allow comments. Potentially useful data
might include `author`, `date`, `source`, `version`, `description`, etc.
- **`chart`**: Holds configuration for the visuals of the chart.
- **`width` and `height`**: Objects specifying the chart dimensions. Each has `min` and `max`
properties, which are either signed integers or `null`. If `null`, an appropriate value is
computed automatically based on `nodes`. All defaults are `null`.
- **`scale`**: A number representing the grid scale in pixels. Each unit increase along the axes
corresponds to this many pixels. Defaults to `60`.
- **`nodeSize`**: Defines the radius of nodes as a multiple of `scale`. Defaults to `0.04`.
- **`nodeSpacing`**: Specifies the distance between nodes in the same bidegree, measured between
their circumferences. Defaults to `0.02`.
- **`nodeSlope`**: The slope of the line along which nodes are positioned:
- `0`: Horizontal alignment
- `null`: Vertical alignment
- Any floating point value is accepted. Defaults to `0`.
- **`aliases`**: Allows shorthand for reusable colors and attributes.
- **`colors`**: Maps color names to valid CSS color values. Some special colors are predefined but
can be customized:
- **`backgroundColor`**: The background color of the chart. Defaults to `"white"`.
- **`borderColor`**: The color of the chart and tooltip borders. Defaults to `"black"`.
- **`textColor`**: The color of text and labels. Defaults to `"black"`.
- **`attributes`**: Maps names to predefined [attribute lists](#attribute-lists), which can be
applied to nodes or edges for consistent styling. We require the attribute names to be [valid
CSS identifiers][css-identifiers]. Some special aliases are predefined but can be customized:
- **`grid`**: An attribute list applied to the grid itself. Defaults to `[ {"color": "#ccc",
"thickness": 0.01} ]`.
- **`defaultNode`**: An attribute list applied to all nodes. Defaults to `[ {"color": "black"}
]`. **Note:** Specifying default node size here overrides automatic spacing; node size should
generally be set in `header/chart/nodeSize` for automatic spacing.
- **`defaultEdge`**: An attribute list applied to all edges. Defaults to `[ {"color": "black",
"thickness": 0.02} ]`.
[css-identifiers]: https://walterebert.com/playground/css/valid-identifiers/
#### `nodes`
Defines individual nodes in the chart. Each node has a unique identifier (the key) and an object
specifying its properties:
- **`x` and `y`**: Integer grid coordinates. Most nodes use these for automatic positioning.
- **`absoluteX` and `absoluteY`**: Precise floating-point coordinates. Use these when you need exact
positioning and want to override automatic spacing.
- **`position`**: Controls stacking order for nodes at the same grid coordinates. Negative values
position nodes to the left, positive values to the right. Defaults to `0`.
- **`label`**: LaTeX string displayed in tooltips when hovering over the node.
- **`attributes`**: An [attribute list](#attribute-lists) for custom styling.
**Coordinate system**: Each node requires exactly one X coordinate (`x` or `absoluteX`) and one Y
coordinate (`y` or `absoluteY`).
- **Grid coordinates** (`x`, `y`): Nodes are positioned automatically using the global `nodeSpacing`
and `nodeSlope` settings, with multiple nodes at the same coordinates arranged according to their
`position` values.
- **Absolute coordinates** (`absoluteX`, `absoluteY`): Nodes are positioned at exact pixel locations
(scaled by the chart `scale` factor). If either coordinate is absolute, the node bypasses
automatic spacing entirely.
#### `edges`
Defines directed or undirected edges between nodes.
- **`source`**: The identifier of the starting node (required).
- **`target`**: The identifier of the ending node. Exactly one of `target` or `offset` is required.
- **`offset`**: Relative positioning from the source node, if `target` is not specified. Used for
freestanding edges, often styled as arrows, with only one endpoint anchored to a node.
- **`x`**: Floating point value encoding the X-offset from the source node.
- **`y`**: Floating point value encoding the Y-offset from the source node.
- **`bezier`**: Specifies the control point(s) for the Bézier curve representing this edge. If
present, it is an array containing one or two objects with keys `x` and `y`, representing
coordinates:
- **1 Object**: A single control point for a quadratic Bézier curve. Coordinates are relative to
the source node.
- **2 Objects**: Two control points for a cubic Bézier curve. The first point's coordinates are
relative to the source node, and the second point's coordinates are relative to the endpoint.
- **`attributes`**: An [attribute list](#attribute-lists) for edge-specific styling. Defaults to
`[]`.
#### `charts`
Defines a collection of charts to be bundled into a single HTML file. When this section is present,
the `nodes` and `edges` sections are ignored, and each chart in the collection is defined as a
separate object with its own `header`, `nodes`, and `edges` sections.
Each chart in the collection can be either:
- A complete chart specification object with `header`, `nodes`, and `edges` sections
- A string path to a separate JSON file containing a chart specification
Collections are useful for displaying multiple pages of a single spectral sequence or related charts
together. The generated HTML will show an index page with links to all charts, and keyboard
navigation (W/S/Esc) is available.
#### Attribute Lists
Attribute lists are arrays of styling properties defining the visual characteristics of nodes and
edges. Each entry is a string (aliasing an attribute list) or an object with the following
properties:
- **`color`**: A string representing the color. Accepts any CSS color value or a predefined color
from `header/aliases/colors`.
- **`size`**: Specifies the element's size as a multiple of the chart scale. Applies to nodes
(radius).
- **`thickness`**: Specifies thickness as a multiple of the chart scale. Applies mainly to edges;
for nodes, it sets the circle border thickness (typically kept at 0 to maintain proper spacing).
- **`arrowTip`**: Defines the arrow tip type on an edge. Valid values are `"none"` (no arrow head)
or `"simple"` (simple arrow head).
- **`pattern`**: Specifies the line pattern for edges. Valid values are `"solid"`, `"dashed"`, or
`"dotted"`.
- Any other property is treated as raw CSS.
Strings in an attribute list reference their own attribute list in `header/aliases/attributes`. When
multiple properties are specified, directly specified properties take precedence. If conflicts
remain, later entries in the list override previous ones.
## Examples
- An empty chart:
```json
{}
```
- A 2x2 chart showing a single black node at the origin, labeled `1`:
```json
{
"nodes": { "1": {"x": 0, "y": 0, "label": "1"} }
}
```
- The first few stems of the 2-primary $\mathbb{C}$-motivic Adams spectral sequence:
```json
{
"$schema": "https://raw.githubusercontent.com/JoeyBF/SeqSee/refs/heads/master/seqsee/input_schema.json",
"header": {
"metadata": {
"htmltitle": "First few C-motivic stable stems",
"title": "First few $\\mathbb{C}$-motivic stable stems",
"authors": ["Joey Beauvais-Feisthauer", "Daniel C. Isaksen"]
},
"aliases": {
"attributes": {
"defaultNode": [ {"color": "gray" } ],
"defaultEdge": [ {"color": "gray" } ],
"tau1" : [ {"color": "tau1color" } ],
"tau1extn" : [ {"color": "tau1extncolor"} ]
},
"colors": {
"gray" : "#666" ,
"tau1color" : "#DD0000",
"tau1extncolor": "magenta"
}
}
},
"nodes": {
"1" : {"x": 0, "y": 0, "label": "$1$ (0)"} ,
"h0" : {"x": 0, "y": 1, "label": "$h_0$ (0)"} ,
"h0^2": {"x": 0, "y": 2, "label": "$h_0^2$ (0)"} ,
"h0^3": {"x": 0, "y": 3, "label": "$h_0^3$ (0)"} ,
"h1" : {"x": 1, "y": 1, "label": "$h_1$ (1)"} ,
"h1^2": {"x": 2, "y": 2, "label": "$h_1^2$ (2)"} ,
"h2" : {"x": 3, "y": 1, "label": "$h_2$ (2)"} ,
"h0h2": {"x": 3, "y": 2, "label": "$h_0 h_2$ (2)"} ,
"h1^3": {"x": 3, "y": 3, "label": "$h_1^3$ (3)"} ,
"h1^4": { "x": 4, "y": 4, "label": "$h_1^4$ (4)", "attributes": ["tau1"] }
},
"edges": [
{"source": "1", "target": "h0"},
{"source": "1", "target": "h1"},
{"source": "1", "target": "h2"},
{"source": "h0", "target": "h0^2"},
{"source": "h0", "target": "h0h2"},
{"source": "h0^2", "target": "h0^3"},
{ "source": "h0^2", "target": "h1^3", "attributes": ["tau1extn"] },
{
"source": "h0^3",
"offset": {"x": 0, "y": 0.7},
"attributes": [ {"arrowTip": "simple"} ]
},
{"source": "h1", "target": "h1^2"},
{"source": "h1^2", "target": "h1^3"},
{"source": "h2", "target": "h0h2"},
{ "source": "h0h2", "target": "h1^3", "attributes": ["tau1extn"] },
{ "source": "h1^3", "target": "h1^4", "attributes": ["tau1"] },
{
"source": "h1^4",
"offset": {"x": 0.7, "y": 0.7},
"attributes": [ "tau1", {"arrowTip": "simple"} ]
}
]
}
```
- See `json/curves.json` for an example of how to define curved edges.
- See `json/hidden_nodes.json` for an example of how to define nodes with no radius.
- See `json/dark_theme.json` for an example of a dark themed chart.
- See the rest of the `json/` directory for significantly more involved examples. These have all
been generated from the files in the `csv/` directory using `seqsee-jsonmaker`, through
`seqsee-convert-all`.
## Future Development
`SeqSee` is designed with flexibility in mind, making it straightforward to extend its capabilities.
Potential areas for development include:
- **Customizable Styles**: Add support for more node and edge styles, shadow effects, or different
node shapes.
- **Advanced Interactivity**: Implement features like node/edge selection, more hover effects, and
dynamic highlighting.
- **Improved Coordinate Systems**: Allow more customization of axes, gridlines, and coordinates for
specialized use cases.
- **Enhanced Output Formats**: Support additional export formats, such as PDFs, Tikz figures, or raw
SVG files for presentations and publications.
Contributions to the `SeqSee` project are welcome! Please open issues or submit pull requests for
new features or bug fixes.
Raw data
{
"_id": null,
"home_page": null,
"name": "seqsee",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "spectral-sequence, visualization, mathematics, topology, html",
"author": null,
"author_email": "Joey Beauvais-Feisthauer <joeybf@wayne.edu>, Dan Isaksen <isaksen@wayne.edu>",
"download_url": "https://files.pythonhosted.org/packages/0a/b3/ca552e584fad03f62290013d3d99846f8692db6408a2632ed9c8099709b2/seqsee-0.3.1.tar.gz",
"platform": null,
"description": "# SeqSee\n\n`SeqSee` (pronounced \"seek-see\") is a generic visualization tool for spectral sequence data. It aims\nto decouple the challenge of working with spectral sequences mathematically from the challenge of\ndisplaying them graphically. We present a [JSON schema](#input-schema) that can serve as a lingua\nfranca between these two aspects.\n\nBy way of example, we have included a tool called `jsonmaker`, which can convert the CSV files found\n[here](https://zenodo.org/records/6987157) and [here](https://zenodo.org/records/6987227) into JSON\nfiles following our schema. This script is specific to the format of those CSV files, but serves as\na template for creating tools to generate JSON data that `SeqSee` can display. It is expected that\nany software that outputs spectral sequence data will require a customized tool to produce JSON\nfiles that follow the SeqSee schema.\n\n`SeqSee` takes a JSON file as input, conforming to the SeqSee schema, and outputs a self-contained\nHTML file. This file includes an SVG figure representing the spectral sequence along with JavaScript\nfor interactivity.\n\nThe HTML files generated by `SeqSee` have a few dependencies and cannot be used offline.\nSpecifically, they depend on:\n\n- `svg-pan-zoom` 3.6.1 for interactivity.\n- `katex` 0.16.2, along with its CSS and `auto-render` extension, for rendering LaTeX in titles and\n labels.\n- `hammer` 2.0.8 to handle touch inputs.\n- `path-data-polyfill` 1.0.9 to handle curved edges.\n- The \"Computer Modern\" font for the axis labels.\n\nFor demonstration purposes, the script `seqsee-convert-all` takes every CSV file in `csv/`, converts\nthem to JSON using `seqsee-jsonmaker`, and then converts each JSON file in `json/` into an HTML file\nusing `seqsee`.\n\n## Collections\n\nSpectral sequences consist of multiple pages $E_2$, $E_3$, ..., $E_\\infty$. SeqSee supports bundling\nthese into a single HTML file called a _collection_.\n\nWhen you open a collection, you'll see an index page with links to all charts. Navigate between\ncharts using the W/S keys, or press Escape to return to the index. This makes it easy to explore a\nspectral sequence across multiple pages.\n\nExamples of collections can be found in `html/Adams-classical.html` and `html/Adams-motivic.html`.\n\n## Controls\n\n- Chart controls\n - `-`: Zoom out\n - `+`: Zoom in\n - `0` or Backspace: Reset view\n - Arrow keys: Pan\n - `c`: Copy current hovertext to clipboard\n- Collection controls\n - Esc: Return to index page\n - `w`: Previous chart\n - `s`: Next chart\n\n## Installation\n\nInstall SeqSee from PyPI:\n\n```bash\npip install seqsee\n```\n\n## Usage\n\nOnce installed, you can use the following commands:\n\n- **Generate a Spectral Sequence Chart**:\n\n ```bash\n seqsee input_file.json output_chart.html\n ```\n\n- **Convert CSV to JSON**: To convert CSV data to a JSON file compatible with SeqSee:\n\n ```bash\n seqsee-jsonmaker input_file.csv output_file.json\n ```\n\n- **Convert Multiple Files**: For batch conversion or processing:\n\n ```bash\n seqsee-convert-all\n ```\n\n This script converts every CSV file in `csv/` to a JSON file in `json/`, then converts every JSON\n file in `json/` to an HTML chart in `html/`.\n\n## Development\n\nFor contributors and developers, see [DEVELOPMENT.md](DEVELOPMENT.md) for setup instructions and\ndevelopment workflows.\n\n## Input Schema\n\nSeqSee accepts JSON input defining either a single chart or a collection of charts:\n\n- **Collections**: Include a [`charts`](#charts) section to bundle multiple charts. The\n [`nodes`](#nodes) and [`edges`](#edges) sections are ignored.\n- **Single charts**: Omit the [`charts`](#charts) section. Use [`nodes`](#nodes) and\n [`edges`](#edges) to define chart content.\n\nThe [`header`](#header) section configures chart appearance and behavior. All sections are optional.\n\n**Schema validation**: Add `\"$schema\":\n\"https://raw.githubusercontent.com/JoeyBF/SeqSee/refs/heads/master/seqsee/input_schema.json\"` for\nIDE validation support.\n\n### Sections\n\n#### `header`\n\nContains global settings for chart configuration.\n\n- **`metadata`**: Chart metadata and display information.\n - **`htmltitle`**: Sets the HTML document title (shown in browser tabs). Defaults to an empty\n string.\n - **`displaytitle`**: The title shown in the top-left corner of the chart. LaTeX is automatically\n rendered. For collections, this appears as the chart label on the index page. Defaults to an\n empty string.\n - **`title`**: The main title displayed at the top of collection index pages. LaTeX is\n automatically rendered. Has no effect for standalone charts. Defaults to an empty string.\n - **`id`**: A numerical identifier for the chart. This is typically set to the page number (e.g.,\n `2` for the $E_2$ page). Defaults to `0`.\n - Any other key-value pair is accepted, but will have no effect on the output. This is useful for\n tagging output files, since the JSON format does not allow comments. Potentially useful data\n might include `author`, `date`, `source`, `version`, `description`, etc.\n\n- **`chart`**: Holds configuration for the visuals of the chart.\n - **`width` and `height`**: Objects specifying the chart dimensions. Each has `min` and `max`\n properties, which are either signed integers or `null`. If `null`, an appropriate value is\n computed automatically based on `nodes`. All defaults are `null`.\n - **`scale`**: A number representing the grid scale in pixels. Each unit increase along the axes\n corresponds to this many pixels. Defaults to `60`.\n - **`nodeSize`**: Defines the radius of nodes as a multiple of `scale`. Defaults to `0.04`.\n - **`nodeSpacing`**: Specifies the distance between nodes in the same bidegree, measured between\n their circumferences. Defaults to `0.02`.\n - **`nodeSlope`**: The slope of the line along which nodes are positioned:\n - `0`: Horizontal alignment\n - `null`: Vertical alignment\n - Any floating point value is accepted. Defaults to `0`.\n\n- **`aliases`**: Allows shorthand for reusable colors and attributes.\n - **`colors`**: Maps color names to valid CSS color values. Some special colors are predefined but\n can be customized:\n - **`backgroundColor`**: The background color of the chart. Defaults to `\"white\"`.\n - **`borderColor`**: The color of the chart and tooltip borders. Defaults to `\"black\"`.\n - **`textColor`**: The color of text and labels. Defaults to `\"black\"`.\n - **`attributes`**: Maps names to predefined [attribute lists](#attribute-lists), which can be\n applied to nodes or edges for consistent styling. We require the attribute names to be [valid\n CSS identifiers][css-identifiers]. Some special aliases are predefined but can be customized:\n - **`grid`**: An attribute list applied to the grid itself. Defaults to `[ {\"color\": \"#ccc\",\n \"thickness\": 0.01} ]`.\n - **`defaultNode`**: An attribute list applied to all nodes. Defaults to `[ {\"color\": \"black\"}\n ]`. **Note:** Specifying default node size here overrides automatic spacing; node size should\n generally be set in `header/chart/nodeSize` for automatic spacing.\n - **`defaultEdge`**: An attribute list applied to all edges. Defaults to `[ {\"color\": \"black\",\n \"thickness\": 0.02} ]`.\n\n[css-identifiers]: https://walterebert.com/playground/css/valid-identifiers/\n\n#### `nodes`\n\nDefines individual nodes in the chart. Each node has a unique identifier (the key) and an object\nspecifying its properties:\n\n- **`x` and `y`**: Integer grid coordinates. Most nodes use these for automatic positioning.\n- **`absoluteX` and `absoluteY`**: Precise floating-point coordinates. Use these when you need exact\n positioning and want to override automatic spacing.\n- **`position`**: Controls stacking order for nodes at the same grid coordinates. Negative values\n position nodes to the left, positive values to the right. Defaults to `0`.\n- **`label`**: LaTeX string displayed in tooltips when hovering over the node.\n- **`attributes`**: An [attribute list](#attribute-lists) for custom styling.\n\n**Coordinate system**: Each node requires exactly one X coordinate (`x` or `absoluteX`) and one Y\ncoordinate (`y` or `absoluteY`).\n\n- **Grid coordinates** (`x`, `y`): Nodes are positioned automatically using the global `nodeSpacing`\n and `nodeSlope` settings, with multiple nodes at the same coordinates arranged according to their\n `position` values.\n- **Absolute coordinates** (`absoluteX`, `absoluteY`): Nodes are positioned at exact pixel locations\n (scaled by the chart `scale` factor). If either coordinate is absolute, the node bypasses\n automatic spacing entirely.\n\n#### `edges`\n\nDefines directed or undirected edges between nodes.\n\n- **`source`**: The identifier of the starting node (required).\n- **`target`**: The identifier of the ending node. Exactly one of `target` or `offset` is required.\n- **`offset`**: Relative positioning from the source node, if `target` is not specified. Used for\n freestanding edges, often styled as arrows, with only one endpoint anchored to a node.\n - **`x`**: Floating point value encoding the X-offset from the source node.\n - **`y`**: Floating point value encoding the Y-offset from the source node.\n- **`bezier`**: Specifies the control point(s) for the B\u00e9zier curve representing this edge. If\n present, it is an array containing one or two objects with keys `x` and `y`, representing\n coordinates:\n - **1 Object**: A single control point for a quadratic B\u00e9zier curve. Coordinates are relative to\n the source node.\n - **2 Objects**: Two control points for a cubic B\u00e9zier curve. The first point's coordinates are\n relative to the source node, and the second point's coordinates are relative to the endpoint.\n- **`attributes`**: An [attribute list](#attribute-lists) for edge-specific styling. Defaults to\n `[]`.\n\n#### `charts`\n\nDefines a collection of charts to be bundled into a single HTML file. When this section is present,\nthe `nodes` and `edges` sections are ignored, and each chart in the collection is defined as a\nseparate object with its own `header`, `nodes`, and `edges` sections.\n\nEach chart in the collection can be either:\n\n- A complete chart specification object with `header`, `nodes`, and `edges` sections\n- A string path to a separate JSON file containing a chart specification\n\nCollections are useful for displaying multiple pages of a single spectral sequence or related charts\ntogether. The generated HTML will show an index page with links to all charts, and keyboard\nnavigation (W/S/Esc) is available.\n\n#### Attribute Lists\n\nAttribute lists are arrays of styling properties defining the visual characteristics of nodes and\nedges. Each entry is a string (aliasing an attribute list) or an object with the following\nproperties:\n\n- **`color`**: A string representing the color. Accepts any CSS color value or a predefined color\n from `header/aliases/colors`.\n- **`size`**: Specifies the element's size as a multiple of the chart scale. Applies to nodes\n (radius).\n- **`thickness`**: Specifies thickness as a multiple of the chart scale. Applies mainly to edges;\n for nodes, it sets the circle border thickness (typically kept at 0 to maintain proper spacing).\n- **`arrowTip`**: Defines the arrow tip type on an edge. Valid values are `\"none\"` (no arrow head)\n or `\"simple\"` (simple arrow head).\n- **`pattern`**: Specifies the line pattern for edges. Valid values are `\"solid\"`, `\"dashed\"`, or\n `\"dotted\"`.\n- Any other property is treated as raw CSS.\n\nStrings in an attribute list reference their own attribute list in `header/aliases/attributes`. When\nmultiple properties are specified, directly specified properties take precedence. If conflicts\nremain, later entries in the list override previous ones.\n\n## Examples\n\n- An empty chart:\n\n ```json\n {}\n ```\n\n- A 2x2 chart showing a single black node at the origin, labeled `1`:\n\n ```json\n {\n \"nodes\": { \"1\": {\"x\": 0, \"y\": 0, \"label\": \"1\"} }\n }\n ```\n\n- The first few stems of the 2-primary $\\mathbb{C}$-motivic Adams spectral sequence:\n\n ```json\n {\n \"$schema\": \"https://raw.githubusercontent.com/JoeyBF/SeqSee/refs/heads/master/seqsee/input_schema.json\",\n \"header\": {\n \"metadata\": {\n \"htmltitle\": \"First few C-motivic stable stems\",\n \"title\": \"First few $\\\\mathbb{C}$-motivic stable stems\",\n \"authors\": [\"Joey Beauvais-Feisthauer\", \"Daniel C. Isaksen\"]\n },\n \"aliases\": {\n \"attributes\": {\n \"defaultNode\": [ {\"color\": \"gray\" } ],\n \"defaultEdge\": [ {\"color\": \"gray\" } ],\n \"tau1\" : [ {\"color\": \"tau1color\" } ],\n \"tau1extn\" : [ {\"color\": \"tau1extncolor\"} ]\n },\n \"colors\": {\n \"gray\" : \"#666\" ,\n \"tau1color\" : \"#DD0000\",\n \"tau1extncolor\": \"magenta\"\n }\n }\n },\n \"nodes\": {\n \"1\" : {\"x\": 0, \"y\": 0, \"label\": \"$1$ (0)\"} ,\n \"h0\" : {\"x\": 0, \"y\": 1, \"label\": \"$h_0$ (0)\"} ,\n \"h0^2\": {\"x\": 0, \"y\": 2, \"label\": \"$h_0^2$ (0)\"} ,\n \"h0^3\": {\"x\": 0, \"y\": 3, \"label\": \"$h_0^3$ (0)\"} ,\n \"h1\" : {\"x\": 1, \"y\": 1, \"label\": \"$h_1$ (1)\"} ,\n \"h1^2\": {\"x\": 2, \"y\": 2, \"label\": \"$h_1^2$ (2)\"} ,\n \"h2\" : {\"x\": 3, \"y\": 1, \"label\": \"$h_2$ (2)\"} ,\n \"h0h2\": {\"x\": 3, \"y\": 2, \"label\": \"$h_0 h_2$ (2)\"} ,\n \"h1^3\": {\"x\": 3, \"y\": 3, \"label\": \"$h_1^3$ (3)\"} ,\n \"h1^4\": { \"x\": 4, \"y\": 4, \"label\": \"$h_1^4$ (4)\", \"attributes\": [\"tau1\"] }\n },\n \"edges\": [\n {\"source\": \"1\", \"target\": \"h0\"},\n {\"source\": \"1\", \"target\": \"h1\"},\n {\"source\": \"1\", \"target\": \"h2\"},\n {\"source\": \"h0\", \"target\": \"h0^2\"},\n {\"source\": \"h0\", \"target\": \"h0h2\"},\n {\"source\": \"h0^2\", \"target\": \"h0^3\"},\n { \"source\": \"h0^2\", \"target\": \"h1^3\", \"attributes\": [\"tau1extn\"] },\n {\n \"source\": \"h0^3\",\n \"offset\": {\"x\": 0, \"y\": 0.7},\n \"attributes\": [ {\"arrowTip\": \"simple\"} ]\n },\n {\"source\": \"h1\", \"target\": \"h1^2\"},\n {\"source\": \"h1^2\", \"target\": \"h1^3\"},\n {\"source\": \"h2\", \"target\": \"h0h2\"},\n { \"source\": \"h0h2\", \"target\": \"h1^3\", \"attributes\": [\"tau1extn\"] },\n { \"source\": \"h1^3\", \"target\": \"h1^4\", \"attributes\": [\"tau1\"] },\n {\n \"source\": \"h1^4\",\n \"offset\": {\"x\": 0.7, \"y\": 0.7},\n \"attributes\": [ \"tau1\", {\"arrowTip\": \"simple\"} ]\n }\n ]\n }\n ```\n\n- See `json/curves.json` for an example of how to define curved edges.\n\n- See `json/hidden_nodes.json` for an example of how to define nodes with no radius.\n\n- See `json/dark_theme.json` for an example of a dark themed chart.\n\n- See the rest of the `json/` directory for significantly more involved examples. These have all\n been generated from the files in the `csv/` directory using `seqsee-jsonmaker`, through\n `seqsee-convert-all`.\n\n## Future Development\n\n`SeqSee` is designed with flexibility in mind, making it straightforward to extend its capabilities.\nPotential areas for development include:\n\n- **Customizable Styles**: Add support for more node and edge styles, shadow effects, or different\n node shapes.\n- **Advanced Interactivity**: Implement features like node/edge selection, more hover effects, and\n dynamic highlighting.\n- **Improved Coordinate Systems**: Allow more customization of axes, gridlines, and coordinates for\n specialized use cases.\n- **Enhanced Output Formats**: Support additional export formats, such as PDFs, Tikz figures, or raw\n SVG files for presentations and publications.\n\nContributions to the `SeqSee` project are welcome! Please open issues or submit pull requests for\nnew features or bug fixes.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A generic visualization tool for spectral sequence data",
"version": "0.3.1",
"project_urls": {
"Documentation": "https://github.com/JoeyBF/SeqSee#readme",
"Homepage": "https://github.com/JoeyBF/SeqSee",
"Issues": "https://github.com/JoeyBF/SeqSee/issues",
"Repository": "https://github.com/JoeyBF/SeqSee"
},
"split_keywords": [
"spectral-sequence",
" visualization",
" mathematics",
" topology",
" html"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f1850eb5729ba667428de94d5cd093d54c02fc65842d3c146b932c7b44bcea98",
"md5": "72005bdc80c12d30b2bdbc0d9ebff203",
"sha256": "44d686b8de0662f5ccbeef5e127a665f5dd5d77e5b750c323bdc819706cd3f3f"
},
"downloads": -1,
"filename": "seqsee-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72005bdc80c12d30b2bdbc0d9ebff203",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 29391,
"upload_time": "2025-07-24T21:30:37",
"upload_time_iso_8601": "2025-07-24T21:30:37.821325Z",
"url": "https://files.pythonhosted.org/packages/f1/85/0eb5729ba667428de94d5cd093d54c02fc65842d3c146b932c7b44bcea98/seqsee-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0ab3ca552e584fad03f62290013d3d99846f8692db6408a2632ed9c8099709b2",
"md5": "dcd4b4cd74ad86c9f6c8208f83093099",
"sha256": "a80b25d75340d606bd52d9e2d889be317ebeb241c0307da37cfa040dbea0371c"
},
"downloads": -1,
"filename": "seqsee-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "dcd4b4cd74ad86c9f6c8208f83093099",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 33360,
"upload_time": "2025-07-24T21:30:39",
"upload_time_iso_8601": "2025-07-24T21:30:39.155296Z",
"url": "https://files.pythonhosted.org/packages/0a/b3/ca552e584fad03f62290013d3d99846f8692db6408a2632ed9c8099709b2/seqsee-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-24 21:30:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "JoeyBF",
"github_project": "SeqSee#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "seqsee"
}
JSON
