review_semantics
review_semantics(x, include_filled=False, max_candidates=5, columns=None)Review semantic suggestions in the console.
Builds a re-runnable review queue from suggestions that already exist. One entry per unfilled semantic slot, plus NuSEDS crosswalk-prefilled code slots that still hold their original prefill, each with its ranked shortlist and the exact :func:accept_suggestion call that decides it – printing that call is the feature: paste it into a script and the decision becomes reproducible, which the spreadsheet workflow this replaces never was.
This never contacts a network or an LLM. It reads the semantic_suggestions attribute (or semantic_suggestions.csv) that :func:suggest_semantics / :func:create_sdp already produced. When those suggestions carry a model’s assessment – ingested from your own harness by :func:~metasalmonpy.ingest_semantic_assessments, or made by the deprecated llm_assess=True – this shows it, an accept under the candidate it chose and any other decision once per slot and role; it never generates one.
Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| x | A written package path, a dictionary carrying the semantic_suggestions attribute, or the artifact mapping returned by :func:infer_salmon_datapackage_artifacts. |
required | |
| include_filled | bool | When True, also queue slots that already hold a final (non-REVIEW:) IRI, and slots that already carry a decision. NuSEDS crosswalk-prefilled code slots with a saved shortlist are shown by default until decided. |
False |
| max_candidates | Optional[int] | Maximum candidates shown per target: per slot, and per role where a code value’s slot holds its constraint, entity and method targets. None shows all. A candidate a model accepted is shown whatever its rank. |
5 |
| columns | Optional[Iterable[str]] | Optional column names restricting the queue. A value matching no column is an error that names the columns that do exist – filtering first and then reporting an empty queue told a user who mistyped a column name that their package was finished. | None |
Returns
| Name | Type | Description |
|---|---|---|
| SemanticReview |