estimate densities from point patterns

.github/pull_request_template.md

@@ -0,0 +1,57 @@
+<!--- indicate the Title for this pull request (PR) above -->
+
+<!--
+Thank you for contributing to the INBO tutorials repository.
+-->
+
+## Description
+<!--- Briefly describe the tutorial or article that you want to contribute
+or update-->
+<!--- You can mention collaborators with "@githubname"-->
+
+
+## Related Issue
+<!--- if this closes an issue make sure to include e.g., "closes #4"
+or similar - or if it just relates to an issue make sure to mention
+it like "#4" -->
+<!--See https://docs.github.com/en/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword-->
+
+
+## Task list
+
+<!--see https://docs.github.com/en/github/managing-your-work-on-github/about-task-lists
+for an explanation on how to use task lists-->
+
+<!-- Please check if the following steps are OK:-->
+
+- [ ] My tutorial or article is placed in a subfolder of `tutorials/content/`
+- [ ] The novel tutorial has a meaningful name, in relation to the content of the tutorial.
+- [ ] The filename of my tutorial or article is `index.md`. In case of an Rmarkdown tutorial I have knitted my `index.Rmd` to `index.md` (both files are pushed to the repo). 
+- `yaml` header:
+    - [ ] *(recommended)* I am included as author in the `authors` yaml tag, using `[MY_AUTHOR_ID]`. An author information file exists in `<tutorials>/data/authors/<author>.toml`.
+    - [ ] I have added `categories` to the YAML header and my category tags are from the [list of categories](https://github.com/inbo/tutorials/blob/master/static/list_of_categories).
+    - [ ] I have included meaningful and applicable `tags` (i.e. keywords) in the YAML header to improve the visibility of the new tutorial (see the tags listed in the [tutorials website side bar](https://inbo.github.io/tutorials/)).
+    - [ ] The `date` is in format `YYYY-MM-DD` and adjusted.
+- [ ] *(recommended)* I have previewed this PR locally (see steps below; ask previous contributors for help) and confirmed that the new content renders as expected.
+
+
+## Previewing the pull request
+
+Thanks to GitHub Actions, an artifact (=zip file) of the rendered website is automatically created for each pull request.
+This provides a way to preview how these updates will look on the website, useful to contributors and reviewers.
+
+### Instructions to preview the updated website
+
+1) On the PR page, you can find a "details" link under "checks - On PR, build the site and ...". Go there, click on the top link in the left sidebar ("Summary"), and download the generated artifact at the bottom of the page.
+2) Decompress it into a target directory, e.g. `Downloads/tutorials_preview`.
+3) To preview the website, use a program which can serve `http` sites on your local machine. One such option is [the `servr` package](https://github.com/yihui/servr) in R: `& '\C:\Program Files\R\R-4.4.2\bin\Rscript.exe' -e "servr::httd('./tutorials_preview')" -p8887` (*make sure to adjust the path to your `Rscript.exe`*; on Linux, simply use `Rscript -e [...]`).
+4) Point your browser to http://localhost:8887.
+5) Review the updated website. As a contributor, you can push extra commits to update the PR. As a reviewer, you can accept/refuse/comment the PR.
+
+**Note: for step 3, you can use any other simple HTTP server to serve the current directory, e.g. [Python `http.server`](https://docs.python.org/3/library/http.server.html): `python -m http.server 8887 --bind localhost --directory path/to/tutorials_preview`**
+
+
+### Alternative: Locally Building the Site
+
+Alternatively, you can build the entire site locally ([see the README for instructions](https://github.com/inbo/tutorials?tab=readme-ov-file#building-the-site)); the Hugo preview server will update changes on the fly.
+This requires [Hugo](https://gohugo.io/getting-started) to be installed on your computer.

.github/workflows/deploy-gh-pages.yml

@@ -0,0 +1,45 @@
+name: Build the site and deploy to GitHub pages
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout (tutorials)
+        uses: actions/checkout@v3
+        with:
+          submodules: true  # Fetch Hugo themes (true OR recursive)
+          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Checkout (theme)
+        uses: actions/checkout@v3
+        with:
+          repository: MunifTanjim/minimo
+          ref: v2.9.0
+          path: themes/minimo
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v2
+        with:
+          hugo-version: '0.88.1'
+          # extended: true
+
+      - name: Build
+        run: hugo
+
+      # Need to add post build for the search functionality...
+      - name: Install JS dependencies to build the index
+        run: npm install lunr glob
+
+      - name: Generate search index
+        run: node themes/minimo/scripts/generate-search-index-lunr.js
+
+      - name: Deploy 🚀
+        uses: JamesIves/[email protected]
+        with:
+          branch: gh-pages
+          folder: public

.github/workflows/generate-artifact-pr.yml

@@ -0,0 +1,46 @@
+name: On PR, build the site and save the result to an artifact
+
+on:
+  pull_request
+
+jobs:
+  build-and-save:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout (tutorials)
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          submodules: true  # Fetch Hugo themes (true OR recursive)
+          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Checkout (theme)
+        uses: actions/checkout@v3
+        with:
+          repository: MunifTanjim/minimo
+          ref: v2.9.0
+          path: themes/minimo
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v2
+        with:
+          hugo-version: '0.88.1'
+          # extended: true
+
+      - name: Build
+        run: hugo
+
+      # Need to add post build for the search functionality...
+      - name: Install JS dependencies to build the index
+        run: npm install lunr glob
+
+      - name: Generate search index
+        run: node themes/minimo/scripts/generate-search-index-lunr.js
+
+      - name: Archive built site to an artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: pr-${{ env.PR_NUMBER }}-inbo-tutorials-website
+          path: public
+        env:
+          PR_NUMBER: ${{ github.event.number }}

.github/workflows/remove_old_artifact.yaml

@@ -0,0 +1,18 @@
+name: Remove old artifacts
+
+on:
+  schedule:
+    # Every day at 1am
+    - cron: '0 1 * * *'
+
+jobs:
+  remove-old-artifacts:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+    - name: Remove old artifacts
+      uses: c-hive/gha-remove-artifacts@v1
+      with:
+        age: '1 days'
+        skip-recent: 5

.gitignore

@@ -59,3 +59,10 @@ content/**/*.html
 
 # Temporary download files
 2016-04-20-processed-logs*
+
+# Local folders with binary data
+data_gisclub/
+
+# png images for the brms tutorial
+/content/tutorials/r_brms/brms_eng/*.png
+/content/tutorials/r_brms/brms_nl/*.png