Skip to content

Commit

Permalink
General revision of structure
Browse files Browse the repository at this point in the history
  • Loading branch information
paocorrales committed Feb 14, 2024
1 parent 85c1881 commit 8168e7a
Show file tree
Hide file tree
Showing 4 changed files with 16 additions and 21 deletions.
2 changes: 1 addition & 1 deletion _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ project:
output-dir: _site

website:
title: "DA-documentation"
title: "Data Assimilation docs"
repo-url: https://github.com/paocorrales/DA-documentation
issue-url: https://github.com/paocorrales/DA-documentation/issues/new/choose
repo-actions: [edit, issue]
Expand Down
12 changes: 6 additions & 6 deletions about.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
title: "About"
---

This guide is a compilation of many tools scripts, pieces of code and routines that I used during my PhD. As the name says, everything goes around assimilating observations using the GSI system. I spent a lot of time working with the conventional and Radiance observations so you will find a comprehensive tutorial and documentation on how to assimilate these types of observations. This includes the processing of the observations, how to configure the system and all the quality control steps GSI performs during the assimilation process.
## Hi!

Sometimes you will find everything inside the website and sometimes you will need to go to a specific repository to get the code or the data associated with the the specific topic. And while I tried to be mindful during my PhD at commenting and documenting everything along the way I'm sure that there are gaps and missing pieces. If you find anything that can be improved please open an issue in the repository of this website and contribute to making this guide better.
I'm Pao Corrales and I have a PhD in Atmospheric Science! The main goal of my research was to applied data assimilation techniques to improve short-term forecasts of severe events in Argentina. In particular, the research focuses on data assimilation of observations from automatic stations and radiances from polar and geostationary satellites. You can read the final dissertation (in Spanish) [here](https://paocorrales.github.io/Tesis_doctorado/).

Many of these tools come from different sources. Sometimes someone else wrote the code and I adapted it to my specific needs, sometimes I wrote the code from scratch. So it's important to read the license note in each section so you know who created that code and in which way you can use it.
I worked in the [Centro de Investigaciones del Mar y la Atmósfera](https://www.cima.fcen.uba.ar/index.php) (CIMA), for that reason you may find mentions to Hydra or Yakaira, their HPC and a server I used a lot.

## About my PhD
This guide is a compilation of many tools, scripts, pieces of code and routines that I used during my PhD. As the name says, everything goes around assimilating observations using the GSI system. I spent a lot of time working with the conventional and Radiance observations so you will find a comprehensive tutorial and documentation on how to assimilate these types of observations. This includes the processing of the observations, how to configure the system and all the quality control steps GSI performs during the assimilation process.

The main goal of may research was to applied data assimilation techniques to improve short-term forecasts of severe events in Argentina. In particular, the research focuses on data assimilation of observations from automatic stations and radiances from polar and geostationary satellites. You can read the final dissertation (in Spanish) [here](https://paocorrales.github.io/Tesis_doctorado/).
Sometimes you will find everything inside the website and sometimes you will need to go to a specific repository to get the code or the data associated with the the specific topic. And while I tried to be mindful during my PhD at commenting and documenting everything along the way I'm sure that there are gaps and missing pieces. If you find anything that can be improved please [open an issue in the repository](contribute.qmd) of this website and contribute to make this guide better.

I worked in the [Centro de Investigaciones del Mar y la Atmósfera](https://www.cima.fcen.uba.ar/index.php) (CIMA), for that reason you may find mentions to Hydra or Yakaira, their HPC and a server I used a lot.
Many of these tools come from different sources. Sometimes someone else wrote the code and I adapted it to my specific needs, sometimes I wrote the code from scratch. So it's important to read the license note in each section so you know who created that code and in which way you can use it.
11 changes: 5 additions & 6 deletions contribute.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,20 @@
title: "How to contribute"
---

This outlines how to propose a change to DA-documentation.
This outlines how to propose a change to this website.

## Fixing typos

You can fix typos, spelling mistakes, or grammatical errors in the documentation directly using the GitHub web interface, as long as the changes are made in the source file. This will automatically open a pull request
You can fix typos, spelling mistakes, or grammatical errors in the documentation directly using the GitHub web interface, as long as the changes are made in the source file. This will automatically open a pull request in the repo.

## Bigger changes

If you want to make a bigger change, it's a good idea to first file an issue to start a conversation.
If you want to make a bigger change, it's a good idea to first open an issue to start a conversation.

## Pull request process

To open a pull request you'll need to fork the repository. This website is builded with quarto, make sure you have it installed if you want to build the website locally to test the chances you are proposing.
To open a pull request you'll need to fork the repository. This website is built with quarto, make sure you have it installed if you want to build the website locally to test the chances you are proposing.

## Acknowledgements

If you contribute to this guide, I'd like to publicly acknowledge you work. Please indicate in you PR if you want to be add to the [Contributors page](contributors.qmd).

If you contribute to this guide, I'd like to publicly acknowledge your work. Please indicate in you PR if you want to be add to the [Contributors page](contributors.qmd).
12 changes: 4 additions & 8 deletions index.qmd
Original file line number Diff line number Diff line change
@@ -1,19 +1,15 @@
::: {.callout-important}
## This is a work in progress
# Welcome!

Comeback later to see more or, if you want to contribute, open an issue in the associated repo.
:::

This website compiles a series of tutorials, scripts and in general a comprehensive documentation around the [GSI system V3.7 - EnKF V1.3](https://dtcenter.org/community-code/gridpoint-statistical-interpolation-gsi). It focus on the use of GSI as a observation operator along with the LETKF version. It covers everything you need from how to deal with observations (in bufr format), how to configure the system to how read and interpret GSI outputs.
This website compiles a series of examples, tutorials, scripts and in general a comprehensive documentation around the [GSI system V3.7 - EnKF V1.3](https://dtcenter.org/community-code/gridpoint-statistical-interpolation-gsi). It focus on the use of GSI as a observation operator along with the EnKF version. It covers everything you need to know from how to deal with observations (in bufr format), how to configure the system to assimilate conventional and radiance observtions to how to read and interpret GSI outputs.

## A note about using this material

While the text in this guide is released under a [Creative Commons Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/), specific scripts or programming routines may have different licences and authors. If you use the material in any way, make sure to check the Licence note associated to each section and cite it appropriately.
While the text in this guide is released under a [Creative Commons Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/), specific scripts or programming routines may have different licences and authors. If you use the material in any way, make sure to check the note associated to each section and cite it appropriately.

## Citing this guide

You can cite this guide using its Zenodo metadata and DOI <TBD>.

## Do you want to contribute?

Any contribution is welcome, please read [this guide](contribute.qmd) to learn how to do it.
Any contribution is welcome, please read [this guide](contribute.qmd) to learn how to do it.

0 comments on commit 8168e7a

Please sign in to comment.