{"record":{"id":"2c4d6d75d7e695cd","repo":"OpenBB-finance/OpenBB","slug":"measure-measure-not-supported-choose-from-valu","errorCode":null,"errorMessage":"Measure {measure} not supported. Choose from 'value', 'equal', 'number_of_firms', or 'firm_size'.","messagePattern":"Measure (.+?) not supported\\. Choose from 'value', 'equal', 'number_of_firms', or 'firm_size'\\.","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"openbb_platform/providers/famafrench/openbb_famafrench/utils/helpers.py","lineNumber":814,"sourceCode":"        If None, defaults to 'value'.\n\n    Returns\n    -------\n    tuple\n        A tuple containing a list of pandas DataFrames and a list of metadata dictionaries.\n        In most scenarios, there will only be 1 DataFrame and 1 metadata dictionary.\n\n    Raises\n    ------\n    ValueError\n        When an invalid combination of parameters or unsupported values are supplied.\n    \"\"\"\n    if frequency and frequency.lower() not in [\"monthly\", \"annual\", \"daily\"]:\n        raise ValueError(\n            f\"Frequency {frequency} not supported. Choose from 'monthly', 'annual', or 'daily'.\"\n        )\n    if measure and measure not in [\"value\", \"equal\", \"number_of_firms\", \"firm_size\"]:\n        raise ValueError(\n            f\"Measure {measure} not supported. \"\n            + \"Choose from 'value', 'equal', 'number_of_firms', or 'firm_size'.\"\n        )\n    if measure in [\"number_of_firms\", \"firm_size\"] and frequency == \"annual\":\n        raise ValueError(\n            f\"Measure '{measure}' is only available for monthly frequency.\"\n        )\n    if \"Factor\" in dataset:\n        measure = None\n\n    file = download_file(dataset)\n    table, desc = read_csv_file(file)\n    dfs, metadata = process_csv_tables(table, desc)\n\n    if frequency:\n        out_dfs = [\n            df\n            for df, meta in zip(dfs, metadata)","sourceCodeStart":796,"sourceCodeEnd":832,"githubUrl":"https://github.com/OpenBB-finance/OpenBB/blob/3e071fcc2cd9f891cac6040ae60296dba76dab46/openbb_platform/providers/famafrench/openbb_famafrench/utils/helpers.py#L796-L832","documentation":"Raised by the US research-portfolios helper when `measure` is not one of 'value', 'equal', 'number_of_firms', 'firm_size'. These correspond to the value-weighted/equal-weighted returns and the firm count / average size sheets in the Fama/French US datasets. Note: if the dataset name contains 'Factor', measure is silently ignored (set to None) instead of erroring.","triggerScenarios":"Calling a US portfolio endpoint with measure='vw', 'weighted', or any token outside the four allowed values on a non-Factor dataset.","commonSituations":"Reusing the international endpoint's measure vocabulary ('usd'/'local'/'ratios') on the US endpoint; abbreviations from other data vendors.","solutions":["Use one of 'value', 'equal', 'number_of_firms', 'firm_size'.","Remember the international and US endpoints have different measure enums — do not share one dropdown.","For Factor datasets any measure is ignored anyway; pick a research portfolios dataset to use measures."],"exampleFix":"// before\nobb.economy.famafrench.research_portfolios(measure='usd')\n\n// after\nobb.economy.famafrench.research_portfolios(measure='value')","handlingStrategy":"validation","validationCode":"US_MEASURES = ('value', 'equal', 'number_of_firms', 'firm_size')\nassert not measure or measure in US_MEASURES, f'measure must be one of {US_MEASURES}'","typeGuard":"def is_valid_us_measure(m: str | None) -> bool:\n    return m is None or m in ('value', 'equal', 'number_of_firms', 'firm_size')","tryCatchPattern":null,"preventionTips":["Do not reuse the international endpoint's measure vocabulary ('usd'/'local'/'ratios') on US endpoints.","Remember Factor datasets ignore measure entirely; only research portfolios honor it."],"tags":["famafrench","validation","measure"],"backgroundTag":null,"analyzedSha":"3e071fcc2cd9f891cac6040ae60296dba76dab46","analyzedAt":"2026-08-14T23:40:48.960Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}