# ambric

Augmented Mixed-frequency Bayesian Regional Inference with Constraints


# Installation

``` bash
pip install ambric
```


# API overview


## Classes

Main classes provided by the package

- [Ambric](reference/Ambric.html#ambric.Ambric): Augmented Mixed-frequency Bayesian Regional Inference with Constraints


## Ambric Methods

Methods for the Ambric class

- [Ambric.__repr__](reference/Ambric.__repr__.html#ambric.Ambric.__repr__)
- [Ambric.fit](reference/Ambric.fit.html#ambric.Ambric.fit)
- [Ambric.save_trace](reference/Ambric.save_trace.html#ambric.Ambric.save_trace)
- [Ambric.populate_results](reference/Ambric.populate_results.html#ambric.Ambric.populate_results)
- [Ambric.plot_national_quarterly_vs_implied](reference/Ambric.plot_national_quarterly_vs_implied.html#ambric.Ambric.plot_national_quarterly_vs_implied)
- [Ambric.plot_regional_annual_estimate](reference/Ambric.plot_regional_annual_estimate.html#ambric.Ambric.plot_regional_annual_estimate)
- [Ambric.plot_single_region_annual_estimate](reference/Ambric.plot_single_region_annual_estimate.html#ambric.Ambric.plot_single_region_annual_estimate)
- [Ambric.plot_estimated_regional_quarterly](reference/Ambric.plot_estimated_regional_quarterly.html#ambric.Ambric.plot_estimated_regional_quarterly)
- [Ambric.plot_current_nowcast](reference/Ambric.plot_current_nowcast.html#ambric.Ambric.plot_current_nowcast)
- [Ambric.assemble_loadings_data](reference/Ambric.assemble_loadings_data.html#ambric.Ambric.assemble_loadings_data)
- [Ambric.plot_loadings_by_region](reference/Ambric.plot_loadings_by_region.html#ambric.Ambric.plot_loadings_by_region)
- [Ambric.plot_loadings_aggregate](reference/Ambric.plot_loadings_aggregate.html#ambric.Ambric.plot_loadings_aggregate)
- [Ambric.bands_indicator](reference/Ambric.bands_indicator.html#ambric.Ambric.bands_indicator)
- [Ambric.point_estimates_q_on_4q](reference/Ambric.point_estimates_q_on_4q.html#ambric.Ambric.point_estimates_q_on_4q)
- [Ambric.point_estimates_q_on_q](reference/Ambric.point_estimates_q_on_q.html#ambric.Ambric.point_estimates_q_on_q)
- [Ambric.to_index_q_on_q](reference/Ambric.to_index_q_on_q.html#ambric.Ambric.to_index_q_on_q)
- [Ambric.seasonally_adjusted_index_and_growth_by_region](reference/Ambric.seasonally_adjusted_index_and_growth_by_region.html#ambric.Ambric.seasonally_adjusted_index_and_growth_by_region)


## Functions

Utility functions

- [bands_indicator_out_of_sample_results](reference/bands_indicator_out_of_sample_results.html#ambric.bands_indicator_out_of_sample_results): Bands classification of out-of-sample trend q-on-q nowcasts
- [build_ambric_model](reference/build_ambric_model.html#ambric.build_ambric_model): Build the AMBRIC Bayesian state-space model
- [diagnostics.oos_q_on_4q_performance_table](reference/diagnostics.oos_q_on_4q_performance_table.html#ambric.diagnostics.oos_q_on_4q_performance_table)
- [diagnostics.plot_out_of_sample_nowcasts](reference/diagnostics.plot_out_of_sample_nowcasts.html#ambric.diagnostics.plot_out_of_sample_nowcasts)
- [diagnostics.plot_out_of_sample_rmse](reference/diagnostics.plot_out_of_sample_rmse.html#ambric.diagnostics.plot_out_of_sample_rmse)
- [plot_seasonally_adjusted_q_on_q_growth](reference/plot_seasonally_adjusted_q_on_q_growth.html#ambric.plot_seasonally_adjusted_q_on_q_growth): *summary*
- [prep_data_for_model_run](reference/prep_data_for_model_run.html#ambric.prep_data_for_model_run): Expects a data frame in following format:
- [run_out_of_sample_exercise](reference/run_out_of_sample_exercise.html#ambric.run_out_of_sample_exercise): Run out-of-sample exercise to evaluate model performance
- [trace_to_series](reference/trace_to_series.html#ambric.trace_to_series): Convert a trace to the relevant estimated series coming out of the model
- [trend_adjust_out_of_sample_results](reference/trend_adjust_out_of_sample_results.html#ambric.trend_adjust_out_of_sample_results)
- [utilities.generate_realistic_simulated_data](reference/utilities.generate_realistic_simulated_data.html#ambric.utilities.generate_realistic_simulated_data)
- [utilities.simulate_data](reference/utilities.simulate_data.html#ambric.utilities.simulate_data)
- [utilities.simulate_real_time_data](reference/utilities.simulate_real_time_data.html#ambric.utilities.simulate_real_time_data)


## Constants

Module-level constants and data

- [utilities.OMEGA](reference/utilities.OMEGA.html#ambric.utilities.OMEGA)


# Resources

- [llms.txt](llms.txt) -- Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) -- Comprehensive documentation for LLMs


## Reuse


MIT