User Tools

Site Tools


de:working_with_annotations

Arbeiten mit Kommentaren

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

Art der Anmerkung Herkunft Format Read/Write
Pathomation PMA.studio; SDK WKT Read/write
Einheimische Herstellerspezifischer Viewer; Pannoramic-Viewer; ImageScope Eingebettet in das Dateiformat des Anbieters Schreibgeschützt
DrittanbieterIndica Labs HALO; Definiens; Visiopharm .Annotation XML; .XML; .MLD (binär) Schreibgeschützt

Interner Speicher

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

Erstellen und Speichern

PMA.core-Anmerkungen

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.

Anmerkungen von Drittanbietern

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

Exportieren und Formatkonvertierung

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.

Mehr Hintergrund

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.

de/working_with_annotations.txt · Last modified: 2022/10/10 13:29 by charlotte