Documentation

How to write down a Protocol so that it can be shared and versioned.

Protocol definition

A protocol definition defines each of the four parts of a protocol:

Part

Syntax

Example

Tags

tag -> action code list

PatientID -> REMOVE

Filters

Boolean functions (more info)

<Modality == ‘US’> -> Reject

Pixel

Boolean functions + pixel location (more info)

<Manufacturer == ‘A’> -> [0,0,100,500]

Private

List of safe private tags (more info)

0013,[“Company_A”]01

Write a protocol definition.

Should contain: * name

  • version

  • tags

  • Filter

  • Pixel

  • Private

Anything else?

Which syntax? -> Does not matter much, can be multiple. As long as there is a reader to a uniform syntax.

That uniform syntax is probably python (define in midom). Then there can be different ways to serialize this

A protocol document will have a persisted version of the protocol definition plus reasoning, explanation etc. whatever you want.

``` some code?

```