> For the complete documentation index, see [llms.txt](https://docs.rasgoml.com/rasgo-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rasgoml.com/rasgo-docs/rasgo-0.1/all-transforms/ratio_with_shrinkage.md).

# Ratio With Shrinkage

Performs empirical bayesian estimation with shrinkage towards a beta prior. Given a dataset with a numerator and a denominator, will calculate the raw ratio as numerator / denom, as well as provide an adjusted ratio that shrinks the ratio towards the observed beta prior.

This is a simplified version that establishes the priors directly from the data given a min\_cutoff count of observations.

NOTE: your data should already be aggregated before performing this operation.

## Parameters

| Name        | Type   | Description                                                                                                                                                                                                                                 | Is Optional |
| ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| numerator   | column | A column that is pre-aggregated to contain the count of positive cases                                                                                                                                                                      |             |
| denom       | column | A column that is pre-aggregated to contain the count of ALL cases                                                                                                                                                                           |             |
| min\_cutoff | int    | Enter a minimum value to limit the denominator when creating the prior estimates. Example: if estimating a batter's hitting percentage, entering 500 would limit the estimation of the priors to be only for batters with over 500 at-bats. |             |

## Example

```python
ds = rasgo.get.dataset(fqtn="BATTING_AVERAGES")

ds2 = ds.ratio_with_shrinkage(numerator = 'HITS', 
              denom = 'AT_BATS', 
              min_cutoff = 500)

```

## Source Code

{% embed url="<https://github.com/rasgointelligence/RasgoTransforms/blob/main/rasgotransforms/rasgotransforms/transforms/ratio_with_shrinkage/snowflake/ratio_with_shrinkage.sql>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rasgoml.com/rasgo-docs/rasgo-0.1/all-transforms/ratio_with_shrinkage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.