> ## Documentation Index
> Fetch the complete documentation index at: https://systematica.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracker

> systematica.tuners.sqlite.tracker

## `SQLiteOptunaTracker`

```python theme={null}
SQLiteOptunaTracker(
    init_kwargs: Dict[str, Any] = _Nothing.NOTHING,
    log_kwargs: Dict[str, Any] = _Nothing.NOTHING,
    add_configs: Dict[str, Any] = _Nothing.NOTHING,
)
```

SQLite-enabled optimization execution tracker.

Uses Optuna's native SQLite RDBStorage for all optimization data.
Custom systematica metadata (feature\_config, notes, etc.) is stored in
Optuna's study\_user\_attributes table for dashboard visibility.

Method generated by attrs for class SQLiteOptunaTracker.

### Ancestors

* `systematica.tuners.base.BaseTracker`
* `abc.ABC`

### Class variables

* `engine: Any`: SQLAlchemy engine instance. Defaults to None.

* `session_cls: Any`: SQLAlchemy session factory.

### Instance variables

* `url: str`: Engine storage URL.

### Methods

#### `run_context`

```python theme={null}
run_context(
    self,
    **kwargs,
) ‑> Dict[str, Any]
```

Context manager for SQLite run.

**Parameters**:

| Name     | Type        | Default | Description           |
| -------- | ----------- | ------- | --------------------- |
| `kwargs` | `tp.Kwargs` | `--`    | Additional arguments. |

**Yields**:

| Type   | Description                                                                       |
| ------ | --------------------------------------------------------------------------------- |
| `dict` | Dictionary with 'storage' (Optuna RDBStorage) and 'session' (SQLAlchemy Session). |

#### `run_study`

```python theme={null}
run_study(
    self,
    objective: Callable,
    create_study_kwargs: Dict[str, Any],
    optimize_kwargs: Dict[str, Any],
) ‑> optuna.study.study.Study
```

Run Optuna study with SQLite tracking.

**Parameters**:

| Name                  | Type        | Default | Description                                                       |
| --------------------- | ----------- | ------- | ----------------------------------------------------------------- |
| `objective`           | `callable`  | `--`    | Objective function to optimize.                                   |
| `create_study_kwargs` | `tp.Kwargs` | `--`    | Arguments for `optuna.create_study()`. Must include `study_name`. |
| `optimize_kwargs`     | `tp.Kwargs` | `--`    | Arguments for `study.optimize()`.                                 |

**Returns**:

| Type           | Description             |
| -------------- | ----------------------- |
| `optuna.Study` | Completed Optuna study. |