Mercurial > hg > cc > pub

changeset 6:cc5cef8ba548 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
expanded with example script, updated to point to full paper, include slides
author Henry Thompson <ht@markup.co.uk>
date Thu, 23 May 2024 16:51:36 +0200
parents e265fcc42974
children
files index.html index.xml
diffstat 2 files changed, 29 insertions(+), 11 deletions(-) [+]
line wrap: on
line diff
--- a/index.html	Thu May 23 15:00:40 2024 +0100
+++ b/index.html	Thu May 23 16:51:36 2024 +0200
@@ -106,19 +106,25 @@
        img {border: 0}
        .copyright {font-size: 70%}
        .note {width: 20%; float: right; clear: right; margin-left: .5em}
-     </style><title>Augmentations to Common Crawl</title></head><body style="font-family: DejaVu Sans, Arial; background: rgb(254,250,246)"><div style="text-align: center" class="head"><h1>Augmentations to Common Crawl</h1><hr/><div class="byline">Henry S. Thompson</div><div class="byline">22 May 2024</div><div class="copyright">Copyright &#xa9; 2024 <a href="http://www.ltg.ed.ac.uk/~ht/">Henry S. Thompson</a>&#160;<a href="http://creativecommons.org/licenses/by-sa/3.0/deed.en">CC-BY-SA</a></div></div><div class="body"><div><h2>1.  Introduction</h2><p>This site contains a preliminary publication of my augmented <a href="https://commoncrawl.org/blog/announcing-the-common-crawl-index">index files</a>
-for <a href="https://commoncrawl.org/blog/august-2019-crawl-archive-now-available">CC-MAIN-2019-35</a>.  This index contains one additional field, <code>lastmod</code>, in about 18% of the entries, giving the value of the <code>Last-Modified</code> header as a POSIX-format timestamp, enabling much finer-grained longitudinal study of the corresponding web resources.  The filename, offset and length fields in the augmented index are unchanged, and so can be used for retrieval from the original WARC files.</p></div><div><h2>2.  Contents</h2><ul class=" "><li>My <a href="Thompson_WebSci24.pdf">forthcoming paper</a> describing
+     </style><title>Augmentations to Common Crawl</title></head><body style="font-family: DejaVu Sans, Arial; background: rgb(254,250,246)"><div style="text-align: center" class="head"><h1>Augmentations to Common Crawl</h1><hr/><div class="byline">Henry S. Thompson</div><div class="byline">23 May 2024</div><div class="copyright">Copyright &#xa9; 2024 <a href="http://www.ltg.ed.ac.uk/~ht/">Henry S. Thompson</a>&#160;<a href="http://creativecommons.org/licenses/by-sa/3.0/deed.en">CC-BY-SA</a></div></div><div class="body"><div><h2>1.  Introduction</h2><p>This site contains a copy of my augmented index files
+for <a href="https://commoncrawl.org/blog/august-2019-crawl-archive-now-available">CC-MAIN-2019-35</a>.  This index contains all of <a href="https://commoncrawl.org/blog/august-2019-crawl-archive-now-available">the original index</a>, with one additional field, <code>lastmod</code>, in about 18% of the entries, giving the value of the <code>Last-Modified</code> header as a POSIX-format timestamp, enabling much finer-grained longitudinal study of the corresponding web resources.  The filename, offset and length fields in the augmented index are unchanged, and so can be used for retrieval from the original WARC files.</p><p>The format of the Common Crawl's index files is described in <a href="https://commoncrawl.org/blog/announcing-the-common-crawl-index">this announcement</a>.</p></div><div><h2>2.  Contents</h2><ul class=" "><li>My <a href="Thompson_WebSci24.pdf">paper</a>, presented at WebSci24, describing
 the augmented index and its uses</li><li>The <a href="CC-MAIN-2019-35/cdx/warc/cluster.idx">top-level index file</a></li><li><a href="CC-MAIN-2019-35/cdx/warc/idx/">The directory containing
 the individual gzipped index files themselves</a>, with names of the form
