Skip to content

[MRG] Document that the acceptor's transfer syntax order decides negotiation - #1089

Open
CedricConday wants to merge 1 commit into
pydicom:mainfrom
CedricConday:docs/acceptor-transfer-syntax-order
Open

[MRG] Document that the acceptor's transfer syntax order decides negotiation#1089
CedricConday wants to merge 1 commit into
pydicom:mainfrom
CedricConday:docs/acceptor-transfer-syntax-order

Conversation

@CedricConday

Copy link
Copy Markdown

Follow-up to #1085, which read the acceptor-preference behaviour as a bug.

The rule is already stated in the "Implementation Note" on the presentation context negotiation page, but it isn't mentioned at either API surface where an SCP is actually configured, so a requestor's preferred transfer syntax losing to the acceptor's reads as a defect rather than as intended behaviour.

  • AE.add_supported_context: note that transfer_syntax is given in order of preference, that the first entry the requestor also proposed is the one accepted, and that the requestor's ordering is not taken into account.
  • negotiate_as_acceptor: state the same selection rule, citing PS3.7 Section D.3.2, which requires only that exactly one of the proposed transfer syntaxes be accepted and leaves the choice to the acceptor.
  • Negotiation page: add the consequence (a requestor cannot insist on a compressed syntax) and the remedy (list it first on the acceptor), with a runnable example.

Documentation only, no behaviour change. The example was run against 3.0.4 and accepts JPEG-LS Lossless as written.

The rule is stated in the "Implementation Note" on the presentation context
negotiation page, but not at either API surface where an SCP is configured,
so it reads as a bug when a requestor's preferred transfer syntax loses to
the acceptor's.

Note it on AE.add_supported_context and negotiate_as_acceptor, and spell out
the consequence and the remedy in the negotiation page.

Documentation only, no behaviour change.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant