Merge branch 'main' into dependabot/bundler/jekyll-4.3.3

Gemfile

@@ -3,5 +3,5 @@ source 'https://rubygems.org'
 gem "jekyll", "~> 4.3.3" # installed by `gem jekyll`
 # gem "webrick"        # required when using Ruby >= 3 and Jekyll <= 4.2.2
 
-gem "just-the-docs", "0.7.0" # pinned to the current release
+gem "just-the-docs", "0.8.0" # pinned to the current release
 # gem "just-the-docs"        # always download the latest release

Gemfile.lock

@@ -4,15 +4,15 @@ GEM
     addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
     colorator (1.1.0)
-    concurrent-ruby (1.2.2)
+    concurrent-ruby (1.2.3)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
     ffi (1.16.3)
     forwardable-extended (2.6.0)
-    google-protobuf (3.25.1-arm64-darwin)
-    google-protobuf (3.25.1-x86_64-linux)
+    google-protobuf (3.25.3-arm64-darwin)
+    google-protobuf (3.25.3-x86_64-linux)
     http_parser.rb (0.8.0)
     i18n (1.14.1)
       concurrent-ruby (~> 1.0)
@@ -40,7 +40,7 @@ GEM
       jekyll (>= 3.8, < 5.0)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
-    just-the-docs (0.7.0)
+    just-the-docs (0.8.0)
       jekyll (>= 3.8.5)
       jekyll-include-cache
       jekyll-seo-tag (>= 2.0)
@@ -57,17 +57,17 @@ GEM
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     public_suffix (5.0.4)
-    rake (13.0.6)
+    rake (13.1.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     rexml (3.2.6)
     rouge (4.2.0)
     safe_yaml (1.0.5)
-    sass-embedded (1.69.5-arm64-darwin)
-      google-protobuf (~> 3.23)
-    sass-embedded (1.69.5-x86_64-linux-gnu)
-      google-protobuf (~> 3.23)
+    sass-embedded (1.71.1-arm64-darwin)
+      google-protobuf (~> 3.25)
+    sass-embedded (1.71.1-x86_64-linux-gnu)
+      google-protobuf (~> 3.25)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.5.0)
@@ -78,8 +78,8 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  jekyll (~> 4.3.3)
-  just-the-docs (= 0.7.0)
+  jekyll (~> 4.3.2)
+  just-the-docs (= 0.8.0)
 
 BUNDLED WITH
    2.3.26

docs/Locations/bath.md

@@ -0,0 +1,30 @@
+---
+layout: default
+title: Bath
+parent: Locations
+---
+
+# The University of Bath
+{: .fs-9 }
+
+Serving The Universities of Bath, Bristol, Cardiff, Exeter
+{: .fs-6 .fw-300 }
+---
+
+## Date:
+21st February 2024
+
+## Building Address:
+8 West (The Physics Department). Postcode: BA2 7AY (Note: Postcode is to campus, not to the specific building)  [Link to Google Maps](https://maps.app.goo.gl/JbFK795hdW2RQYJa7). what3words of building entrance: [props.foster.divide](https://what3words.com/props.foster.divide)
+
+## Room:
+8W2.30
+
+## Directions:
+From Bath Spa train station, just across the road from the train station, there are buses U1/U2 going to campus (make sure buses go the University of Bath, *not* Bath Spa University). The buses arrive at arrival square (map below) and 8 West is a few minute walk across campus. It is also possible to walk from the train station, it takes about 30-40min, but the hill is quite steep. There is pay and display parking in the east and south carpark (see map).
+
+[Campus Map](https://www.bath.ac.uk/publications/claverton-down-campus-map/attachments/university-campus-map.pdf) (showing location of 8 West on campus.)
+
+[Parking Information](https://www.bath.ac.uk/corporate-information/visitor-car-parking-on-our-claverton-down-campus/)
+
+Please email either James ([email protected]) or the local organiser, Carolin Vilforth ([email protected]), should to request a visitor parking permit should you need one. Requests need to be made a few days in advance of the session.

docs/Locations/cambridge.md

@@ -15,7 +15,7 @@ Serving The University of Cambridge
 26th January 2024
 
 ## Building Address:
-_TBC_
+The Institute of Astronomy (IoA), University of Cambridge, Madingley Road, Cambridge, CB3 0HA
 
 ## Room:
-_TBC_
+SPO Meeting Room. Please [see this internal map of the IoA](https://www-new.ast.cam.ac.uk/about/how-find-us/map-ioa).

docs/Locations/durham.md

@@ -0,0 +1,21 @@
+---
+layout: default
+title: Durham
+parent: Locations
+---
+
+# Durham University
+{: .fs-9 }
+
+Serving Durham University and Newcastle University
+{: .fs-6 .fw-300 }
+---
+
+## Date:
+14th March 2024
+
+## Building Address:
+Ogden Centre for Fundament Physics - West, Department of Physics, Durham University, South Road, Durham DH1 3LE
+
+## Room:
+OCW017

docs/Locations/edinburgh.md

@@ -0,0 +1,21 @@
+---
+#layout: default
+#title: XXX
+#parent: Locations
+---
+
+# The University of Edinburgh
+{: .fs-9 }
+
+Serving The Universities of Edinburgh, Glasgow, and St. Andrews
+{: .fs-6 .fw-300 }
+---
+
+## Date:
+15th March 2024
+
+## Building Address:
+Higgs Centre for Innovation, Royal Observatory Edinburgh, Blackford Hill, EH9 3HJ
+
+## Room:
+Higgs Conference Room

docs/Locations/locations.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Locations
-nav_order: 4
+nav_order: 5
 has_children: true
 permalink: docs/locations
 ---

docs/Locations/surrey.md

@@ -0,0 +1,26 @@
+---
+layout: default
+title: Surrey
+parent: Locations
+---
+
+# The University of Surrey
+{: .fs-9 }
+
+Serving the London Universities and The Universities of Surrey and Sussex
+{: .fs-6 .fw-300 }
+---
+
+## Date:
+25th January 2024
+
+## Building Address:
+The Alan Turing Building on the University of Surrey Campus. Postcode: GU2 7XH (Note: the postcode is for the campus, not the specific building). [Link to Google Maps](https://maps.app.goo.gl/FTKB1YjcwvGKJcFv8).
+
+what3words of building entrance: [finds.safely.oils](https://w3w.co/finds.safely.oils).
+
+The building is number 12 on the [Stag Campus map](https://www.surrey.ac.uk/sites/default/files/2023-08/campus-map.pdf).  
+
+## Room:
+The room number is 30 BB 03. Take the lift to the 3rd floor, then when you come into the department, take the first corridor on the right, and the seminar room is on the right hand side of that corridor.
+

docs/about.md

@@ -8,7 +8,7 @@ nav_order: 2
 
 ---
 
-Each session will consist of three hour-long lectures, separated by breaks. A small amount of time will be dedicated to giving a brief introduction to the the Vera C. Rubin project, the LSST, key RSP concepts and terminology, data rights, and getting involved in the project. The remainder of the time will be spent giving demonstrations of potential use cases. These will involve going through Python code – typically in the form of Jupyter Notebooks – which demonstrate possible use cases. The aims of the sessions are to:
+Each session will consist of [four parts](./material.html) separated by breaks. Each part lasts roughly 50 minutes. The first part is dedicated to giving a brief introduction to the the Vera C. Rubin project, the LSST, key RSP concepts and terminology, data rights, and getting involved in the project. The following three parts focus on demonstrating potential use cases. These will involve going through Python code in the form of Jupyter Notebooks. The aims of the sessions are to:
 * familiarise people with the RSP environment;
 * introduce key concepts within the RSP;
 * demonstrate how to find out what data is held within the RSP;

docs/acknowledgements.md

@@ -1,7 +1,7 @@
 ---
 title: Acknowledgements
 layout: default
-nav_order: 5
+nav_order: 7
 ---
 
 # Acknowledgements

docs/data_access.md

@@ -0,0 +1,21 @@
+---
+title: Data Access
+layout: default
+nav_order: 6
+---
+
+# Data Access
+
+---
+
+**This page is for information only. You do NOT need LSST data access rights to attend the tutorials**
+
+In return for the UK's in-kind contributions to the Vera C. Rubin project, UK-based astronomers can request proprietary access to LSST data. This includes access to the Data Preview 0 datasets that are used during the *Introduction to the RSP* tutorials.
+
+The UK's in-kind package is valued at earning data rights for 300 PI's (PI = Faculty staff or senior fellow) and 1200 Junior Associates (JA = PhD students, postdocs) which is deemed to be sufficient to meet expected demand.
+
+Since the number of UK-based PIs and JAs is limited, UK-based people will, in the future, need to be members of the LSST:UK consortium to be eligible to gain those rights (at present, anyone can apply for access rights to Data Preview 0, but it is *a lot* easier for members of LSST:UK). People wishing to become members of LSST:UK need to apply during one of the calls for applictions. A call for applications is made roughly every six months, with the announcement of the calls made via the **lusc-announce** mailing list.
+
+Instructions for how to join the lusc-announce mailing list are provided [here](https://lsst-uk.atlassian.net/wiki/spaces/HOME/pages/24313864/LSST+UK+Announcements+Email+List).
+
+Once someone has data access rights they need to get an account on the Rubin Science Platform. Instructions on how to do that are provided via [this link](https://rsp.lsst.io/guides/getting-started/get-an-account.html). 

docs/dates.md

@@ -1,7 +1,7 @@
 ---
 title: Tour Dates
 layout: default
-nav_order: 3
+nav_order: 4
 ---
 
 # Tour Dates and Locations
@@ -15,17 +15,18 @@ It is expected that most people who have expressed an interest will be within ro
 | Location | Date | Time | Serving |
 |:---------|------|------|---------|
 |[U. of Nottingham](./Locations/nottingham.html)|17 Jan 2024|11am-4pm|Nottingham, Birmingham, Leicester, Warwick, Keele|
-|[U. of Oxford](./Locations/oxford.html)|22 Jan 2024|1pm-5pm|Oxford, Hertfordshire, OU|
+|[U. of Oxford](./Locations/oxford.html)|22 Jan 2024|12pm-5pm|Oxford, Hertfordshire, OU|
 |[U. of Portsmouth](./Locations/portsmouth.html)|24 Jan 2024|1pm-5pm|Portsmouth, Southampton, Sussex|
-|U. of Surrey|25 Jan 2024|1pm-5pm|London universities, Sussex|
+|[U. of Surrey](./Locations/surrey.html)|25 Jan 2024|1pm-5pm|London universities, Sussex|
 |[U. of Cambridge](./Locations/cambridge.html)|26 Jan 2024|1pm-5pm|Cambridge|
-|U. of Bath|21 Feb 2024|1pm-5pm|Bristol, Bath, Cardiff, Exeter|
+|[U. of Bath](./Locations/bath.html)|21 Feb 2024|1pm-5pm|Bristol, Bath, Cardiff, Exeter|
 |[Queen’s Belfast](./Locations/qub.html)|29 Feb 2024|1pm-5pm|Belfast, Armagh|
-|Durham University|14 March 2024|1pm-5pm|Durham, Newcastle|
+|[Durham University](./Locations/durham.html)|14 March 2024|1pm-5pm|Durham, Newcastle|
 |U. of Edinburgh|15 March 2024|12pm-5pm|Edinburgh, Glasgow, St. Andrews|
 |Lancaster University|20 March 2024|1pm-5pm|Lancaster, Liverpool, Manchester, UCLAN|
 
 ---
+Note that the above finish times are approximate and allow for questions. All material will have been presented by 4.45pm at the latest.
 
 Booked room sizes are based on the numbers of people that expressed an interest at each institute, and our expectation that most people will attend their nearest session (see the “Serving” column), but small numbers may attend other sessions. If the latter is the case for you, please email James at [email protected] to make sure there will be space at your preferred session.
 

docs/index.md

@@ -10,7 +10,7 @@ nav_order: 1
 An LSST:UK Tour
 {: .fs-6 .fw-300 }
 ---
-Many of the astrophysical insights that the LSST will provide will stem directly from the sheer volume of data delivered by the Vera C. Rubin Observatory. In many cases it will be impractical, if not impossible, to download and locally process the large amounts of data that will deliver the most groundbreaking research. With this in mind, the Rubin project will instead employ a “bring-your-code-to-the-data” model, whereby most data remains and is analysed within the Data Access Centers via the Rubin Science Platform (RSP).
+Many of the astrophysical insights that the LSST will provide will stem directly from the sheer volume of data delivered by the Vera C. Rubin Observatory. In many cases it will be impractical, if not impossible, to download and locally process the large amounts of data that will deliver the most groundbreaking research. With this in mind, the Rubin project will instead employ a “bring-your-code-to-the-data” model, whereby most data remains and is analysed within the Data Access Centers via the [Rubin Science Platform](https://data.lsst.cloud/) (RSP).
 
 Since most LSST data analysis will not be performed locally on one’s own filesystem and data formats, users will first need to become familiar with the RSP. While the learning curve is not especially steep, there are a number of concepts that are likely to be unfamiliar to many researchers when they start accessing LSST data products. With this in mind, James Mullaney from the University of Sheffield is running a number of sessions for UK-based astronomers which will introduce the Rubin Science Platform and demonstrate some of its features.
 

docs/material.md

@@ -0,0 +1,31 @@
+---
+title: Session Material
+layout: default
+nav_order: 3
+---
+
+# Session Material
+
+---
+
+Each session consists of four parts. The first part is a slides-based presentation which introduces the Rubin Project and key concepts within the Rubin Science Platform. This is followed by three tutorials that utilise jupyter notebooks to demonstrate how to interrogate the RSP databases, retrieve table and imaging data, and re-analyse some data using a re-configured LSST data processing task.
+
+All the material used during each session is freely available online via the links below. While anyone can *view* the jupyter notebooks on GitHub, they can only be *executed* from within the [Rubin Science Platform](https://data.lsst.cloud/) (RSP) since that is where the required python modules and data repositories reside. As such, anyone who wishes to execute the notebooks will need to have data access rights to log into the RSP. Please also note the the notebooks are also currently set up to use the DP0.2 dataset, although reconfiguring them to use a different dataset would only require a straightforward change of the `repo` an `collection` parameters at the start. 
+
+* Presentation: [Google Slides](https://docs.google.com/presentation/d/1TU5R4Tk8KbkuEGj4Qqk2ok00PMuIUihu32k874-ca9c/edit?usp=sharing)
+* Tutorial 1: [Jupyter Notebook](https://github.com/lsst-uk/rsp-uk-notebooks/blob/main/Intro_to_RSP/IntroToRSPSession1.ipynb)
+* Tutorial 2: [Jupyter Notebook](https://github.com/lsst-uk/rsp-uk-notebooks/blob/main/Intro_to_RSP/IntroToRSPSession2.ipynb)
+* Tutorial 3: [Jupyter Notebook](https://github.com/lsst-uk/rsp-uk-notebooks/blob/main/Intro_to_RSP/IntroToRSPSession3.ipynb)
+
+Further, while not explicitly used during the sessions, an additional notebook is provided that lists what will likely be most popular datasets, and how to retrieve them via the Data Butler:
+
+* Key dataset types: [Jupyter Notebook](https://github.com/lsst-uk/rsp-uk-notebooks/blob/main/Intro_to_RSP/KeyDatasets.ipynb)
+
+By popular request, here is a link to a page that lists what data are available via LSST's Table Access Protocol service (aka schemas). 
+
+* LSST's TAP Schema Browser: [Link](https://dm.lsst.org/sdm_schemas/browser/)
+
+And here are links to the online documentation for the Astronomy Database Query Language (ADQL) and the Table Access Protocol (TAP):
+
+* ADQL Online Documentation: [Link](https://www.ivoa.net/documents/ADQL/20180112/PR-ADQL-2.1-20180112.html)
+* TAP Online Documentation: [Link](https://www.ivoa.net/documents/TAP/20190927/REC-TAP-1.1.html)