PMA.studio

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Barcodes (automation) =====

Slides can be tracked more efficiently throughout the lab and other workflows by providing them with barcodes. They make anonymization and pseudonymization easier.

Barcodes may also prevent people from guessing filenames (and paths in which they are stored). Therefore it becomes possible to discuss slides and pass on references to slides, without revealing their location (path) and filename.

==== The role of PMA.core ====

[[https://www.pathomation.com/pma.core|PMA.core]] has a built-in mechanism to retrieve metadata from for a slide through a back-end API call:

{{::barcode0_10.png?400|}}

The call as defined above then maps back to the original slide w/ barcode 086318.

{{::barcode0_20.png?400|}}

There's a catch however: interpreting barcodes pasted on physical slides requires a lot of computation time; it's essentially an image recognition task.

This means that for a given repository of slides, we //don't// automatically know all their barcodes; we only know those after the code is invoked that parses that barcode image.

This also may seem counter-intuitive: why would you want to reverse-map a barcode back to a slide, if you actually have to lookk at the original slide in the first place?

The answer is that the "look at the slide first" process can be automated in a batch process overnight. Using our SDK (or even directly invoking the right API calls), you can write a script that periodically //pings// PMA.core for each slide there is, fetch the slide's barcode, and thereby build an implicit index of barcodes.

//That// index can then be used the next day to more effectively communicate with the server by means of barcode mapping.

==== Link via barcode in PMA.studio ====

Look at the info panel next to the following slide. Note the slide's filename reference, and its barcode identification:

{{::barcode1.jpg?400|}}

You may already know [[auto_slides|how to create a link to the slide by means of its full path]]:

''%%https://server/pma.studio/?serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&path=path%2Fto%2Fslide%2FPhilips02_UZBSet0213.tiff%%''

The link to reference to it via barcode is similar. When you know the barcode of the particular slide is ''UZBset0213'', this new link becomes:

''%%https://server/pma.studio/?serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&barcode=UZBset0213%%''

The result of the two links is identical to the end-user:

{{::barcode2.jpg?400|}}

==== Syntax ====

When 
  * PMA.studio runs at ''%%https://server/pma.studio%%'', and 
  * Your content resides on PMA.core ''%%https://server/pma.core%%'', and
  * Your barcode is  ''ABC123''

You can create a link to the slide associated with the barcode via the call

''%%https://server/pma.studio/?serverUrl=https%3A%2F%2Fserver%2Fpma.core%2F&barcode=ABC123%%''
PMA.studio

User Tools

Site Tools

Page Tools
