Fitting and workflow API

qsospec.fit_local(spectrum, config)

Fit one or more local line-complex windows independently.

Parameters:

• spectrum (Spectrum)

• config (LocalFitConfig)

Return type:

LocalFitResult

qsospec.fit_line_complex(spectrum, config, jacobian=None)

Fit one local Gaussian line complex on the spectrum rest-frame grid.

Parameters:

• spectrum (Spectrum)

• config (LineComplexConfig)

• jacobian (str | None)

Return type:

FitResult

qsospec.fit_global_continuum(spectrum, config=None, *, compute_covariance=True)

Fit the global AGN continuum and resolve automatic power-law mode.

Parameters:

• spectrum (Spectrum)

• config (GlobalContinuumConfig | None)

• compute_covariance (bool)

Return type:

GlobalContinuumResult

qsospec.fit_hbeta_complex(spectrum, continuum_result, config=None, *, compute_covariance=True)

Fit core-only and optional wing H-beta/[O III] candidates.

Parameters:

• spectrum (Spectrum)

• continuum_result (GlobalContinuumResult)

• config (HbetaComplexConfig | None)

• compute_covariance (bool)

Return type:

EmissionComplexResult

qsospec.fit_mgii_complex(spectrum, continuum_result, config=None, *, compute_covariance=True)

Fit two broad Mg II components plus one narrow component.

Parameters:

• spectrum (Spectrum)

• continuum_result (GlobalContinuumResult)

• config (MgIIComplexConfig | None)

• compute_covariance (bool)

Return type:

EmissionComplexResult

qsospec.fit_halpha_complex(spectrum, continuum_result, config=None, *, compute_covariance=True)

Fit broad H-alpha plus tied narrow H-alpha/[N II]/[S II].

Parameters:

• spectrum (Spectrum)

• continuum_result (GlobalContinuumResult)

• config (HalphaComplexConfig | None)

• compute_covariance (bool)

Return type:

EmissionComplexResult

qsospec.fit_global_lines(spectrum, global_config=None, hbeta_config=None, mgii_config=None, halpha_config=None, uncertainty_config=None, *, lya_nv_config=None, host_model_on_grid=None, complexes=None)

Fit the global continuum and adaptively selected emission recipes.

Parameters:

• spectrum (Spectrum)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• mgii_config (MgIIComplexConfig | None)

