Storage#

Persistence adapters for analytical and operational Space PV data.

class space_pv_storage.DuckDBStore(path)[source]#

Local analytical store for telemetry, derived features and lab outputs.

DuckDB is deliberately kept separate from operational job metadata. It is the lightweight default for notebooks, batch research and reproducible local labs.

Parameters:

path (str | Path)

refresh_telemetry_rollup(satellite_id, signal, bucket_seconds=60)[source]#

Build a compact min/max/avg/last cache for fast chart rendering.

Parameters:
  • satellite_id (str)

  • signal (str)

  • bucket_seconds (int)

Return type:

None

class space_pv_storage.JobRun(**kwargs)[source]#
class space_pv_storage.JobStatus(*values)[source]#
class space_pv_storage.StorageSettings(_case_sensitive=None, _nested_model_default_partial_update=None, _env_prefix=None, _env_prefix_target=None, _env_file=PosixPath('.'), _env_file_encoding=None, _env_file_depth=None, _env_ignore_empty=None, _env_nested_delimiter=None, _env_nested_max_split=None, _env_parse_none_str=None, _env_parse_enums=None, _cli_prog_name=None, _cli_parse_args=None, _cli_settings_source=None, _cli_parse_none_str=None, _cli_hide_none_type=None, _cli_avoid_json=None, _cli_enforce_required=None, _cli_use_class_docs_for_groups=None, _cli_show_env_vars=None, _cli_exit_on_error=None, _cli_prefix=None, _cli_flag_prefix_char=None, _cli_implicit_flags=None, _cli_ignore_unknown_args=None, _cli_kebab_case=None, _cli_shortcuts=None, _secrets_dir=None, _build_sources=None, *, postgres_dsn='postgresql+psycopg://spacepv:spacepv@localhost:5432/spacepv', duckdb_path=PosixPath('data/space_pv.duckdb'))[source]#

Storage configuration shared by API, workers and local labs.

Parameters:
  • _case_sensitive (bool | None)

  • _nested_model_default_partial_update (bool | None)

  • _env_prefix (str | None)

  • _env_prefix_target (EnvPrefixTarget | None)

  • _env_file (DotenvType | None)

  • _env_file_encoding (str | None)

  • _env_file_depth (int | None)

  • _env_ignore_empty (bool | None)

  • _env_nested_delimiter (str | None)

  • _env_nested_max_split (int | None)

  • _env_parse_none_str (str | None)

  • _env_parse_enums (bool | None)

  • _cli_prog_name (str | None)

  • _cli_parse_args (bool | list[str] | tuple[str, ...] | None)

  • _cli_settings_source (CliSettingsSource[Any] | None)

  • _cli_parse_none_str (str | None)

  • _cli_hide_none_type (bool | None)

  • _cli_avoid_json (bool | None)

  • _cli_enforce_required (bool | None)

  • _cli_use_class_docs_for_groups (bool | None)

  • _cli_show_env_vars (bool | None)

  • _cli_exit_on_error (bool | None)

  • _cli_prefix (str | None)

  • _cli_flag_prefix_char (str | None)

  • _cli_implicit_flags (bool | Literal['dual', 'toggle'] | None)

  • _cli_ignore_unknown_args (bool | None)

  • _cli_kebab_case (bool | Literal['all', 'no_enums'] | None)

  • _cli_shortcuts (Mapping[str, str | list[str]] | None)

  • _secrets_dir (PathType | None)

  • _build_sources (tuple[tuple[PydanticBaseSettingsSource, ...], dict[str, Any]] | None)

  • postgres_dsn (str)

  • duckdb_path (Path)

model_config = {'arbitrary_types_allowed': True, 'case_sensitive': False, 'cli_avoid_json': False, 'cli_enforce_required': False, 'cli_exit_on_error': True, 'cli_flag_prefix_char': '-', 'cli_hide_none_type': False, 'cli_ignore_unknown_args': False, 'cli_implicit_flags': False, 'cli_kebab_case': False, 'cli_parse_args': None, 'cli_parse_none_str': None, 'cli_prefix': '', 'cli_prog_name': None, 'cli_shortcuts': None, 'cli_show_env_vars': False, 'cli_use_class_docs_for_groups': False, 'enable_decoding': True, 'env_file': '.env', 'env_file_depth': 0, 'env_file_encoding': None, 'env_ignore_empty': False, 'env_nested_delimiter': None, 'env_nested_max_split': None, 'env_parse_enums': None, 'env_parse_none_str': None, 'env_prefix': 'SPACE_PV_', 'env_prefix_target': 'variable', 'extra': 'ignore', 'json_file': None, 'json_file_encoding': None, 'nested_model_default_partial_update': False, 'protected_namespaces': ('model_validate', 'model_dump', 'settings_cached', 'settings_clear_cache', 'settings_customise_sources'), 'secrets_case_sensitive': None, 'secrets_dir': None, 'secrets_dir_max_size': None, 'secrets_dir_missing': None, 'secrets_nested_delimiter': None, 'secrets_nested_subdir': None, 'secrets_prefix': None, 'toml_file': None, 'validate_default': True, 'yaml_config_section': None, 'yaml_file': None, 'yaml_file_encoding': None}#

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

DuckDB#

class space_pv_storage.duckdb_store.DuckDBStore(path)[source]#

Local analytical store for telemetry, derived features and lab outputs.

DuckDB is deliberately kept separate from operational job metadata. It is the lightweight default for notebooks, batch research and reproducible local labs.

Parameters:

path (str | Path)

refresh_telemetry_rollup(satellite_id, signal, bucket_seconds=60)[source]#

Build a compact min/max/avg/last cache for fast chart rendering.

Parameters:
  • satellite_id (str)

  • signal (str)

  • bucket_seconds (int)

Return type:

None

PostgreSQL jobs#

class space_pv_storage.postgres.JobStatus(*values)[source]#
class space_pv_storage.postgres.JobRun(**kwargs)[source]#

Map serving#