From 5397fc1969692ef5ead3a4ec8bb84478d2b1d4fc Mon Sep 17 00:00:00 2001
From: Joan Segura <jsegurmor@gmail.com>
Date: Wed, 16 Oct 2024 14:28:31 -0700
Subject: [PATCH] group annotations histogram

---
 .../examples/group-alignments-new.txt         |  2 +-
 .../migration/examples/group-alignments-old   |  2 +-
 .../group-annotations-histogram-new.txt       | 12 +++++++
 .../group-annotations-histogram-old.txt       | 13 ++++++++
 .../static/migration/migration-guide.html     | 32 +++++++++++++++++--
 5 files changed, 57 insertions(+), 4 deletions(-)
 create mode 100644 src/main/resources/static/migration/examples/group-annotations-histogram-new.txt
 create mode 100644 src/main/resources/static/migration/examples/group-annotations-histogram-old.txt

diff --git a/src/main/resources/static/migration/examples/group-alignments-new.txt b/src/main/resources/static/migration/examples/group-alignments-new.txt
index 17c021d..8f9a3fe 100644
--- a/src/main/resources/static/migration/examples/group-alignments-new.txt
+++ b/src/main/resources/static/migration/examples/group-alignments-new.txt
@@ -1,4 +1,4 @@
-query NCBI2PDB{
+query UP_GROUP{
   group_alignments(
     group: MATCHING_UNIPROT_ACCESSION
     groupId: "P01112"
diff --git a/src/main/resources/static/migration/examples/group-alignments-old b/src/main/resources/static/migration/examples/group-alignments-old
index 272c2b1..4b2840e 100644
--- a/src/main/resources/static/migration/examples/group-alignments-old
+++ b/src/main/resources/static/migration/examples/group-alignments-old
@@ -1,4 +1,4 @@
-query NCBI2PDB{
+query UP_GROUP{
   group_alignment(
     group: matching_uniprot_accession
     groupId: "P01112"
diff --git a/src/main/resources/static/migration/examples/group-annotations-histogram-new.txt b/src/main/resources/static/migration/examples/group-annotations-histogram-new.txt
new file mode 100644
index 0000000..7934f23
--- /dev/null
+++ b/src/main/resources/static/migration/examples/group-annotations-histogram-new.txt
@@ -0,0 +1,12 @@
+query UP_GROUP_FEATURES{
+  group_annotations_summary(
+    group: MATCHING_UNIPROT_ACCESSION
+    groupId: "P01112"
+    sources: [PDB_INSTANCE]
+  ) {
+    target_id
+    features{
+      type
+    }
+  }
+}
\ No newline at end of file
diff --git a/src/main/resources/static/migration/examples/group-annotations-histogram-old.txt b/src/main/resources/static/migration/examples/group-annotations-histogram-old.txt
new file mode 100644
index 0000000..b24e178
--- /dev/null
+++ b/src/main/resources/static/migration/examples/group-annotations-histogram-old.txt
@@ -0,0 +1,13 @@
+query UP_GROUP_FEATURES{
+  group_annotations(
+    group: matching_uniprot_accession
+    groupId: "P01112"
+    sources: [PDB_INSTANCE]
+    histogram: true
+  ) {
+    target_id
+    features{
+      type
+    }
+  }
+}
\ No newline at end of file
diff --git a/src/main/resources/static/migration/migration-guide.html b/src/main/resources/static/migration/migration-guide.html
index 0527977..026e53e 100644
--- a/src/main/resources/static/migration/migration-guide.html
+++ b/src/main/resources/static/migration/migration-guide.html
@@ -21,6 +21,7 @@
       <li><a href="#migration-mapping">Sequence Coordinates Service API changes</a></li>
       <li><a href="#http-request">HTTP Request</a></li>
       <li><a href="#end-points">End Points</a></li>
+      <li><a href="#end-points-arguments">End Points Arguments</a></li>
       <li><a href="#contact-us">Contact Us</a></li>
     </ul>
   </div>
@@ -35,6 +36,9 @@
           <li>
             <a href="#end-points" class="toc-h2 toc-link" data-title="end-points">End Points</a>
           </li>
+          <li>
+            <a href="#end-points-arguments" class="toc-h2 toc-link" data-title="end-points-arguments">End Points Arguments</a>
+          </li>
         </ul>
       </li>
       <li>
@@ -107,10 +111,34 @@ <h1 id="end-points">End Points</h1>
       </tbody>
     </table>
     <script>
-      load("alignments-old", "examples/alignments-old.txt", add_json_to_cell);
-      load("alignments-new", "examples/alignments-new.txt", add_json_to_cell);
+      load("group-alignments-old", "examples/group-alignments-old.txt", add_json_to_cell);
+      load("group-alignments-new", "examples/group-alignments-new.txt", add_json_to_cell);
     </script>
 
+    <h1 id="end-points-arguments">End Points Arguments</h1>
+    <p>
+      Endpoint <code>group_annotations</code> boolean argument <code>histogram</code> has been removed.
+      Its functionality has been replaced by a new endpoint <code>group_annotations_summary</code> with the same signature.
+    </p>
+
+    <table>
+      <thead>
+      <tr>
+        <th>1D Coordinates Service</th>
+        <th>Sequence Coordinates Service</th>
+      </tr>
+      </thead>
+      <tbody>
+      <tr>
+        <td id="group-annotations-histogram-old"></td>
+        <td id="group-annotations-histogram-new"></td>
+      </tr>
+      </tbody>
+    </table>
+    <script>
+      load("group-annotations-histogram-old", "examples/group-annotations-histogram-old.txt", add_json_to_cell);
+      load("group-annotations-histogram-new", "examples/group-annotations-histogram-new.txt", add_json_to_cell);
+    </script>
 
     <h1 id="contact-us">Contact Us</h1>
     <p>