-<code>cdx-00nnn.gz</code>, for <code>nnn</code> in <code>000&#x2013;299</code></li><li><a href="Thompson_WebSci24_slides.pdf">WebSci 24 conference slides</a></li></ul></div><div><h2>3.  Licence and citation</h2><p>The paper and data contained herein are Copyright &#xa9; 2024 Henry S. Thompson <a href="http://creativecommons.org/licenses/by-sa/3.0/deed.en">CC-BY-SA</a></p><p>Please cite information from here as follows:</p><ul class="naked  "><li><a name="For_the_paper"><b>For the paper</b></a>
+<code>cdx-00nnn.gz</code>, for <code>nnn</code> in <code>000&#x2013;299</code></li><li><a href="Thompson_WebSci24_slides.pdf">WebSci 24 conference slides</a></li></ul></div><div><h2>3.  Efficient access to Common Crawl using Amazon S3</h2><p>The University of Edinburgh's <a href="https://edinburgh-international-data-facility.ed.ac.uk/">Edinburgh International Data Facility</a> (EIDF) hosts a
+copy of the augmented index in an Amazon S3 server.  It supports open
+access to the index via unsigned requests to (range-restricted)
+<b>s3:</b> URIs, for example using the <a href="https://aws.amazon.com/cli/">Amazon <code>aws</code>
+Command Line Interface</a>.</p><p>The best way to understand how this works, once you've read how
+the index itself works <a href="Thompson_WebSci24.pdf">in the paper, section 2.1</a>, is to work through <a href="eidf125_example.sh">an example</a> of using the augmented index to access an individual
+Common Crawl retrieval record using a timestamp.</p></div><div><h2>4.  Licence and citation</h2><p>The paper and data contained herein are Copyright &#xa9; 2024 Henry S. Thompson <a href="http://creativecommons.org/licenses/by-sa/3.0/deed.en">CC-BY-SA</a></p><p>Please cite information from here as follows:</p><ul class="naked  "><li><a name="For_the_paper"><b>For the paper</b></a>
 &#xa0;&#xa0;<blockquote class="vanilla"><div>Henry S. Thompson. 2024. "Improved methodology for longitudinal Web
 analytics using Common Crawl". In <i>ACM Web Science Conference (Websci &#x2019;24)</i>,
 May 21&#x2013;24, 2024, Stuttgart, Germany. ACM, New York, NY, USA, 11 pages.
-<a href="...">[coming soon]</a>
+<a href="https://doi.org/10.1145/3614419.3644018">https://doi.org/10.1145/3614419.3644018</a>
 </div></blockquote></li><li><a name="For_the_data"><b>For the data</b></a>
 &#xa0;&#xa0;<blockquote class="vanilla"><div>Henry S. Thompson. 2024. <i>Augmented index
 for Common Crawl August 2019, with Last-Modified timestamps</i>.
-<a href="https://markup.co.uk/ccrawl/">https://markup.co.uk/ccrawl/</a>. Retrieved ...</div></blockquote></li></ul></div><div><h2>4.  Acknowledgements</h2><p>Without the vision of those responsible for Common Crawl and the
+<a href="https://markup.co.uk/ccrawl/">https://markup.co.uk/ccrawl/</a>. Retrieved ...</div></blockquote></li></ul></div><div><h2>5.  Acknowledgements</h2><p>Without the vision of those responsible for Common Crawl and the
 generosity of Amazon in hosting it this work could never have happened.</p><p>Access to the <a href="http://www.cirrus.ac.uk">Cirrus UK National Tier-2 HPC Service</a> at the Edinburgh
 Parallel Computing Centre used to produce the augmented index was supported
 by EPSRC and UKRI HPC Access awards to Henry S. Thompson.</p><p>Thanks to Sebastian Nagel of Common Crawl for many prompt and helpful
--- a/index.xml	Thu May 23 15:00:40 2024 +0100
+++ b/index.xml	Thu May 23 16:51:36 2024 +0200
@@ -5,18 +5,19 @@
  <head>
   <title>Augmentations to Common Crawl</title>
   <author>Henry S. Thompson</author>
-  <date>22 May 2024</date>
+  <date>23 May 2024</date>
  </head>
  <body>
   <div>
    <title>Introduction</title>
