Giter Club home page Giter Club logo

forecasting-course's Introduction

DOI DOI

Ecological Forecasting & Dynamics Course

This is a course on how ecological systems change through time and how to forecast how they will change in the future. It combines reading and discussing primary scientific literature with R tutorials on how to work with time-series data and make forecasts in R. It is taught each Fall at the University of Florida by Drs. Morgan Ernest and Ethan White. The full course including lecture notes and R tutorials is openly available so that students can learn these important approaches and skills for themselves and so that other teachers can reuse and remix the content of the course.

Getting Started

Using Materials to Learn About Ecological Forecasting

To use the materials for learning we recommend viewing them through the rendered website. Check out the Getting Started page to find out how to best use the site for independent learning.

Using Materials to Teach Ecological Forecasting

All of the code, lesson content, data, and infrastructure for this site is openly licensed so you can use any of it in your own courses.

Lesson material can be accessed from the website or using the raw markdown files in the content/lessons directory of this repository. Each lesson is stored in its own named subdirectory.

There are three general approaches to using the material in teaching:

  1. Use the existing website by linking to one or more lessons from your course site and reading the associated instructors material
  2. Copy material from either the website or this GitHub repository and place it on your own site. You can modify this version however you would like (or leave it unchanged), just provide a link back to the original version for attribution.
  3. Create a copy of the full website and (optionally) modify the lessons and/or change which lessons are included. More information on how to do this is provided in the rest of the README.

Installation

The course website is written in Hugo using the Wowchemy Documentation theme and broader Wowchemy system

Netlify

The easiest way to create your own version of the course is the create a deployed course on Netlify via this template. You need a GitHub account to do this.

Follow the Wowchemy instructions for Creating a site with Hugo and GitHub, but instead of using the "Choose a template" button click this template link.

This will create a GitHub repository in your GitHub account and live version of the site. You can then edit files in the GitHub repository and they will automatically deploy to the website.

Edit config/_default/params.yaml to match your version of course. In particular update the repository url to match the new repository you created. This will ensure that the Edit this page links on each page direct you to your version of the material.

Locally

Building a Hugo site locally requires that Go, git, NodeJS, and Hugo all be installed. Detailed instructions for all operating systems are available on the Wowchemy - Edit on your PC with Hugo Extended page.

Once you have a local Hugo installation working clone the site using:

git clone https://github.com/weecology/forecasting-course.git

You can build the site locally in the terminal from the root directory of this repository using:

hugo server

Modifying the Site

  • Most content is stored in one folder per lesson in the content/lessons folder
  • To add a new lesson make a copy of the lesson template folder and modifying the pages in the resulting folder using markdown
  • To modify a lesson edit the markdown files in that lesson folder with the appropriate name. If you followed the instructions on installing on Netlify above, the easiest way to do this is to go to the page you want to edit on the deployed site and click the Edit this page link at the bottom.
  • To modify the schedule edit content/schedule/schedule.md. In the lessons section list the titles of the lessons you want to teach in the order you want to teach them. If you want to include specific dates for each lesson then edit the dates section to include those dates in the same order.

Contributing

Contributions are always welcome!

  • Open an issue to say Hi or if there’s anything we can do to help!
  • Contributions of new lessons are welcome as Pull Requests or we can work with you to add new material and data to the site
  • If you want to create a modified copy of the course including the website either following the instructions for installing on Netlify above or fork/copy the repository and connect it to Netlify to automatically build the site.

For more information see our CONTRIBUTING page

forecasting-course's People

Contributors

arokem avatar dependabot[bot] avatar ethanwhite avatar ha0ye avatar omahs avatar skmorgane avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

forecasting-course's Issues

Have students fit mvgam model before class to trigger additional build steps

Following all the setup instructions for the advanced time-series modeling material doesn't actually fully finish the install. The first time you try to fit a model cmd_stan does some additional source build steps. This is too slow for class and sometimes installs fail entirely at this point. So, we need to have students fit a simple model as part of the install to ensure that the installation is actually complete and works.

Add discussion of use of term "stakeholder" to ethics paper

We've removed the use of the term "stakeholder" generally from our materials following on discussions like this:
https://www.fasttrackimpact.com/post/why-we-shouldn-t-banish-the-word-stakeholder?postId=1a6b9631-56a5-416e-a796-86d6dfb30d87

However it features so prominently in the paper we read on ecological forecasting ethics it can't simply be avoided. It seems appropriate to add a brief discussion of the ethics related this term in the context of the lesson.

Add 2 weeks on GAMS

One way to do this would be dropping EDM & SDM, though the SDM section is very popular.

Possible figure for paper

paragraph 2 of "General instructional design" in paper.md :

The instructors then lead a group discussion on the paper, guiding the students through the discussion questions and integrating mini-lectures where appropriate to address common points of confusion about the paper (e.g., walking through a complicated modeling approach).

To help explain the linkage between the discussion of the paper and mini-lectures, I created a possible diagram with some hypothetical topics:
https://docs.google.com/drawings/d/1mspzqPr8J_nV4ILirX1m9Yl2IBwbOxX1jMFf6hOEk30/edit?usp=sharing

@ethanwhite and @skmorgane should be able to edit directly; and everyone should have commenting access.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.