{"record":{"id":"9ed092fac815db5f","repo":"nautechsystems/nautilus_trader","slug":"no-tearsheet-chart-registered-under-chart-name","errorCode":null,"errorMessage":"No tearsheet chart registered under '{chart_name}'.{hint} Register one with `register_tearsheet_chart`. Available: {available}","messagePattern":"No tearsheet chart registered under '(.+?)'\\.(.+?) Register one with `register_tearsheet_chart`\\. Available: (.+?)","errorType":"exception","errorClass":"KeyError","httpStatus":null,"severity":"error","filePath":"python/nautilus_trader/analysis/tearsheet.py","lineNumber":1687,"sourceCode":"    )\n\n    chart_idx = 0\n\n    for row in range(1, rows + 1):\n        for col in range(1, cols + 1):\n            if chart_idx >= len(config.charts):\n                break\n\n            chart = config.charts[chart_idx]\n            chart_idx += 1\n\n            chart_name = chart.name\n\n            if chart_name not in _TEARSHEET_CHART_SPECS:\n                available = \", \".join(sorted(_TEARSHEET_CHART_SPECS))\n                suggestions = get_close_matches(chart_name, _TEARSHEET_CHART_SPECS, n=3, cutoff=0.6)\n                hint = f\" Did you mean: {', '.join(suggestions)}?\" if suggestions else \"\"\n                raise KeyError(\n                    f\"No tearsheet chart registered under '{chart_name}'.{hint} \"\n                    f\"Register one with `register_tearsheet_chart`. Available: {available}\",\n                )\n\n            renderer = _TEARSHEET_CHART_SPECS[chart_name][\"renderer\"]\n\n            chart_kwargs = chart.kwargs()\n\n            renderer(\n                fig=fig,\n                row=row,\n                col=col,\n                returns=returns,\n                stats_pnls=stats_pnls,\n                stats_returns=stats_returns,\n                stats_general=stats_general,\n                theme_config=theme_config,\n                benchmark_returns=benchmark_returns,","sourceCodeStart":1669,"sourceCodeEnd":1705,"githubUrl":"https://github.com/nautechsystems/nautilus_trader/blob/18893faf8b356be3320add8de2f861b0b647cf06/python/nautilus_trader/analysis/tearsheet.py#L1669-L1705","documentation":"The tearsheet grid is built from chart specs registered in the module-level _TEARSHEET_CHART_SPECS registry. When a TearsheetChart name does not match any registered chart, a KeyError is raised listing available names and, when close, up to 3 fuzzy suggestions computed with difflib.get_close_matches.","triggerScenarios":"Passing a TearsheetChart with a misspelled or unregistered chart name (e.g. 'drawdown' instead of a registered name) into create_tearsheet_from_stats; referencing a custom chart before calling register_tearsheet_chart.","commonSituations":"Typos in chart names; renaming custom charts without updating config; assuming a chart exists that is only registered in another module/process.","solutions":["Check the 'Available:' list in the message and use an exact registered name","Use the 'Did you mean' suggestion if it matches your intent","Call register_tearsheet_chart(name, ...) before creating the figure","Fix the typo indicated by the suggestion"],"exampleFix":"// before\nTearsheetChart(name=\"drawdown\")  # KeyError\n// after\nregister_tearsheet_chart(name=\"drawdown\", subplot_type=\"xy\", title=\"Drawdown\", renderer=my_renderer)\nTearsheetChart(name=\"drawdown\")","handlingStrategy":"validation","validationCode":"from nautilus_trader.analysis.tearsheet import _TEARSHEET_CHART_SPECS\nassert all(c.name in _TEARSHEET_CHART_SPECS for c in charts), \\\n    [c.name for c in charts if c.name not in _TEARSHEET_CHART_SPECS]","typeGuard":"def is_registered_chart(name: str) -> bool:\n    from nautilus_trader.analysis.tearsheet import _TEARSHEET_CHART_SPECS\n    return name in _TEARSHEET_CHART_SPECS","tryCatchPattern":"try:\n    fig = create_tearsheet_from_stats(stats, config=cfg)\nexcept KeyError as e:\n    logger.error(f\"Unknown tearsheet chart: {e}; falling back to defaults\")\n    fig = create_tearsheet_from_stats(stats)","preventionTips":["Copy chart names from the 'Available:' list rather than retyping them","Register custom charts in the same module that builds tearsheets","Add a unit test asserting every configured chart name is registered","Use constants for chart names instead of inline strings"],"tags":["python","registry","keyerror","tearsheet"],"backgroundTag":"resource-not-found","analyzedSha":"18893faf8b356be3320add8de2f861b0b647cf06","analyzedAt":"2026-09-08T20:49:34.690Z","contentChangedAt":"2026-09-08T20:49:34.690Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}