-   <p>This site contains a preliminary publication of my augmented <link href="https://commoncrawl.org/blog/announcing-the-common-crawl-index">index files</link>
-for <link href="https://commoncrawl.org/blog/august-2019-crawl-archive-now-available">CC-MAIN-2019-35</link>.  This index contains one additional field, <code>lastmod</code>, in about 18% of the entries, giving the value of the <code>Last-Modified</code> header as a POSIX-format timestamp, enabling much finer-grained longitudinal study of the corresponding web resources.  The filename, offset and length fields in the augmented index are unchanged, and so can be used for retrieval from the original WARC files.</p>
+   <p>This site contains a copy of my augmented index files
+for <link href="https://commoncrawl.org/blog/august-2019-crawl-archive-now-available">CC-MAIN-2019-35</link>.  This index contains all of <link href="https://commoncrawl.org/blog/august-2019-crawl-archive-now-available">the original index</link>, with one additional field, <code>lastmod</code>, in about 18% of the entries, giving the value of the <code>Last-Modified</code> header as a POSIX-format timestamp, enabling much finer-grained longitudinal study of the corresponding web resources.  The filename, offset and length fields in the augmented index are unchanged, and so can be used for retrieval from the original WARC files.</p>
+   <p>The format of the Common Crawl's index files is described in <link href="https://commoncrawl.org/blog/announcing-the-common-crawl-index">this announcement</link>.</p>
   </div>
   <div>
    <title>Contents</title>
    <list>
-    <item>My <link href="Thompson_WebSci24.pdf">forthcoming paper</link> describing
+    <item>My <link href="Thompson_WebSci24.pdf">paper</link>, presented at WebSci24, describing
 the augmented index and its uses</item>
     <item>The <link href="CC-MAIN-2019-35/cdx/warc/cluster.idx">top-level index file</link></item>
     <item><link href="CC-MAIN-2019-35/cdx/warc/idx/">The directory containing
@@ -26,6 +27,17 @@
    </list>
   </div>
   <div>
+   <title>Efficient access to Common Crawl using Amazon S3<!--    <item> <link href="">eidf125_example.sh</link>.</item>--></title>
+   <p>The University of Edinburgh's <link href="https://edinburgh-international-data-facility.ed.ac.uk/">Edinburgh International Data Facility</link> (EIDF) hosts a
+copy of the augmented index in an Amazon S3 server.  It supports open
+access to the index via unsigned requests to (range-restricted)
+<name>s3:</name> URIs, for example using the <link href="https://aws.amazon.com/cli/">Amazon <code>aws</code>
+Command Line Interface</link>.</p>
+   <p>The best way to understand how this works, once you've read how
+the index itself works <link href="Thompson_WebSci24.pdf">in the paper, section 2.1</link>, is to work through <link href="eidf125_example.sh">an example</link> of using the augmented index to access an individual
+Common Crawl retrieval record using a timestamp.</p>
+  </div>
+  <div>
    <title>Licence and citation</title>
    <p>The paper and data contained herein are Copyright © 2024 Henry S. Thompson <link href="http://creativecommons.org/licenses/by-sa/3.0/deed.en">CC-BY-SA</link></p>
    <p>Please cite information from here as follows:</p>
@@ -33,8 +45,8 @@
     <item term="For the paper"><display>Henry S. Thompson. 2024. "Improved methodology for longitudinal Web
 analytics using Common Crawl". In <emph>ACM Web Science Conference (Websci ’24)</emph>,
 May 21–24, 2024, Stuttgart, Germany. ACM, New York, NY, USA, 11 pages.
-<link href="...">[coming soon]</link>
-</display><!--https://doi.org/10.1145/3614419.3644018--></item>
+<link href="https://doi.org/10.1145/3614419.3644018">https://doi.org/10.1145/3614419.3644018</link>
+</display></item>
     <item term="For the data"><display>Henry S. Thompson. 2024. <emph>Augmented index
 for Common Crawl August 2019, with Last-Modified timestamps</emph>.
 <link href="https://markup.co.uk/ccrawl/">https://markup.co.uk/ccrawl/</link>. Retrieved ...</display></item>