Supplying EVE Frontier Datasets for analysis and visualization using Jupyter Notebooks.

• 🐍 Python 3.12 - Modern Python version with latest features
• 📓 Jupyter Lab & Notebook - Interactive analysis and visualization
• 📦 Poetry - Dependency management and virtual environments
• 🎯 CLI Tool - Convenient command-line interface for common tasks
• 📊 Data Science Stack - Pre-configured with pandas, numpy, matplotlib, seaborn, and plotly
• 🔧 Development Tools - pytest, black, flake8, mypy, and isort included

• Python 3.12+ - Download from python.org
• Poetry - Install from python-poetry.org (recommended via pipx)

python -m venv .venv

# Using pipx (recommended)
pipx install poetry

# Or using pip
pip install poetry

poetry install

This will:

• Create a virtual environment
• Install all dependencies (Jupyter, pandas, numpy, matplotlib, etc.)
• Install development dependencies

poetry run efds lab

poetry run efds notebook new my_analysis

This creates a new notebook at notebooks/my_analysis.ipynb with starter code.

The project includes a custom CLI tool (efds) for common tasks:

# Start Jupyter Lab
poetry run efds lab

# Start Jupyter Notebook
poetry run efds notebook

# Create a new notebook
poetry run efds notebook new <name>

# List all notebooks
poetry run efds notebook list

# Install dependencies
poetry run efds install

# Update dependencies
poetry run efds update

# Display project information
poetry run efds info

# Create and work on a new analysis
poetry run efds notebook new datasets_analysis
poetry run efds lab

# List all your notebooks
poetry run efds notebook list

# Update all dependencies to latest versions
poetry run efds update

evefrontier_datasets/
├── README.md                    # This file
├── LICENSE                      # MIT License
├── pyproject.toml              # Poetry configuration
├── notebooks/                  # Jupyter notebooks
│   └── .gitkeep
└── evefrontier_datasets/       # Python package
    ├── __init__.py
    └── cli.py                  # CLI implementation

• pandas - Data manipulation and analysis
• numpy - Numerical computing
• polars - Fast dataframe library
• plotly - Interactive visualizations

• matplotlib - Static, animated, and interactive plotting
• seaborn - Statistical data visualization

• pytest - Testing framework
• black - Code formatter
• flake8 - Linting
• mypy - Static type checker
• isort - Import sorting

poetry run black evefrontier_datasets/
poetry run isort evefrontier_datasets/

poetry run flake8 evefrontier_datasets/
poetry run mypy evefrontier_datasets/

poetry run pytest

To add a new package:

poetry add <package-name>

For development dependencies only:

poetry add --group dev <package-name>

poetry update

Or use the CLI:

poetry run efds update

1. Keep notebooks organized - Use the notebooks/ directory
2. Use the CLI - Create notebooks with poetry run efds notebook new <name>
3. Version control - Notebooks are tracked in git by default
4. Restart kernels - If you modify code, restart the kernel for changes to take effect

Make sure Poetry is installed and in your PATH:

poetry --version

Run poetry install to ensure all dependencies are installed:

poetry install

To activate the Poetry virtual environment directly:

poetry shell

This project is licensed under the MIT License - see the LICENSE file for details.

Scetrov