• halpha_config (HalphaComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

• lya_nv_config (LyaNVComplexConfig | None)

• host_model_on_grid (ndarray | None)

• complexes (Sequence[str | ComplexRecipe] | None)

Return type:

WorkflowResult

qsospec.fit_global_hbeta(spectrum, global_config=None, hbeta_config=None, uncertainty_config=None, *, host_model_on_grid=None)

Compatibility wrapper for fit_global_lines().

Parameters:

• spectrum (Spectrum)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

• host_model_on_grid (ndarray | None)

Return type:

WorkflowResult

qsospec.fit_global_lines_workflow(input_path, *, row_index=None, redshift=None, object_id=None, run_host_decomp=False, template_root='~/tools/ppxf_data', template_file='spectra_emiles_9.0.npz', host_fit_range=(3600.0, 7000.0), host_config=None, galactic_extinction_config=None, global_config=None, hbeta_config=None, mgii_config=None, halpha_config=None, lya_nv_config=None, uncertainty_config=None, complexes=None)

Read one spectrum and run optional pPXF plus global multi-line qsospec.

Parameters:

• input_path (str)

• row_index (int | None)

• redshift (float | None)

• object_id (str | None)

• run_host_decomp (bool)

• template_root (str)

• template_file (str)

• host_fit_range (Tuple[float, float])

• host_config (Any | None)

• galactic_extinction_config (GalacticExtinctionConfig | None)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• mgii_config (MgIIComplexConfig | None)

• halpha_config (HalphaComplexConfig | None)

• lya_nv_config (LyaNVComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

• complexes (Sequence[str | ComplexRecipe] | None)

Return type:

WorkflowResult

qsospec.fit_global_hbeta_workflow(input_path, *, row_index=None, redshift=None, object_id=None, run_host_decomp=False, template_root='~/tools/ppxf_data', template_file='spectra_emiles_9.0.npz', host_fit_range=(3600.0, 7000.0), host_config=None, galactic_extinction_config=None, global_config=None, hbeta_config=None, uncertainty_config=None)

Compatibility wrapper for fit_global_lines_workflow().

Parameters:

• input_path (str)

• row_index (int | None)

• redshift (float | None)

• object_id (str | None)

• run_host_decomp (bool)

• template_root (str)

• template_file (str)

• host_fit_range (Tuple[float, float])

• host_config (Any | None)

• galactic_extinction_config (GalacticExtinctionConfig | None)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

Return type:

WorkflowResult

qsospec.fit_with_optional_host_decomp(input_path, local_config=None, *, row_index=None, redshift=None, object_id=None, run_host_decomp=False, fit_kind='local', template_root='~/tools/ppxf_data', template_file='spectra_emiles_9.0.npz', host_fit_range=(3600.0, 7000.0), host_config=None, galactic_extinction_config=None, global_config=None, hbeta_config=None, mgii_config=None, halpha_config=None, lya_nv_config=None, uncertainty_config=None, complexes=None)

Read a spectrum, optionally subtract a pPXF host, then run qsospec.

fit_kind may be "local" or "global".

Parameters:

• input_path (str)

• local_config (LocalFitConfig | None)

• row_index (int | None)

• redshift (float | None)

• object_id (str | None)

• run_host_decomp (bool)

• fit_kind (str)

• template_root (str)

• template_file (str)

• host_fit_range (Tuple[float, float])

• host_config (Any | None)

• galactic_extinction_config (GalacticExtinctionConfig | None)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• mgii_config (MgIIComplexConfig | None)

• halpha_config (HalphaComplexConfig | None)

• lya_nv_config (LyaNVComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

• complexes (Sequence[str | ComplexRecipe] | None)

qsospec.fit_object_to_store(input_data, run_directory, *, row_index=None, redshift=None, object_id=None, reader='auto', flux_unit=None, flux_scale=None, run_host_decomp=False, template_root='~/tools/ppxf_data', template_file='spectra_emiles_9.0.npz', host_fit_range=(3600.0, 7000.0), host_config=None, galactic_extinction_config=None, global_config=None, hbeta_config=None, mgii_config=None, halpha_config=None, lya_nv_config=None, uncertainty_config=None, complexes=None, run_id=None, resume=True, write_qa=True, qa_plot_config=None, write_legacy_products=False)

Fit one object into the same run bundle used for batch fitting.

Parameters:

• input_data (str | SpectrumInput | SpectrumData | Spectrum)

• run_directory (str)

• row_index (int | None)

• redshift (float | None)

• object_id (str | None)

• reader (str)

• flux_unit (str | None)

• flux_scale (float | None)

• run_host_decomp (bool)

• template_root (str)

• template_file (str)

• galactic_extinction_config (GalacticExtinctionConfig | None)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• mgii_config (MgIIComplexConfig | None)

• halpha_config (HalphaComplexConfig | None)

• lya_nv_config (LyaNVComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

• complexes (Sequence[str | ComplexRecipe] | None)

• run_id (str | None)

• resume (bool)

• write_qa (bool)

• qa_plot_config (GlobalQAPlotConfig | None)

• write_legacy_products (bool)

Return type:

WorkflowResult

qsospec.fit_batch(inputs, run_directory, *, row_indices=None, filter_expression=None, parquet_batch_size=128, task_size=8, n_workers='auto', num_shards=1, shard_index=0, run_host_decomp=False, template_root='~/tools/ppxf_data', template_file='spectra_emiles_9.0.npz', host_fit_range=(3600.0, 7000.0), host_config=None, galactic_extinction_config=None, global_config=None, hbeta_config=None, mgii_config=None, halpha_config=None, lya_nv_config=None, uncertainty_config=None, complexes=None, run_id=None, resume=True, retry_failures=True, finalize=True, compact_models=False, write_legacy_products=False)

Fit a Parquet or FITS sample with resumable process parallelism.

Parameters:

• run_directory (str)

• parquet_batch_size (int)

• task_size (int)

• n_workers (int | str)

• num_shards (int)

• shard_index (int)

• run_host_decomp (bool)

• template_root (str)

• template_file (str)

• galactic_extinction_config (GalacticExtinctionConfig | None)

• global_config (GlobalContinuumConfig | None)

• hbeta_config (HbetaComplexConfig | None)

• mgii_config (MgIIComplexConfig | None)

• halpha_config (HalphaComplexConfig | None)

• lya_nv_config (LyaNVComplexConfig | None)

• uncertainty_config (UncertaintyConfig | None)

• complexes (Sequence[str | ComplexRecipe] | None)

• run_id (str | None)

• resume (bool)

• retry_failures (bool)

• finalize (bool)

• compact_models (bool)

• write_legacy_products (bool)

Return type:

BatchResult