Skip to content

Conversation

@maartenpaul
Copy link

@maartenpaul maartenpaul commented Nov 7, 2025

Draft a first version of the ISCC-SUM tutorial. This tutorial will explain how to use ISCC-SUM in Galaxy and explain the concepts of the ISCC checksums.
https://toolshed.g2.bx.psu.edu/repository?repository_id=9501503161ea7987&changeset_revision=c360847c8299

TODO:

  • add example data
  • Work on a realistic workflow

xref FAIR-imaging/galaxy-image-community#62


# Prepare your data

For this tutorial, we'll use a simple dataset with images that demonstrate different use cases.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add a bit more detail on the data that will be used on this tutorial?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, ideally would like to use some public data, although we don't need much to show the concepts. Working on that before we publish this.

>
{: .hands_on}

> <comment-title>Test Data</comment-title>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For example, can you move this explanation to the "prepare your data" section instead of adding it as a comment?


> <hands-on-title>Generate ISCC codes for input files</hands-on-title>
>
> 1. {% tool [Generate ISCC hash](toolshed.g2.bx.psu.edu/repos/bgruening/iscc_sum/iscc_sum) %} with the following parameters:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.


> <hands-on-title>Verify a file against its ISCC code</hands-on-title>
>
> 1. {% tool [Verify ISCC hash](toolshed.g2.bx.psu.edu/repos/bgruening/iscc_sum_verify/iscc_sum_verify) %} with the following parameters:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.


> <hands-on-title>Compare two files for similarity</hands-on-title>
>
> 1. {% tool [Compare ISCC hash similarity](toolshed.g2.bx.psu.edu/repos/bgruening/iscc_sum_compare/iscc_sum_compare) %} with the following parameters:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.

>
> {% snippet faqs/galaxy/collections_build_list.md %}
>
> 2. {% tool [Compare ISCC hash similarity](toolshed.g2.bx.psu.edu/repos/bgruening/iscc_sum_compare/iscc_sum_compare) %} with the following parameters:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.

Comment on lines +1 to +2
---
layout: tutorial_hands_on
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:046> reported by reviewdog 🐶
Please do not include an # Introduction section, it is unnecessary here, just start directly into your text. The first paragraph that is seen by our infrastructure will automatically be shown in a few places as an abstract.

Suggested change
---
layout: tutorial_hands_on
layout: tutorial_hands_on

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants