mergeron 2024.738953.1__py3-none-any.whl → 2025.739265.0__py3-none-any.whl

mergeron/gen/_data_generation_functions_nonpublic.py

@@ -1,623 +0,0 @@
-"""
-Non-public functions called in data_generation.py
-"""
-
-from __future__ import annotations
-
-from importlib.metadata import version
-from typing import Literal
-
-import numpy as np
-from numpy.random import SeedSequence
-from numpy.typing import NDArray
-
-from .. import _PKG_NAME, RECConstants  # noqa: TID252
-from ..core.damodaran_margin_data import resample_mgn_data  # noqa: TID252
-from ..core.pseudorandom_numbers import (  # noqa: TID252
-    DIST_PARMS_DEFAULT,
-    MultithreadedRNG,
-    prng,
-)
-from . import (
-    FCOUNT_WTS_DEFAULT,
-    TF,
-    FM2Constants,
-    MarginDataSample,
-    MarketSampleSpec,
-    PCMConstants,
-    PriceDataSample,
-    PRIConstants,
-    ShareDataSample,
-    SHRConstants,
-    SSZConstants,
-)
-
-__version__ = version(_PKG_NAME)
-
-
-def _gen_share_data(
-    _mkt_sample_spec: MarketSampleSpec,
-    _fcount_rng_seed_seq: SeedSequence | None,
-    _mktshr_rng_seed_seq: SeedSequence,
-    _nthreads: int = 16,
-    /,
-) -> ShareDataSample:
-    """Helper function for generating share data.
-
-    Parameters
-    ----------
-    _mkt_sample_spec
-        Class specifying parameters for share-, price-, and margin-data generation
-    _fcount_rng_seed_seq
-        Seed sequence for assuring independent and, optionally, redundant streams
-    _mktshr_rng_seed_seq
-        Seed sequence for assuring independent and, optionally, redundant streams
-    _nthreads
-        Must be specified for generating repeatable random streams
-
-    Returns
-    -------
-        Arrays representing shares, diversion ratios, etc. structured as a :ShareDataSample:
-
-    """
-
-    _recapture_spec, _dist_type_mktshr, _dist_parms_mktshr, _firm_count_prob_wts_raw = (
-        getattr(_mkt_sample_spec.share_spec, _f)
-        for _f in ("recapture_spec", "dist_type", "dist_parms", "firm_counts_weights")
-    )
-
-    _ssz = _mkt_sample_spec.sample_size
-
-    _r_bar = _mkt_sample_spec.recapture_rate or 0.80
-
-    match _dist_type_mktshr:
-        case SHRConstants.UNI:
-            _mkt_share_sample = _gen_market_shares_uniform(
-                _ssz, _dist_parms_mktshr, _mktshr_rng_seed_seq, _nthreads
-            )
-
-        case _ if _dist_type_mktshr.name.startswith("DIR_"):
-            _firm_count_prob_wts = (
-                None
-                if _firm_count_prob_wts_raw is None
-                else np.array(_firm_count_prob_wts_raw, dtype=np.float64)
-            )
-            _mkt_share_sample = _gen_market_shares_dirichlet_multisample(
-                _ssz,
-                _recapture_spec,
-                _dist_type_mktshr,
-                _dist_parms_mktshr,
-                _firm_count_prob_wts,
-                _fcount_rng_seed_seq,
-                _mktshr_rng_seed_seq,
-                _nthreads,
-            )
-
-        case _:
-            raise ValueError(
-                f'Unexpected type, "{_dist_type_mktshr}" for share distribution.'
-            )
-
-    # If recapture_spec == "inside-out", recalculate _aggregate_purchase_prob
-    _frmshr_array = _mkt_share_sample.mktshr_array[:, :2]
-    if _recapture_spec == RECConstants.INOUT:
-        _mkt_share_sample = ShareDataSample(
-            _mkt_share_sample.mktshr_array,
-            _mkt_share_sample.fcounts,
-            _mkt_share_sample.nth_firm_share,
-            _r_bar / (1 - (1 - _r_bar) * _frmshr_array.min(axis=1, keepdims=True)),
-        )
-
-    return _mkt_share_sample
-
-
-def _gen_market_shares_uniform(
-    _s_size: int = 10**6,
-    _dist_parms_mktshr: NDArray[np.floating[TF]] | None = DIST_PARMS_DEFAULT,  # type: ignore
-    _mktshr_rng_seed_seq: SeedSequence | None = None,
-    _nthreads: int = 16,
-    /,
-) -> ShareDataSample:
-    """Generate merging-firm shares from Uniform distribution on the 3-D simplex.
-
-    Parameters
-    ----------
-    _s_size
-        size of sample to be drawn
-    _r_bar
-        market recapture rate
-    _mktshr_rng_seed_seq
-        seed for rng, so results can be made replicable
-    _nthreads
-        number of threads for random number generation
-
-    Returns
-    -------
-        market shares and other market statistics for each draw (market)
-
-    """
-
-    _frmshr_array = np.empty((_s_size, 2), dtype=np.float64)
-    _dist_parms_mktshr: NDArray[np.floating[TF]] = (
-        DIST_PARMS_DEFAULT if _dist_parms_mktshr is None else _dist_parms_mktshr  # type: ignore
-    )
-    _mrng = MultithreadedRNG(
-        _frmshr_array,
-        dist_type="Uniform",
-        dist_parms=_dist_parms_mktshr,
-        seed_sequence=_mktshr_rng_seed_seq,
-        nthreads=_nthreads,
-    )
-    _mrng.fill()
-    # Convert draws on U[0, 1] to Uniformly-distributed draws on simplex, s_1 + s_2 < 1
-    _frmshr_array = np.sort(_frmshr_array, axis=1)
-    _frmshr_array = np.column_stack((
-        _frmshr_array[:, 0],
-        _frmshr_array[:, 1] - _frmshr_array[:, 0],
-    ))
-
-    # Keep only share combinations representing feasible mergers
-    _frmshr_array = _frmshr_array[_frmshr_array.min(axis=1) > 0]
-
-    # Let a third column have values of "np.nan", so HHI calculations return "np.nan"
-    _mktshr_array = np.pad(
-        _frmshr_array, ((0, 0), (0, 1)), "constant", constant_values=np.nan
-    )
-
-    _fcounts: NDArray[np.int64] = np.ones((_s_size, 1), np.int64) * np.nan  # type: ignore
-    _nth_firm_share, _aggregate_purchase_prob = (
-        np.nan * np.ones((_s_size, 1), np.float64) for _ in range(2)
-    )
-
-    return ShareDataSample(
-        _mktshr_array, _fcounts, _nth_firm_share, _aggregate_purchase_prob
-    )
-
-
-def _gen_market_shares_dirichlet_multisample(
-    _s_size: int = 10**6,
-    _recapture_spec: RECConstants = RECConstants.INOUT,
-    _dist_type_dir: SHRConstants = SHRConstants.DIR_FLAT,
-    _dist_parms_dir: NDArray[np.floating[TF]] | None = None,
-    _firm_count_wts: NDArray[np.floating[TF]] | None = None,  # type: ignore
-    _fcount_rng_seed_seq: SeedSequence | None = None,
-    _mktshr_rng_seed_seq: SeedSequence | None = None,
-    _nthreads: int = 16,
-    /,
-) -> ShareDataSample:
-    """Dirichlet-distributed shares with multiple firm-counts.
-
-    Firm-counts may be specified as having Uniform distribution over the range
-    of firm counts, or a set of probability weights may be specified. In the
-    latter case the proportion of draws for each firm-count matches the
-    specified probability weight.
-
-    Parameters
-    ----------
-    _s_size
-        sample size to be drawn
-    _r_bar
-        market recapture rate
-    _firm_count_wts
-        firm count weights array for sample to be drawn
-    _dist_type_dir
-        Whether Dirichlet is Flat or Asymmetric
-    _recapture_spec
-        r_1 = r_2 if "proportional", otherwise MNL-consistent
-    _fcount_rng_seed_seq
-        seed firm count rng, for replicable results
-    _mktshr_rng_seed_seq
-        seed market share rng, for replicable results
-    _nthreads
-        number of threads for parallelized random number generation
-
-    Returns
-    -------
-        array of market shares and other market statistics
-
-    """
-
-    _firm_count_wts: NDArray[np.floating[TF]] = (
-        FCOUNT_WTS_DEFAULT if _firm_count_wts is None else _firm_count_wts
-    )
-
-    _min_choice_wt = 0.03 if _dist_type_dir == SHRConstants.DIR_FLAT_CONSTR else 0.00
-    _fcount_keys, _choice_wts = zip(
-        *(
-            _f
-            for _f in zip(
-                2 + np.arange(len(_firm_count_wts)),  # type: ignore
-                _firm_count_wts / _firm_count_wts.sum(),
-                strict=True,
-            )
-            if _f[1] > _min_choice_wt
-        )
-    )
-    _choice_wts = _choice_wts / sum(_choice_wts)
-
-    _fc_max = _fcount_keys[-1]
-    _dir_alphas_full = (
-        [1.0] * _fc_max if _dist_parms_dir is None else _dist_parms_dir[:_fc_max]
-    )
-    if _dist_type_dir == SHRConstants.DIR_ASYM:
-        _dir_alphas_full = [2.0] * 6 + [1.5] * 5 + [1.25] * min(7, _fc_max)
-
-    if _dist_type_dir == SHRConstants.DIR_COND:
-
-        def _gen_dir_alphas(_fcv: int) -> NDArray[np.float64]:
-            _dat = [2.5] * 2
-            if _fcv > len(_dat):
-                _dat += [1.0 / (_fcv - 2)] * (_fcv - 2)
-            return np.array(_dat, dtype=np.float64)
-
-    else:
-
-        def _gen_dir_alphas(_fcv: int) -> NDArray[np.float64]:
-            return np.array(_dir_alphas_full[:_fcv], dtype=np.float64)  # type: ignore
-
-    _fcounts = prng(_fcount_rng_seed_seq).choice(
-        _fcount_keys, size=(_s_size, 1), p=_choice_wts
-    )
-
-    _mktshr_seed_seq_ch = (
-        _mktshr_rng_seed_seq.spawn(len(_fcount_keys))
-        if isinstance(_mktshr_rng_seed_seq, SeedSequence)
-        else SeedSequence(pool_size=8).spawn(len(_fcounts))
-    )
-
-    _aggregate_purchase_prob, _nth_firm_share = (
-        np.empty((_s_size, 1)) for _ in range(2)
-    )
-    _mktshr_array = np.empty((_s_size, _fc_max), dtype=np.float64)
-    for _f_val, _f_sseq in zip(_fcount_keys, _mktshr_seed_seq_ch, strict=True):
-        _fcounts_match_rows = np.where(_fcounts == _f_val)[0]
-        _dir_alphas_test = _gen_dir_alphas(_f_val)
-
-        try:
-            _mktshr_sample_f = _gen_market_shares_dirichlet(
-                _dir_alphas_test,
-                len(_fcounts_match_rows),
-                _recapture_spec,
-                _f_sseq,
-                _nthreads,
-            )
-        except ValueError as _err:
-            print(_f_val, len(_fcounts_match_rows))
-            raise _err
-
-        # Push data for present sample to parent
-        _mktshr_array[_fcounts_match_rows] = np.pad(
-            _mktshr_sample_f.mktshr_array,
-            ((0, 0), (0, _fc_max - _mktshr_sample_f.mktshr_array.shape[1])),
-            "constant",
-        )
-        _aggregate_purchase_prob[_fcounts_match_rows] = (
-            _mktshr_sample_f.aggregate_purchase_prob
-        )
-        _nth_firm_share[_fcounts_match_rows] = _mktshr_sample_f.nth_firm_share
-
-    if (_iss := np.round(np.einsum("ij->", _mktshr_array))) != _s_size or _iss != len(
-        _mktshr_array
-    ):
-        raise ValueError(
-            "DATA GENERATION ERROR: {} {} {}".format(
-                "Generation of sample shares is inconsistent:",
-                "array of drawn shares must some to the number of draws",
-                "i.e., the sample size, which condition is not met.",
-            )
-        )
-
-    return ShareDataSample(
-        _mktshr_array, _fcounts, _nth_firm_share, _aggregate_purchase_prob
-    )
-
-
-def _gen_market_shares_dirichlet(
-    _dir_alphas: NDArray[np.floating[TF]],
-    _s_size: int = 10**6,
-    _recapture_spec: RECConstants = RECConstants.INOUT,
-    _mktshr_rng_seed_seq: SeedSequence | None = None,
-    _nthreads: int = 16,
-    /,
-) -> ShareDataSample:
-    """Dirichlet-distributed shares with fixed firm-count.
-
-    Parameters
-    ----------
-    _dir_alphas
-        Shape parameters for Dirichlet distribution
-    _s_size
-        sample size to be drawn
-    _r_bar
-        market recapture rate
-    _recapture_spec
-        r_1 = r_2 if RECConstants.FIXED, otherwise MNL-consistent. If
-        RECConstants.OUTIN; the number of columns in the output share array
-        is len(_dir_alphas) - 1.
-    _mktshr_rng_seed_seq
-        seed market share rng, for replicable results
-    _nthreads
-        number of threads for parallelized random number generation
-
-    Returns
-    -------
-        array of market shares and other market statistics
-
-    """
-
-    if not isinstance(_dir_alphas, np.ndarray):
-        _dir_alphas = np.array(_dir_alphas)
-
-    if _recapture_spec == RECConstants.OUTIN:
-        _dir_alphas = np.concatenate((_dir_alphas, _dir_alphas[-1:]))
-
-    _mktshr_seed_seq_ch = (
-        _mktshr_rng_seed_seq
-        if isinstance(_mktshr_rng_seed_seq, SeedSequence)
-        else SeedSequence(pool_size=8)
-    )
-
-    _mktshr_array = np.empty((_s_size, len(_dir_alphas)))
-    _mrng = MultithreadedRNG(
-        _mktshr_array,
-        dist_type="Dirichlet",
-        dist_parms=_dir_alphas,
-        seed_sequence=_mktshr_seed_seq_ch,
-        nthreads=_nthreads,
-    )
-    _mrng.fill()
-
-    if (_iss := np.round(np.einsum("ij->", _mktshr_array))) != _s_size or _iss != len(
-        _mktshr_array
-    ):
-        print(_dir_alphas, _iss, repr(_s_size), len(_mktshr_array))
-        print(repr(_mktshr_array[-10:, :]))
-        raise ValueError(
-            "DATA GENERATION ERROR: {} {} {}".format(
-                "Generation of sample shares is inconsistent:",
-                "array of drawn shares must sum to the number of draws",
-                "i.e., the sample size, which condition is not met.",
-            )
-        )
-
-    # If recapture_spec == 'inside_out', further calculations downstream
-    _aggregate_purchase_prob = np.nan * np.empty((_s_size, 1))
-    if _recapture_spec == RECConstants.OUTIN:
-        _aggregate_purchase_prob = 1 - _mktshr_array[:, [-1]]
-        _mktshr_array = _mktshr_array[:, :-1] / _aggregate_purchase_prob
-
-    return ShareDataSample(
-        _mktshr_array,
-        (_mktshr_array.shape[-1] * np.ones((_s_size, 1))).astype(np.int64),
-        _mktshr_array[:, [-1]],
-        _aggregate_purchase_prob,
-    )
-
-
-def _gen_pr_data(
-    _frmshr_array: NDArray[np.floating[TF]],
-    _nth_firm_share: NDArray[np.floating[TF]],
-    _mkt_sample_spec: MarketSampleSpec,
-    _seed_seq: SeedSequence | None = None,
-    /,
-) -> PriceDataSample:
-    _ssz = len(_frmshr_array)
-
-    _hsr_filing_test_type = _mkt_sample_spec.hsr_filing_test_type
-
-    _price_array, _price_ratio_array, _hsr_filing_test = (
-        np.ones_like(_frmshr_array),
-        np.empty_like(_frmshr_array),
-        np.empty(_ssz, dtype=bool),
-    )
-
-    _pr_max_ratio = 5.0
-    match _mkt_sample_spec.pr_sym_spec:
-        case PRIConstants.SYM:
-            _nth_firm_price = np.ones((_ssz, 1))
-        case PRIConstants.POS:
-            _price_array, _nth_firm_price = (
-                np.ceil(_p * _pr_max_ratio) for _p in (_frmshr_array, _nth_firm_share)
-            )
-        case PRIConstants.NEG:
-            _price_array, _nth_firm_price = (
-                np.ceil((1 - _p) * _pr_max_ratio)
-                for _p in (_frmshr_array, _nth_firm_share)
-            )
-        case PRIConstants.ZERO:
-            _price_array_gen = prng(_seed_seq).choice(
-                1 + np.arange(_pr_max_ratio), size=(len(_frmshr_array), 3)
-            )
-            _price_array = _price_array_gen[:, :2]
-            _nth_firm_price = _price_array_gen[:, [2]]
-            # del _price_array_gen
-        case _:
-            raise ValueError(
-                f"Condition regarding price symmetry"
-                f' "{_mkt_sample_spec.pr_sym_spec.value}" is invalid.'
-            )
-    # del _pr_max_ratio
-
-    _price_array = _price_array.astype(np.float64)
-    _rev_array = _price_array * _frmshr_array
-    _nth_firm_rev = _nth_firm_price * _nth_firm_share
-
-    # Although `_test_rev_ratio_inv` is not fixed at 10%,
-    # the ratio has not changed since inception of the HSR filing test,
-    # so we treat it as a constant of merger policy.
-    _test_rev_ratio, _test_rev_ratio_inv = 10, 1 / 10
-
-    match _hsr_filing_test_type:
-        case SSZConstants.HSR_TEN:
-            # See, https://www.ftc.gov/enforcement/premerger-notification-program/
-            #   -> Procedures For Submitting Post-Consummation Filings
-            #    -> Key Elements to Determine Whether a Post Consummation Filing is Required
-            #           under heading, "Historical Thresholds"
-            # Revenue ratio has been 10-to-1 since inception
-            # Thus, a simple form of the HSR filing test would impose a 10-to-1
-            # ratio restriction on the merging firms' revenues
-            _rev_ratio = (_rev_array.min(axis=1) / _rev_array.max(axis=1)).round(4)
-            _hsr_filing_test = _rev_ratio >= _test_rev_ratio_inv
-            # del _rev_array, _rev_ratio
-        case SSZConstants.HSR_NTH:
-            # To get around the 10-to-1 ratio restriction, specify that the nth firm
-            # matches the smaller firm in the size test; then if the smaller merging firm
-            # matches the n-th firm in size, and the larger merging firm has at least
-            # 10 times the size of the nth firm, the size test is considered met.
-            # Alternatively, if the smaller merging firm has 10% or greater share,
-            # the value of transaction test is considered met.
-            _rev_ratio_to_nth = np.round(np.sort(_rev_array, axis=1) / _nth_firm_rev, 4)
-            _hsr_filing_test = (
-                np.einsum(
-                    "ij->i",
-                    1 * (_rev_ratio_to_nth > [1, _test_rev_ratio]),
-                    dtype=np.int64,
-                )
-                == _rev_ratio_to_nth.shape[1]
-            ) | (_frmshr_array.min(axis=1) >= _test_rev_ratio_inv)
-
-            # del _nth_firm_rev, _rev_ratio_to_nth
-        case _:
-            # Otherwise, all draws meet the filing test
-            _hsr_filing_test = np.ones(_ssz, dtype=bool)
-
-    return PriceDataSample(_price_array, _hsr_filing_test)
-
-
-def _gen_pcm_data(
-    _frmshr_array: NDArray[np.floating[TF]],
-    _mkt_sample_spec: MarketSampleSpec,
-    _price_array: NDArray[np.floating[TF]],
-    _aggregate_purchase_prob: NDArray[np.floating[TF]],
-    _pcm_rng_seed_seq: SeedSequence,
-    _nthreads: int = 16,
-    /,
-) -> MarginDataSample:
-    _recapture_spec = _mkt_sample_spec.share_spec.recapture_spec
-    _dist_type_pcm, _dist_firm2_pcm, _dist_parms_pcm = (
-        getattr(_mkt_sample_spec.pcm_spec, _f)
-        for _f in ("dist_type", "firm2_pcm_constraint", "dist_parms")
-    )
-    _dist_type: Literal["Beta", "Uniform"] = (
-        "Uniform" if _dist_type_pcm == PCMConstants.UNI else "Beta"
-    )
-
-    _pcm_array = np.empty((len(_frmshr_array), 2), dtype=np.float64)
-    _mnl_test_array = np.empty((len(_frmshr_array), 2), dtype=int)
-
-    _beta_min, _beta_max = [None] * 2  # placeholder
-    _dist_parms = np.ones(2, np.float64)
-    if _dist_type_pcm == PCMConstants.EMPR:
-        _pcm_array = resample_mgn_data(
-            _pcm_array.shape,  # type: ignore
-            seed_sequence=_pcm_rng_seed_seq,
-        )
-    else:
-        if _dist_type_pcm == PCMConstants.UNI:
-            _dist_parms = (
-                DIST_PARMS_DEFAULT if _dist_parms_pcm is None else _dist_parms_pcm
-            )
-        elif _dist_type_pcm == PCMConstants.BETA:
-            # Error-checking (could move to validators in definition of MarketSampleSpec)
-
-            if _dist_parms_pcm is None:
-                _dist_parms_pcm = _dist_parms
-
-        elif _dist_type_pcm == PCMConstants.BETA_BND:  # Bounded beta
-            if _dist_parms_pcm is None:
-                _dist_parms_pcm = np.array([0, 1, 0, 1], np.float64)
-                _dist_parms = beta_located_bound(_dist_parms_pcm)
-
-        _pcm_rng = MultithreadedRNG(
-            _pcm_array,
-            dist_type=_dist_type,
-            dist_parms=_dist_parms,
-            seed_sequence=_pcm_rng_seed_seq,
-            nthreads=_nthreads,
-        )
-        _pcm_rng.fill()
-        del _pcm_rng
-
-    if _dist_type_pcm == PCMConstants.BETA_BND:
-        _beta_min, _beta_max = _dist_parms_pcm[2:]  # type: ignore
-        _pcm_array = (_beta_max - _beta_min) * _pcm_array + _beta_min
-        del _beta_min, _beta_max
-
-    if _dist_firm2_pcm == FM2Constants.MNL:
-        # Impose FOCs from profit-maximization with MNL demand
-        _purchprob_array = _aggregate_purchase_prob * _frmshr_array
-
-        _pcm_array[:, [1]] = np.divide(
-            np.einsum(
-                "ij,ij,ij->ij",
-                _price_array[:, [0]],
-                _pcm_array[:, [0]],
-                1 - _purchprob_array[:, [0]],
-            ),
-            np.einsum("ij,ij->ij", _price_array[:, [1]], 1 - _purchprob_array[:, [1]]),
-        )
-
-        _mnl_test_array = _pcm_array[:, 1].__ge__(0) & _pcm_array[:, 1].__le__(1)
-    else:
-        _mnl_test_array = np.ones(len(_pcm_array), dtype=bool)
-        if _dist_firm2_pcm == FM2Constants.SYM:
-            _pcm_array[:, [1]] = _pcm_array[:, [0]]
-
-    return MarginDataSample(_pcm_array, _mnl_test_array)
-
-
-def _beta_located(
-    _mu: float | NDArray[np.float64], _sigma: float | NDArray[np.float64], /
-) -> NDArray[np.float64]:
-    """
-    Given mean and stddev, return shape parameters for corresponding Beta distribution
-
-    Solve the first two moments of the standard Beta to get the shape parameters.
-
-    Parameters
-    ----------
-    _mu
-        mean
-    _sigma
-        standardd deviation
-
-    Returns
-    -------
-        shape parameters for Beta distribution
-
-    """
-
-    _mul = -1 + _mu * (1 - _mu) / _sigma**2
-    return np.array([_mu * _mul, (1 - _mu) * _mul], dtype=np.float64)
-
-
-def beta_located_bound(_dist_parms: NDArray[np.floating[TF]], /) -> NDArray[np.float64]:
-    R"""
-    Return shape parameters for a non-standard beta, given the mean, stddev, range
-
-
-    Recover the r.v.s as
-    :math:`\min + (\max - \min) \cdot \symup{Β}(a, b)`,
-    with `a` and `b` calculated from the specified mean (:math:`\mu`) and
-    variance (:math:`\sigma`). [8]_
-
-    Parameters
-    ----------
-    _dist_parms
-        vector of :math:`\mu`, :math:`\sigma`, :math:`\mathtt{\min}`, and :math:`\mathtt{\max}` values
-
-    Returns
-    -------
-        shape parameters for Beta distribution
-
-    Notes
-    -----
-    For example, ``beta_located_bound(np.array([0.5, 0.2887, 0.0, 1.0]))``.
-
-    References
-    ----------
-    .. [8] NIST, Beta Distribution. https://www.itl.nist.gov/div898/handbook/eda/section3/eda366h.htm
-    """  # noqa: RUF002
-
-    _bmu, _bsigma, _bmin, _bmax = _dist_parms
-    return _beta_located((_bmu - _bmin) / (_bmax - _bmin), _bsigma / (_bmax - _bmin))