# neurospatial
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
**neurospatial** is a Python library for discretizing continuous N-dimensional spatial environments into bins/nodes with connectivity graphs. It provides tools for spatial analysis, particularly for neuroscience applications involving place fields, position tracking, and spatial navigation.
Whether you're analyzing animal navigation data, modeling place cells, or working with any spatial discretization problem, neurospatial gives you flexible, powerful tools to represent and analyze spatial environments.
## Key Features
- **Multiple Layout Engines**: Choose from regular grids, hexagonal tessellations, masked regions, polygon-bounded areas, triangular meshes, and 1D linearized tracks
- **Automatic Bin Detection**: Infer active bins from data samples with morphological operations (dilation, closing, hole filling)
- **Connectivity Graphs**: Built-in NetworkX graphs with mandatory node/edge metadata for spatial queries
- **1D Linearization**: Transform complex 2D environments into 1D linearized coordinates for track-based analysis
- **Spatial Queries**: Point-to-bin mapping, neighbor finding, shortest paths, geodesic distances
- **Region Support**: Define and manage named regions of interest (ROIs) with immutable semantics
- **Environment Composition**: Merge multiple environments with automatic bridge inference
- **Alignment Tools**: Transform and map probability distributions between environments
- **Type-Safe Protocol Design**: Layout engines implement protocols, not inheritance, for maximum flexibility
## Installation
### From PyPI (when released)
```bash
pip install neurospatial
```
### For Development
```bash
# Clone the repository
git clone https://github.com/edeno/neurospatial.git
cd neurospatial
# Install with uv (recommended)
uv sync
# Or with pip
pip install -e ".[dev]"
```
**Note**: This project uses `uv` for package management. If you have `uv` installed, all commands should be prefixed with `uv run` (e.g., `uv run pytest`).
### Tested Dependency Versions
neurospatial v0.1.0 has been tested with the following dependency versions:
| Package | Tested Version |
|---------|---------------|
| Python | 3.13.5 |
| numpy | 2.3.4 |
| pandas | 2.3.3 |
| matplotlib | 3.10.7 |
| networkx | 3.5 |
| scipy | 1.16.3 |
| scikit-learn | 1.7.2 |
| shapely | 2.1.2 |
| track-linearization | 2.4.0 |
These versions represent the tested configuration. neurospatial likely works with a range of versions for each dependency, but these specific versions have full test coverage.
## Quickstart
Here's a minimal example showing how to create an environment from spatial data:
```python
import numpy as np
from neurospatial import Environment
# Generate some 2D position data (e.g., from animal tracking)
# Shape: (n_samples, 2) for x, y coordinates in centimeters
position_data = np.array([
[0.0, 0.0],
[5.0, 5.0],
[10.0, 10.0],
[15.0, 5.0],
[20.0, 0.0],
# ... more positions
])
# Create an environment with 2 cm bins
env = Environment.from_samples(
data_samples=position_data,
bin_size=2.0, # 2 cm bins
name="OpenField"
)
# Query the environment
print(f"Environment has {env.n_bins} bins")
print(f"Dimensions: {env.n_dims}D")
print(f"Extent: {env.dimension_ranges}")
# Map a point to its bin
point = np.array([[10.5, 10.2]])
bin_idx = env.bin_at(point)
print(f"Point {point[0]} is in bin {bin_idx[0]}")
# Find neighbors of a bin
neighbors = env.neighbors(bin_idx[0])
print(f"Bin {bin_idx[0]} has {len(neighbors)} neighbors")
# Visualize the environment
import matplotlib.pyplot as plt
fig, ax = plt.subplots()
env.plot(ax=ax)
plt.show()
```
## Core Concepts
### Bins and Active Bins
neurospatial discretizes continuous space into **bins** (also called nodes). Each bin represents a region of space with a center coordinate and (optionally) a size.
**Active bins** are bins that contain actual data or are considered part of the environment. When creating an environment from data samples, neurospatial can automatically infer which bins should be active based on:
- Data occupancy (bins with enough samples)
- Morphological operations (filling gaps, connecting nearby regions)
- Explicit masks or polygons
This is essential for neuroscience applications where you want to focus on visited areas while excluding walls, obstacles, or unvisited regions.
### Connectivity Graphs
Each environment includes a **connectivity graph** (NetworkX `Graph`) defining which bins are neighbors. This graph powers spatial queries like:
- Finding shortest paths between locations
- Computing geodesic (manifold) distances
- Determining local neighborhoods
The connectivity graph includes mandatory metadata on all nodes and edges (positions, distances, vectors, indices) for robust spatial operations.
### Layout Engines
Layout engines define **how** space is discretized. Available engines include:
- **RegularGridLayout**: Standard rectangular/cuboid grids
- **HexagonalLayout**: Hexagonal tessellations (more uniform neighbor distances)
- **GraphLayout**: 1D linearized tracks for maze/track experiments
- **MaskedGridLayout**: Grids with arbitrary active/inactive regions
- **ImageMaskLayout**: Binary image-based layouts
- **ShapelyPolygonLayout**: Polygon-bounded grids
- **TriangularMeshLayout**: Triangular tessellations
You typically don't interact with layout engines directly; instead, use the `Environment` factory methods which select the appropriate engine for you.
## Common Use Cases
### 1. Analyzing Animal Position Data
```python
# Load position tracking data
position = load_tracking_data() # Shape: (n_timepoints, 2)
# Create environment with 5 cm bins, auto-detect active areas
env = Environment.from_samples(
data_samples=position,
bin_size=5.0, # cm
infer_active_bins=True,
dilate=True, # Expand active region
fill_holes=True, # Fill small gaps
name="Experiment1_OpenField"
)
# Compute occupancy
time_in_bin, _ = np.histogram(
env.bin_at(position),
bins=np.arange(env.n_bins + 1)
)
```
### 2. Creating Masked Environments
```python
from shapely.geometry import Polygon
# Define a circular arena (80 cm diameter)
theta = np.linspace(0, 2*np.pi, 100)
boundary = np.column_stack([40 * np.cos(theta), 40 * np.sin(theta)])
polygon = Polygon(boundary)
# Create environment bounded by polygon
env = Environment.from_polygon(
polygon=polygon,
bin_size=2.5, # cm
name="CircularArena"
)
```
### 3. Linearizing Track Mazes
```python
import networkx as nx
# Define track graph (e.g., plus maze)
graph = nx.Graph()
graph.add_node(0, pos=(0.0, 0.0)) # center
graph.add_node(1, pos=(0.0, 50.0)) # north arm
graph.add_node(2, pos=(50.0, 0.0)) # east arm
graph.add_node(3, pos=(0.0, -50.0)) # south arm
graph.add_node(4, pos=(-50.0, 0.0)) # west arm
graph.add_edge(0, 1, edge_id=0, distance=50.0)
graph.add_edge(0, 2, edge_id=1, distance=50.0)
graph.add_edge(0, 3, edge_id=2, distance=50.0)
graph.add_edge(0, 4, edge_id=3, distance=50.0)
# Create 1D linearized environment
env = Environment.from_graph(
graph=graph,
edge_order=[(4, 0), (0, 1), (0, 2), (0, 3)], # traversal order
edge_spacing=0.0, # no gaps between edges
bin_size=2.0, # cm
name="PlusMaze"
)
# Convert 2D positions to 1D linearized coordinates
position_2d = np.array([[25.0, 0.0]]) # halfway down east arm
position_1d = env.to_linear(position_2d)
# And back
position_2d_reconstructed = env.linear_to_nd(position_1d)
```
### 4. Defining Regions of Interest
```python
from shapely.geometry import Point
# Create environment
env = Environment.from_samples(position_data, bin_size=3.0)
# Define reward zones as circular regions (buffered points)
reward1_polygon = Point(10.0, 10.0).buffer(5.0) # 5 cm radius circle
reward2_polygon = Point(30.0, 30.0).buffer(5.0)
env.regions.add("RewardZone1", polygon=reward1_polygon)
env.regions.add("RewardZone2", polygon=reward2_polygon)
# Or add a point region
env.regions.add("StartLocation", point=(0.0, 0.0))
# Access region information
print(f"Number of regions: {len(env.regions)}")
print(f"Region names: {env.regions.list_names()}")
# Get region statistics
area = env.regions.area("RewardZone1")
center = env.regions.region_center("RewardZone1")
print(f"RewardZone1 area: {area:.2f}, center: {center}")
```
## Documentation
- **[Documentation Home](https://edeno.github.io/neurospatial/)**: Complete documentation site
- **[Getting Started](https://edeno.github.io/neurospatial/getting-started/installation/)**: Installation and quickstart guide
- **[User Guide](https://edeno.github.io/neurospatial/user-guide/)**: Detailed feature documentation
- **[API Reference](https://edeno.github.io/neurospatial/api/)**: Auto-generated API documentation
- **[Examples](https://edeno.github.io/neurospatial/examples/)**: Jupyter notebooks with real-world use cases
- **[Contributing](https://edeno.github.io/neurospatial/contributing/)**: Guidelines for contributors
- **[CLAUDE.md](CLAUDE.md)**: Development guide for Claude Code users
- **[GitHub Issues](https://github.com/edeno/neurospatial/issues)**: Bug reports and feature requests
## Project Structure
```text
neurospatial/
├── src/neurospatial/
│ ├── environment.py # Main Environment class
│ ├── composite.py # CompositeEnvironment for multi-env merging
│ ├── alignment.py # Probability distribution transforms
│ ├── transforms.py # 2D affine transformations
│ ├── layout/
│ │ ├── base.py # LayoutEngine protocol
│ │ ├── factories.py # Layout factory functions
│ │ └── engines/ # Concrete layout implementations
│ └── regions/
│ ├── core.py # Region and Regions classes
│ └── serialization.py # JSON I/O for regions
└── tests/ # Comprehensive test suite
```
## Requirements
- Python 3.10+
- numpy >= 1.24.0
- pandas >= 2.0.0
- matplotlib >= 3.7.0
- networkx >= 3.0
- scipy >= 1.10.0
- scikit-learn >= 1.2.0
- shapely >= 2.0.0
- track-linearization >= 2.4.0
## Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes with tests
4. Run the test suite (`uv run pytest`)
5. Run code quality checks (`uv run ruff check . && uv run ruff format .`)
6. Commit your changes (`git commit -m 'Add amazing feature'`)
7. Push to the branch (`git push origin feature/amazing-feature`)
8. Open a Pull Request
See [CLAUDE.md](CLAUDE.md) for detailed development guidelines.
## Citation
If you use neurospatial in your research, please cite:
```bibtex
@software{neurospatial2025,
author = {Denovellis, Eric},
title = {neurospatial: Spatial environment discretization for neuroscience},
year = {2025},
url = {https://github.com/edeno/neurospatial},
version = {0.1.0}
}
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- Built with [NetworkX](https://networkx.org/) for graph operations
- Uses [Shapely](https://shapely.readthedocs.io/) for geometric operations
- Leverages [track-linearization](https://github.com/Eden-Kramer-Lab/track_linearization) for 1D linearization
- Inspired by spatial analysis needs in systems neuroscience research
## Contact
### Eric Denovellis
- Email: <eric.denovellis@ucsf.edu>
- GitHub: [@edeno](https://github.com/edeno)
- Issues: [GitHub Issues](https://github.com/edeno/neurospatial/issues)
---
**Status**: Alpha - API may change. Contributions and feedback welcome!
Raw data
{
"_id": null,
"home_page": null,
"name": "neurospatial",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "discretization, navigation, neuroscience, place-fields, spatial",
"author": null,
"author_email": "Eric Denovellis <eric.denovellis@ucsf.edu>",
"download_url": "https://files.pythonhosted.org/packages/86/8e/695d295065c4122d356ec85f58fb52a346a3a45f6dcfdd5668c5f1fb666b/neurospatial-0.2.0.tar.gz",
"platform": null,
"description": "# neurospatial\n\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n\n**neurospatial** is a Python library for discretizing continuous N-dimensional spatial environments into bins/nodes with connectivity graphs. It provides tools for spatial analysis, particularly for neuroscience applications involving place fields, position tracking, and spatial navigation.\n\nWhether you're analyzing animal navigation data, modeling place cells, or working with any spatial discretization problem, neurospatial gives you flexible, powerful tools to represent and analyze spatial environments.\n\n## Key Features\n\n- **Multiple Layout Engines**: Choose from regular grids, hexagonal tessellations, masked regions, polygon-bounded areas, triangular meshes, and 1D linearized tracks\n- **Automatic Bin Detection**: Infer active bins from data samples with morphological operations (dilation, closing, hole filling)\n- **Connectivity Graphs**: Built-in NetworkX graphs with mandatory node/edge metadata for spatial queries\n- **1D Linearization**: Transform complex 2D environments into 1D linearized coordinates for track-based analysis\n- **Spatial Queries**: Point-to-bin mapping, neighbor finding, shortest paths, geodesic distances\n- **Region Support**: Define and manage named regions of interest (ROIs) with immutable semantics\n- **Environment Composition**: Merge multiple environments with automatic bridge inference\n- **Alignment Tools**: Transform and map probability distributions between environments\n- **Type-Safe Protocol Design**: Layout engines implement protocols, not inheritance, for maximum flexibility\n\n## Installation\n\n### From PyPI (when released)\n\n```bash\npip install neurospatial\n```\n\n### For Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/edeno/neurospatial.git\ncd neurospatial\n\n# Install with uv (recommended)\nuv sync\n\n# Or with pip\npip install -e \".[dev]\"\n```\n\n**Note**: This project uses `uv` for package management. If you have `uv` installed, all commands should be prefixed with `uv run` (e.g., `uv run pytest`).\n\n### Tested Dependency Versions\n\nneurospatial v0.1.0 has been tested with the following dependency versions:\n\n| Package | Tested Version |\n|---------|---------------|\n| Python | 3.13.5 |\n| numpy | 2.3.4 |\n| pandas | 2.3.3 |\n| matplotlib | 3.10.7 |\n| networkx | 3.5 |\n| scipy | 1.16.3 |\n| scikit-learn | 1.7.2 |\n| shapely | 2.1.2 |\n| track-linearization | 2.4.0 |\n\nThese versions represent the tested configuration. neurospatial likely works with a range of versions for each dependency, but these specific versions have full test coverage.\n\n## Quickstart\n\nHere's a minimal example showing how to create an environment from spatial data:\n\n```python\nimport numpy as np\nfrom neurospatial import Environment\n\n# Generate some 2D position data (e.g., from animal tracking)\n# Shape: (n_samples, 2) for x, y coordinates in centimeters\nposition_data = np.array([\n [0.0, 0.0],\n [5.0, 5.0],\n [10.0, 10.0],\n [15.0, 5.0],\n [20.0, 0.0],\n # ... more positions\n])\n\n# Create an environment with 2 cm bins\nenv = Environment.from_samples(\n data_samples=position_data,\n bin_size=2.0, # 2 cm bins\n name=\"OpenField\"\n)\n\n# Query the environment\nprint(f\"Environment has {env.n_bins} bins\")\nprint(f\"Dimensions: {env.n_dims}D\")\nprint(f\"Extent: {env.dimension_ranges}\")\n\n# Map a point to its bin\npoint = np.array([[10.5, 10.2]])\nbin_idx = env.bin_at(point)\nprint(f\"Point {point[0]} is in bin {bin_idx[0]}\")\n\n# Find neighbors of a bin\nneighbors = env.neighbors(bin_idx[0])\nprint(f\"Bin {bin_idx[0]} has {len(neighbors)} neighbors\")\n\n# Visualize the environment\nimport matplotlib.pyplot as plt\nfig, ax = plt.subplots()\nenv.plot(ax=ax)\nplt.show()\n```\n\n## Core Concepts\n\n### Bins and Active Bins\n\nneurospatial discretizes continuous space into **bins** (also called nodes). Each bin represents a region of space with a center coordinate and (optionally) a size.\n\n**Active bins** are bins that contain actual data or are considered part of the environment. When creating an environment from data samples, neurospatial can automatically infer which bins should be active based on:\n\n- Data occupancy (bins with enough samples)\n- Morphological operations (filling gaps, connecting nearby regions)\n- Explicit masks or polygons\n\nThis is essential for neuroscience applications where you want to focus on visited areas while excluding walls, obstacles, or unvisited regions.\n\n### Connectivity Graphs\n\nEach environment includes a **connectivity graph** (NetworkX `Graph`) defining which bins are neighbors. This graph powers spatial queries like:\n\n- Finding shortest paths between locations\n- Computing geodesic (manifold) distances\n- Determining local neighborhoods\n\nThe connectivity graph includes mandatory metadata on all nodes and edges (positions, distances, vectors, indices) for robust spatial operations.\n\n### Layout Engines\n\nLayout engines define **how** space is discretized. Available engines include:\n\n- **RegularGridLayout**: Standard rectangular/cuboid grids\n- **HexagonalLayout**: Hexagonal tessellations (more uniform neighbor distances)\n- **GraphLayout**: 1D linearized tracks for maze/track experiments\n- **MaskedGridLayout**: Grids with arbitrary active/inactive regions\n- **ImageMaskLayout**: Binary image-based layouts\n- **ShapelyPolygonLayout**: Polygon-bounded grids\n- **TriangularMeshLayout**: Triangular tessellations\n\nYou typically don't interact with layout engines directly; instead, use the `Environment` factory methods which select the appropriate engine for you.\n\n## Common Use Cases\n\n### 1. Analyzing Animal Position Data\n\n```python\n# Load position tracking data\nposition = load_tracking_data() # Shape: (n_timepoints, 2)\n\n# Create environment with 5 cm bins, auto-detect active areas\nenv = Environment.from_samples(\n data_samples=position,\n bin_size=5.0, # cm\n infer_active_bins=True,\n dilate=True, # Expand active region\n fill_holes=True, # Fill small gaps\n name=\"Experiment1_OpenField\"\n)\n\n# Compute occupancy\ntime_in_bin, _ = np.histogram(\n env.bin_at(position),\n bins=np.arange(env.n_bins + 1)\n)\n```\n\n### 2. Creating Masked Environments\n\n```python\nfrom shapely.geometry import Polygon\n\n# Define a circular arena (80 cm diameter)\ntheta = np.linspace(0, 2*np.pi, 100)\nboundary = np.column_stack([40 * np.cos(theta), 40 * np.sin(theta)])\npolygon = Polygon(boundary)\n\n# Create environment bounded by polygon\nenv = Environment.from_polygon(\n polygon=polygon,\n bin_size=2.5, # cm\n name=\"CircularArena\"\n)\n```\n\n### 3. Linearizing Track Mazes\n\n```python\nimport networkx as nx\n\n# Define track graph (e.g., plus maze)\ngraph = nx.Graph()\ngraph.add_node(0, pos=(0.0, 0.0)) # center\ngraph.add_node(1, pos=(0.0, 50.0)) # north arm\ngraph.add_node(2, pos=(50.0, 0.0)) # east arm\ngraph.add_node(3, pos=(0.0, -50.0)) # south arm\ngraph.add_node(4, pos=(-50.0, 0.0)) # west arm\n\ngraph.add_edge(0, 1, edge_id=0, distance=50.0)\ngraph.add_edge(0, 2, edge_id=1, distance=50.0)\ngraph.add_edge(0, 3, edge_id=2, distance=50.0)\ngraph.add_edge(0, 4, edge_id=3, distance=50.0)\n\n# Create 1D linearized environment\nenv = Environment.from_graph(\n graph=graph,\n edge_order=[(4, 0), (0, 1), (0, 2), (0, 3)], # traversal order\n edge_spacing=0.0, # no gaps between edges\n bin_size=2.0, # cm\n name=\"PlusMaze\"\n)\n\n# Convert 2D positions to 1D linearized coordinates\nposition_2d = np.array([[25.0, 0.0]]) # halfway down east arm\nposition_1d = env.to_linear(position_2d)\n\n# And back\nposition_2d_reconstructed = env.linear_to_nd(position_1d)\n```\n\n### 4. Defining Regions of Interest\n\n```python\nfrom shapely.geometry import Point\n\n# Create environment\nenv = Environment.from_samples(position_data, bin_size=3.0)\n\n# Define reward zones as circular regions (buffered points)\nreward1_polygon = Point(10.0, 10.0).buffer(5.0) # 5 cm radius circle\nreward2_polygon = Point(30.0, 30.0).buffer(5.0)\n\nenv.regions.add(\"RewardZone1\", polygon=reward1_polygon)\nenv.regions.add(\"RewardZone2\", polygon=reward2_polygon)\n\n# Or add a point region\nenv.regions.add(\"StartLocation\", point=(0.0, 0.0))\n\n# Access region information\nprint(f\"Number of regions: {len(env.regions)}\")\nprint(f\"Region names: {env.regions.list_names()}\")\n\n# Get region statistics\narea = env.regions.area(\"RewardZone1\")\ncenter = env.regions.region_center(\"RewardZone1\")\nprint(f\"RewardZone1 area: {area:.2f}, center: {center}\")\n```\n\n## Documentation\n\n- **[Documentation Home](https://edeno.github.io/neurospatial/)**: Complete documentation site\n- **[Getting Started](https://edeno.github.io/neurospatial/getting-started/installation/)**: Installation and quickstart guide\n- **[User Guide](https://edeno.github.io/neurospatial/user-guide/)**: Detailed feature documentation\n- **[API Reference](https://edeno.github.io/neurospatial/api/)**: Auto-generated API documentation\n- **[Examples](https://edeno.github.io/neurospatial/examples/)**: Jupyter notebooks with real-world use cases\n- **[Contributing](https://edeno.github.io/neurospatial/contributing/)**: Guidelines for contributors\n- **[CLAUDE.md](CLAUDE.md)**: Development guide for Claude Code users\n- **[GitHub Issues](https://github.com/edeno/neurospatial/issues)**: Bug reports and feature requests\n\n## Project Structure\n\n```text\nneurospatial/\n\u251c\u2500\u2500 src/neurospatial/\n\u2502 \u251c\u2500\u2500 environment.py # Main Environment class\n\u2502 \u251c\u2500\u2500 composite.py # CompositeEnvironment for multi-env merging\n\u2502 \u251c\u2500\u2500 alignment.py # Probability distribution transforms\n\u2502 \u251c\u2500\u2500 transforms.py # 2D affine transformations\n\u2502 \u251c\u2500\u2500 layout/\n\u2502 \u2502 \u251c\u2500\u2500 base.py # LayoutEngine protocol\n\u2502 \u2502 \u251c\u2500\u2500 factories.py # Layout factory functions\n\u2502 \u2502 \u2514\u2500\u2500 engines/ # Concrete layout implementations\n\u2502 \u2514\u2500\u2500 regions/\n\u2502 \u251c\u2500\u2500 core.py # Region and Regions classes\n\u2502 \u2514\u2500\u2500 serialization.py # JSON I/O for regions\n\u2514\u2500\u2500 tests/ # Comprehensive test suite\n```\n\n## Requirements\n\n- Python 3.10+\n- numpy >= 1.24.0\n- pandas >= 2.0.0\n- matplotlib >= 3.7.0\n- networkx >= 3.0\n- scipy >= 1.10.0\n- scikit-learn >= 1.2.0\n- shapely >= 2.0.0\n- track-linearization >= 2.4.0\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes with tests\n4. Run the test suite (`uv run pytest`)\n5. Run code quality checks (`uv run ruff check . && uv run ruff format .`)\n6. Commit your changes (`git commit -m 'Add amazing feature'`)\n7. Push to the branch (`git push origin feature/amazing-feature`)\n8. Open a Pull Request\n\nSee [CLAUDE.md](CLAUDE.md) for detailed development guidelines.\n\n## Citation\n\nIf you use neurospatial in your research, please cite:\n\n```bibtex\n@software{neurospatial2025,\n author = {Denovellis, Eric},\n title = {neurospatial: Spatial environment discretization for neuroscience},\n year = {2025},\n url = {https://github.com/edeno/neurospatial},\n version = {0.1.0}\n}\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Built with [NetworkX](https://networkx.org/) for graph operations\n- Uses [Shapely](https://shapely.readthedocs.io/) for geometric operations\n- Leverages [track-linearization](https://github.com/Eden-Kramer-Lab/track_linearization) for 1D linearization\n- Inspired by spatial analysis needs in systems neuroscience research\n\n## Contact\n\n### Eric Denovellis\n\n- Email: <eric.denovellis@ucsf.edu>\n- GitHub: [@edeno](https://github.com/edeno)\n- Issues: [GitHub Issues](https://github.com/edeno/neurospatial/issues)\n\n---\n\n**Status**: Alpha - API may change. Contributions and feedback welcome!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Discretize continuous N-dimensional spatial environments into bins/nodes with connectivity graphs",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/edeno/neurospatial",
"Issues": "https://github.com/edeno/neurospatial/issues",
"Repository": "https://github.com/edeno/neurospatial"
},
"split_keywords": [
"discretization",
" navigation",
" neuroscience",
" place-fields",
" spatial"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "51ac9c8602697bf74bced40b6a63befbac03b5a2f2a862f119c35c5b8af8d9e2",
"md5": "a04a1810418c3b7dbf3c48b399772ff7",
"sha256": "8741bd8a1a7a09a1033e5f8eb1f4eae14a2734cc3774a003c251e01435b7e24a"
},
"downloads": -1,
"filename": "neurospatial-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a04a1810418c3b7dbf3c48b399772ff7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 185971,
"upload_time": "2025-11-04T15:28:08",
"upload_time_iso_8601": "2025-11-04T15:28:08.016927Z",
"url": "https://files.pythonhosted.org/packages/51/ac/9c8602697bf74bced40b6a63befbac03b5a2f2a862f119c35c5b8af8d9e2/neurospatial-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "868e695d295065c4122d356ec85f58fb52a346a3a45f6dcfdd5668c5f1fb666b",
"md5": "57d767a2326a21b91249c9c8173e9aca",
"sha256": "0cf943f5df19dd6893de4ea55982d8e3decdd4b10650a38c6fa71b08cc28f910"
},
"downloads": -1,
"filename": "neurospatial-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "57d767a2326a21b91249c9c8173e9aca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 12255096,
"upload_time": "2025-11-04T15:28:10",
"upload_time_iso_8601": "2025-11-04T15:28:10.129223Z",
"url": "https://files.pythonhosted.org/packages/86/8e/695d295065c4122d356ec85f58fb52a346a3a45f6dcfdd5668c5f1fb666b/neurospatial-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-04 15:28:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "edeno",
"github_project": "neurospatial",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "neurospatial"
}
JSON
