PMA.core unterstützt drei Arten von Annotationen: PMA.core Annotationen, native Annotationen und Annotationen von Drittanbietern.

PMA.core verwendet ein eigenes internes Format mit der folgenden Struktur:

• Geometrie: basiert auf WKT (Well-known text). Unterstützt die folgenden Formen Polygon, Linestring, Punkt und Multipunkt
• Farbe: die Farbe des Umrisses im html-Format
• Füllfarbe: die Füllfarbe (falls vorhanden), nur gültig für geschlossene Formen wie Polygone
• Klassifizierung: Ein Text, der die Klassifizierung einer Anmerkung wie Tumor, Nekrose usw. angibt.
• Notizen: Freitextnotizen und zusätzliche Informationen, die Sie für jede Anmerkung speichern möchten

PMA.core unterstützt Anmerkungen von Drittanbietern der folgenden Hersteller: Visiopharm, Indica Labs und Aperio. Jedes dieser Formate wird durch Parsen der jeweiligen herstellerspezifischen Datei unterstützt:

• Visiopharm .mld
• Indica Labs . Anmerkungen
• Aperio .xml

Um die PMA.core-Anmerkungen für eine Folie zu lesen, können Sie den API-Aufruf GetAnnotationsverwenden, der alle PMA.core-Anmerkungen im json-Format zurückgibt.

Alle anderen Funktionen von PMA.core annotations werden über den SaveAnnotations API-Aufruf bereitgestellt. Mit diesem Aufruf können viele Anmerkungen in einem einzigen API-Aufruf erstellt, aktualisiert und gelöscht werden. PMA.core bietet auch die Möglichkeit, die Länge und/oder die Fläche für bereits gespeicherte Anmerkungen über die API-Aufrufe GetAnnotationDistance und GetAnnotationSurfaceArea zu ermitteln.

PMA.core kann über die Schnittstelle “Externe Dateien” und die damit verbundenen API-Aufrufe die Verwendung von Drittanbieter-Anmerkungen nutzen. Diese API assoziiert eine Reihe von Dateien, die alle bekannten Anmerkungen von Drittanbietern enthalten, mit einer Folie (siehe vorheriger Absatz). Um externe Dateien mit einer Folie zu verknüpfen, müssen Sie den API-Aufruf SetExternalAnnotationFiles. Dieser nimmt ein Array von Tupeln auf, das den Namen und den Pfad für jede verknüpfte Datei mit Drittanbieter-Anmerkungen enthält. Für Name können Sie einen beliebigen Text verwenden, um sich von anderen Anmerkungen zu unterscheiden, und der Pfad muss ein virtueller Pfad zu der Datei sein, die die Anmerkungen enthält. Sie können die zuvor festgelegten externen Anmerkungsdateien für eine Folie über den GetExternalAnnotationFiles API-Aufruf abrufen, der das Array von Name/Pfad-Tupeln für jede mit einer Folie verbundene Datei zurückgibt

PMA.core bietet eine sehr leistungsfähige API zum Exportieren und Konvertieren aller bekannten Annotationsformate, egal ob es sich um PMA.core Annotations, 3rd Party Annotations oder native Annotations handelt. Der API-Aufruf ExportAnnotations kann jede bekannte Quelle von Annotationen (PMA.core annotations, Native annotations , Visiopharm , Indica Labs , Aperio) in jedes der Formate von Drittanbietern (Visiopharm Indica Labs Aperio) konvertieren. Dieser Aufruf unterstützt auch zwei weitere sehr nützliche Formate für die Verwendung außerhalb von PMA.core, nämlich die Formate CSV und WKT (Well-Known text). PMA.core versucht, jedes Format so fehlerfrei wie möglich zu konvertieren, aber einige Shapes sind nicht mit Shapes in anderen Formaten kompatibel. Wenn Quell- und Zielformat identisch sind, führt PMA.core keine Konvertierung durch, sondern gibt die Originaldatei aus.

Wussten Sie, dass PMA.core ein großartiges Werkzeug ist, um verschiedene Annotationen aus unterschiedlichen Quellen zu integrieren? Für mehr Hintergrundinformationen, schauen Sie sich die Pathomation ANNotation subset of functionality in der API.

Wir haben einen Blog-Artikel über Annotationen und deren Handhabung, nicht nur innerhalb von PMA.core, sondern in der gesamten Pathomation Software-Plattform.