Skip to content

Commit

Permalink
modify rationale for hack-week format for 2024 (#3)
Browse files Browse the repository at this point in the history
  • Loading branch information
kecnry authored Jan 23, 2024
1 parent 15bb5d5 commit f078086
Show file tree
Hide file tree
Showing 6 changed files with 22 additions and 84 deletions.
4 changes: 1 addition & 3 deletions at_the_meeting.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Meeting Location

The 2023 meeting will be held the University of Ljubljana, Slovenia in the Department of Mathemeatics and Physics, which is located at:
The 2024 meeting will be held the University of Ljubljana, Slovenia in the Department of Mathematics and Physics, which is located at:
Jadranska ulica 19,
1000 Ljubljana,
Slovenia.
Expand All @@ -15,5 +15,3 @@ There are many hotels in the center of Ljubljana that are within walking distanc
* [Vila Teslova](https://www.facebook.com/vilateslova/?locale=sl_SI)
* [Hotel Mrak](https://hotelmrak.si/en/)
* [City Hotel](https://www.cityhotel.si/)


6 changes: 3 additions & 3 deletions important_dates.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Important Dates

* Registration deadline: 24th March 2023
* Notification of selection: 27th March 2023
* Meeting dates: 19th - 23rd June 2023
* Registration deadline: 24th March 2024
* Notification of selection: 27th March 2024
* Meeting dates: 10th - 14th June 2024
72 changes: 7 additions & 65 deletions materials.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,8 @@
<div style="text-align: center">
<a href="http://phoebe-project.org/static/workshops/PHOEBE_workshop_5.jpg" target="_blank" rel="noopener noreferrer"><img src="http://phoebe-project.org/images/workshops/PHOEBE_workshop_5_thumb.jpg" height="200" maxWidth="80%"/></a>
</div>

# Installing & Setup

### Jupyter Notebooks

The tutorials at the workshop will make heavy use of [Jupyter notebooks](https://jupyter.org/install). If you'd prefer, you can copy and paste from the files into an interactive Python or IPython session, but if you'd like to follow along directly in Jupyter, please make sure that you have Jupyter up and running and can import PHOEBE (more on that next).

The Jupyter notebooks (and talks) will all be linked below so that you can pull them up to view in the browser, or download and run locally on your own machine as we go through them. Please note, these will not be avilable until we solidify the program.

### Installing PHOEBE

During the workshop, we will be using the 2.4 version of PHOEBE. We'll also be using `emcee`, `scikit-learn`, and `celerite2` for some fitting exercises. The easiest way to install is via pip (you're welcome to install within a virtual or conda environment if you'd like, just make sure you know how to activate that environment from within Jupyter):
During the workshop, we will be using the 2.4 version of PHOEBE. `emcee`, `scikit-learn`, and `celerite2` will also be useful for any fitting. The easiest way to install is via pip (you're welcome to install within a virtual or conda environment if you'd like, just make sure you know how to activate that environment from within Jupyter):

```
pip install numpy
Expand All @@ -33,66 +23,18 @@ You can check to make sure the correct version is installed in a Python console

If you have any troubles before the meeting, please reach out to us for assistance.


### Testing Your Installation


Please test your installation well in advance of the workshop by running the [test script](https://raw.githubusercontent.com/phoebe-project/phoebe2-workshop/2022june/test_install.py) (should take approximately 60 seconds to run) and make sure it completes without any errors (warning messages are not a cause for concern). If the script does not run successfully or takes significantly longer than 60 seconds, please reach out to us so we can debug any installation issues in advance.

# Workshop Talks & Tutorials

### Monday June 19: Overview and Building Systems in PHOEBE

* [Welcome & Introduction](https://docs.google.com/presentation/d/e/2PACX-1vS8VXgvYJV4cXrnwF8XMLbZoKJqiTRQJcFv_GXnJrLOcn6QyU7JHJJ7ZH5totNOQIPSu1yawF1kL1m1/pub?start=false&loop=false&delayms=3000) (Kelly)
* [Talk: PHOEBE Overview - wdgui to PHOEBE](https://docs.google.com/presentation/d/e/2PACX-1vT1no8csPNugrLUarxISYj_jtFidp6vMzzNj3jUkqTsUTw9ozOQ1wqh79kSaL-xLXZcSWKQ8UyNI_RE/pub?start=false&loop=false&delayms=3000) (Andrej)
* [Talk: Introduction to PHOEBE 2: why so complicated?](https://docs.google.com/presentation/d/e/2PACX-1vR_okhrCOKLqCW_d_cBiq5CwaIBWREYbIXPwB-AnndvYA8g9Xxs91rlZBjHLpEzzCp622i19hbsaxLh/pub?start=false&loop=false&delayms=3000) (Kyle)
* [Tutorial: General Concepts & Bundle Basics](./Tutorial_01_bundle_basics.ipynb) (Andrej)
* [Tutorial: Constraints](./Tutorial_02_constraints.ipynb) (Michael)
* [Exercises: Building Systems](./Exercises_01_building_systems.ipynb)
* [Optional Breakout Session: In Development - Blended Atmosphere Tables](https://docs.google.com/presentation/d/e/2PACX-1vSI-dNQSiGfNqttEuOzEd-iD2HIFfrvPVtFhk__I4YCwqOAo9cy047Tbkk74MkYgiRgO4iePvYf2Ss3/pub?start=false&loop=false&delayms=3000) (Andrej)
* [Optional Breakout Session: Line Profiles with PHOEBE and SPAMMS](https://docs.google.com/presentation/d/e/2PACX-1vTnWRdVfhC4bbrzGyP7kzhoMbZCOzyBbjJaRFJiMIUkpeSitL5Eqd_Dt1Ip3RZhPLhUvlKS1-iqnC0h/pub?start=false&loop=false&delayms=3000) (Michael)
Please test your installation well in advance of the workshop by running the [test script](https://raw.githubusercontent.com/phoebe-project/phoebe2-workshop/2024june/test_install.py) (should take approximately 60 seconds to run) and make sure it completes without any errors (warning messages are not a cause for concern). If the script does not run successfully or takes significantly longer than 60 seconds, please reach out to us so we can debug any installation issues in advance.

### Prerequsite Comfort with PHOEBE

### Tuesday June 20: Creating Forward Models
Unlike previous PHOEBE Workshops, where participants were taught the basics of PHOEBE, the purpose of this workshop is to improve on existing models, generate publishable results, and for participants to become advanced PHOEBE users. For this reason, workshop participants are expected to have either already attended a PHOEBE Workshop or to be actively using PHOEBE. Prior to the workshop, participants should be familiar with concepts including: setting parameter values, manipulating constraints, running forward models, and using estimators, optimizers, and samplers. If you are not regularly using PHOEBE, please consider running through the online tutorials or videos from last year's workshop before arrival.

* [Talk: Atmospheres, Limb Darkening, Intensity Weighting, Extinction, and Reflection](https://docs.google.com/presentation/d/e/2PACX-1vQ9ba54aHX5cwTNN2eJfRdG5nLXFqoOKLLUl9I0_sGwVYX2BEVLQDjQh1po8xti6bzbDAzD7sIT3ACH/pub?start=false&loop=false&delayms=3000) (Dave)
* [Tutorial: Datasets](./Tutorial_03_datasets.ipynb) (Andrej)
* [Tutorial: Compute](./Tutorial_04_compute.ipynb) (Michael)
* [Tutorial: Time and Phase](./Tutorial_05_time_and_phase.ipynb) (Andrej)
* [Tutorial: Plotting](./Tutorial_06_plotting.ipynb) (Kyle)
* [Exercises: Creating Forward Models](./Exercises_02_forward_models.ipynb)
* Optional Breakout Session: Preview of lcviz (Kyle)
# Workshop Schedule

### Monday June 10: Introduction and Hack Pitches

### Wednesday June 21: Advanced Physics & Features

* Talk: Scientific Introduction to PHOEBE (Andrej)
* [Tutorial: Animations](./Tutorial_07_animations.ipynb) (Michael)
* [Tutorial: Accessing and Plotting Meshes](./Tutorial_08_meshes.ipynb) (Kyle)
* [Tutorial: Flux Scaling (Passband Luminosity, Third Light, and Distance)](./Tutorial_09_pblum_l3_distance.ipynb) (Andrej)
* [Tutorial: Features (Spots & Gaussian Processes)](./Tutorial_10_features.ipynb) (Kyle)
* [Tutorial: Optimizing PHOEBE Computations](./Tutorial_11_optimizing_computations.ipynb) (Kyle)
* [Exercises: Forward Model Animations](./Exercises_03_animations.ipynb)
* Optional: Public Seminar - Modelling of solar filaments and prominences with non-LTE radiative transfer in 1D and 2D (4:00 pm in F2)
* Evening: Open House at Observatory (8:30-11:00+ pm at Golovec)


### Thursday June 22: Introduction to Fitting

* [Talk: Inverse Problem in PHOEBE](https://docs.google.com/presentation/d/e/2PACX-1vSZxGLuuJAf2_imhVVhGAW_xoeOgmEI-0YWbnfES2XaUz8YO1jGdHe8652c8flxiSGotJQQF1eGp16R/pub?start=false&loop=false&delayms=3000) (Andrej)
* [Tutorial: Estimators](./Tutorial_12_estimators.ipynb) (Michael)
* [Tutorial: Optimizers](./Tutorial_13_optimizers.ipynb) (Kyle)
* [Exercises: Estimators & Optimizers](./Exercises_04_estimators_optimizers.ipynb)
* [Tutorial: Distributions & Priors](./Tutorial_14_distributions.ipynb) (Kyle)
* [Optional Breakout Session: Detrending](./Tutorial_detrending.ipynb) (Kelly)
* [Optional Breakout Session: In Development - Pulsations](https://docs.google.com/presentation/d/e/2PACX-1vR54syXqzX9MiGxsHdus7A7xDjS3_4ka3TyQiXpoBzCduwAiEymK0zxn40zSrBaNDQ3SodwxlY3p6mm/pub?start=false&loop=false&delayms=3000) (Andrej)
* Evening: Conference Dinner


### Friday June 23: Advanced Fitting

* [Tutorial: MCMC Basics in PHOEBE](./Tutorial_15_mcmc.ipynb) (Andrej)
* [Tutorial: Continuing/Resampling in MCMC](./Tutorial_16_mcmc_continued.ipynb) (Andrej)
* [Welcome & Introduction](https://docs.google.com/presentation/d/e/2PACX-1vS8VXgvYJV4cXrnwF8XMLbZoKJqiTRQJcFv_GXnJrLOcn6QyU7JHJJ7ZH5totNOQIPSu1yawF1kL1m1/pub?start=false&loop=false&delayms=3000) (Kelly)
* [Exercises: Setting up an MCMC Run](./Exercises_08_mcmc.ipynb)
* [Optional Breakout Session: Contact Binaries](./Tutorial_semidetached_contact.ipynb) (Michael)
* [Optional Breakout Session: PHOEBE Backend Under-the-Hood](./libphoebe_intro.ipynb) (Martin)
9 changes: 4 additions & 5 deletions rationale.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
# Announcement
The PHOEBE team is excited to announce the Fifth PHOEBE 2 Workshop! The in-person Workshop will provide participants with an introduction to PHOEBE, including a day dedicated to fitting. The Workshop will take place at the University of Ljubljana on June 19th - June 23rd 2023.
The PHOEBE team is excited to announce the Sixth PHOEBE 2 workshop! This year, the workshop will follow a hack-week format (implementing new features in PHOEBE as well as using PHOEBE for real science use-cases) and focus on advanced topics. The workshop will take place at the University of Ljubljana on June 10th - June 14th 2024.

The aim of the Workshop is to give participants a thorough introduction to modeling binary systems using PHOEBE 2, including a day that is dedicated to fitting with estimators, optimizers and samplers.
The aim of this workshop is to give participants a chance to collaboratively contribute to PHOEBE as well as to work on their own personal science with PHOEBE. General knowledge and comfort with PHOEBE is considered a prerequisite - previous workshop attendees are encouraged to attend as are new participants who commit to running through the online tutorials and/or recordings from last year's workshop in advance.

# Scientific Rationale
PHOEBE 2 (Prša et al. 2016) is a highly flexible binary star modeling code with many updated features. The model includes new advanced fitting, a new graphical user interface, support for extinction, support for spin-orbit misalignment, and many more features. In addition to this vast array of new features, the frontend has also been updated and is now based on the python programming language.
PHOEBE 2 (Prša et al. 2016, Horvat et al. 2018, Jones et al. 2020, Conroy et al. 2020) is a highly flexible binary star modeling code with many updated features. The model includes new advanced fitting, support for extinction, support for spin-orbit misalignment, and many more features. In addition to this vast array of new features, the frontend has also been updated and is now based on the python programming language.

# Main Objectives
The Workshop will take place over five days where each day will contain talks and tutorials with targeted assignments so that the participants become familiar with the workings of PHOEBE 2. During this week, participants will take part in introductory walk-through tutorials to PHOEBE 2 and will acquire hands-on experience with creating binary star models. By the end of the Workshop, participants should be able to independently use PHOEBE 2 to create a forward model of a binary system and will be able to apply PHOEBE's basic fitting functionality to fit a model to data.

The workshop will take place over five days and follow a loosely-scheduled hack-week format. The majority of the time will be dedicated to working on individual or small-group hacks - using PHOEBE to fit real data, creating new example notebooks that illustrate advanced workflows, fixing bugs, implementing features, etc. We will work to create a collaborative and open environment where everyone feels comfortable sharing their progress and challenges as well as asking and answering questions. By the end of the workshop, participants can expect to have made progress on their own science using PHOEBE and/or feel more confident modifying and contributing to the source code.
4 changes: 2 additions & 2 deletions registration.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

This workshop is primarily intended for graduate students, postdocs and early career scientists, although all are invited to attend. Participants are expected to be comfortable scripting in Python and have a Mac or Linux machine with PHOEBE 2.4 installed.
This workshop is primarily intended for graduate students, postdocs and early career scientists, although all are invited to attend. Participants are expected to be comfortable using PHOEBE (setting parameter values, manipulating constraints, running forward models, and setting up basic fitting runs) and have a Mac or Linux machine with PHOEBE 2.4 installed.

# Registration
Registration costs a flat fee of $200. Fee waivers are available upon request: anyone paying out-of-pocket or those that have limited funds are eligible for a fee waiver. To request a fee waiver, please contact Kelly Hambleton ([email protected]). The number of participants is limited to 25 and participants are selected on a first-come first-serve basis.
The cost of registration is $200. Fee waivers are available upon request: anyone paying out-of-pocket or those that have limited funds are eligible for a fee waiver. To request a fee waiver, please contact Kelly Hambleton ([email protected]). Participants are selected on a first-come first-serve basis.

Those interested are invited to fill out the registration form, which can be found [here](https://forms.gle/r79XNWPXQ1eXhv7v6).
11 changes: 5 additions & 6 deletions schedule.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,8 @@

Preliminary schedule (subject to change):

* Monday: Overview and Building Systems in PHOEBE
* Tuesday: Creating Forward Models
* Wednesday: Plotting and Advanced Physics & Features
* Thursday: Introduction to Fitting
* Friday: Upcoming Features and "Hack day"

* Monday Morning: Hack Pitches and Breakout Refresher Tutorials
* Monday Afternoon: Start Hacks
* Tuesday-Friday Morning: Requests for collaboration and breakout discussion/tutorial sessions, continue working on hacks
* Tuesday-Thursday Afternoon: 5-minute progress presentations
* Friday Afternoon: Present results and wrap-up

0 comments on commit f078086

Please sign in to comment.