Skip to content

Commit

Permalink
Update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
dieghernan committed Nov 28, 2024
1 parent 0322618 commit 4ec7bd8
Show file tree
Hide file tree
Showing 7 changed files with 85 additions and 163 deletions.
1 change: 1 addition & 0 deletions .github/workflows/test-coverage.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -80,3 +80,4 @@ jobs:
- name: R CMD Check examples
if: always()
uses: r-lib/actions/check-r-package@v2

5 changes: 1 addition & 4 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -199,9 +199,6 @@ references:
email: [email protected]
orcid: https://orcid.org/0000-0002-4035-0289
year: '2024'
identifiers:
- type: url
value: https://arxiv.org/abs/1403.2805
doi: 10.32614/CRAN.package.jsonlite
version: '>= 1.7.0'
- type: software
Expand Down Expand Up @@ -400,7 +397,7 @@ references:
abstract: 'mapSpain: Administrative Boundaries of Spain'
notes: Suggests
url: https://ropenspain.github.io/mapSpain/
repository: https://CRAN.R-project.org/package=mapSpain
repository: https://ropenspain.r-universe.dev
authors:
- family-names: Hernangómez
given-names: Diego
Expand Down
106 changes: 53 additions & 53 deletions README.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion codemeta.json
Original file line number Diff line number Diff line change
Expand Up @@ -363,7 +363,7 @@
},
"applicationCategory": "Meteorology",
"isPartOf": "https://ropenspain.es/",
"fileSize": "865.133KB",
"fileSize": "856.092KB",
"citation": [
{
"@type": "SoftwareSourceCode",
Expand Down
33 changes: 9 additions & 24 deletions vignettes/climaemet.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -87,25 +87,10 @@ See how a `tibble` is displayed:
# See a tibble in action

aemet_last_obs("9434")
#> # A tibble: 13 × 25
#> idema lon fint prec alt vmax vv dv lat dmax
#> <chr> <dbl> <dttm> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl>
#> 1 9434 -1.00 2024-11-27 20:00:00 0 249 2.1 0.3 294 41.7 228
#> 2 9434 -1.00 2024-11-27 21:00:00 0 249 2.1 0.8 262 41.7 298
#> 3 9434 -1.00 2024-11-27 22:00:00 0 249 1.5 0.9 274 41.7 245
#> 4 9434 -1.00 2024-11-27 23:00:00 0 249 2.1 1 115 41.7 230
#> 5 9434 -1.00 2024-11-28 00:00:00 0 249 1 0.7 306 41.7 153
#> 6 9434 -1.00 2024-11-28 01:00:00 0 249 1.5 0.8 307 41.7 298
#> 7 9434 -1.00 2024-11-28 02:00:00 0 249 2.5 1.5 245 41.7 233
#> 8 9434 -1.00 2024-11-28 03:00:00 0 249 2.6 0.8 340 41.7 243
#> 9 9434 -1.00 2024-11-28 04:00:00 0 249 1.2 0.8 258 41.7 250
#> 10 9434 -1.00 2024-11-28 05:00:00 0 249 1.3 0.2 302 41.7 175
#> 11 9434 -1.00 2024-11-28 06:00:00 0 249 1.4 1 89 41.7 70
#> 12 9434 -1.00 2024-11-28 07:00:00 0 249 1.3 0.7 93 41.7 125
#> 13 9434 -1.00 2024-11-28 08:00:00 0 249 1.6 0.7 66 41.7 65
#> # ℹ 15 more variables: ubi <chr>, pres <dbl>, hr <dbl>, stdvv <dbl>, ts <dbl>,
#> # pres_nmar <dbl>, tamin <dbl>, ta <dbl>, tamax <dbl>, tpr <dbl>,
#> # stddv <dbl>, inso <dbl>, tss5cm <dbl>, pacutp <dbl>, tss20cm <dbl>
#> Error in `httr2::req_perform()` at climaemet/R/aemet_api_query.R:308:3:
#> ! Failed to perform HTTP request.
#> Caused by error in `curl::curl_fetch_memory()`:
#> ! Failure when receiving data from the peer [opendata.aemet.es]: Recv failure: Connection was reset
```

Note that when possible, data representing dates and numbers are converted to
Expand All @@ -130,6 +115,10 @@ all_stations <- aemet_daily_clim(
start = "2021-01-08", end = "2021-01-08",
return_sf = TRUE
)
#> Error in `httr2::req_perform()` at climaemet/R/aemet_api_query.R:308:3:
#> ! Failed to perform HTTP request.
#> Caused by error in `curl::curl_fetch_memory()`:
#> ! Failure when receiving data from the peer [opendata.aemet.es]: Recv failure: Connection was reset


ggplot(all_stations) +
Expand All @@ -151,13 +140,9 @@ ggplot(all_stations) +
plot.title = element_text(face = "bold"),
plot.subtitle = element_text(face = "italic")
)
#> Error: objeto 'all_stations' no encontrado
```

<div class="figure">
<img src="./spatial-1.png" alt="Example: Temperature in Spain" width="100%" />
<p class="caption">Example: Temperature in Spain</p>
</div>

## Further enhancements

Other enhancements included on the **v1.0.0**:
Expand Down
101 changes: 20 additions & 81 deletions vignettes/extending-climaemet.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -40,88 +40,32 @@ today <- "/api/prediccion/nacional/hoy"

# Metadata
knitr::kable(get_metadata_aemet(today))
```



|unidad_generadora |descripcion |periodicidad |formato |copyright |notaLegal |
|:-------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------|:-------------------------------------------------------------------------------------------------------|:----------------------------------|
|Grupo Funcional de Predicción de Referencia |Predicción general nacional para hoy / mañana / pasado mañana / medio plazo (tercer y cuarto día) / tendencia (del quinto al noveno día) |Disponibilidad. Para hoy, solo se confecciona si hay cambios significativos. Para mañana y pasado mañana diaria a las 15:00 h.o.p.. Para el medio plazo diaria a las 16:00 h.o.p.. La tendencia, diaria a las 18:30 h.o.p. |ascii/txt |© AEMET. Autorizado el uso de la información y su reproducción citando a AEMET como autora de la misma. |https://www.aemet.es/es/nota_legal |



``` r
#> Error in `httr2::req_perform()` at climaemet/R/aemet_api_query.R:308:3:
#> ! Failed to perform HTTP request.
#> Caused by error in `curl::curl_fetch_memory()`:
#> ! Failure when receiving data from the peer [opendata.aemet.es]: Recv failure: Connection was reset

# Data
pred_today <- get_data_aemet(today)
#>
#> Results are MIME type: text/plain
#> Returning data as string
#> Error in `httr2::req_perform()` at climaemet/R/aemet_api_query.R:308:3:
#> ! Failed to perform HTTP request.
#> Caused by error in `curl::curl_fetch_memory()`:
#> ! Failure when receiving data from the peer [opendata.aemet.es]: Recv failure: Connection was reset
```


``` r
# Produce a result

clean <- gsub("\r", "\n", pred_today, fixed = TRUE)
Error: objeto 'pred_today' no encontrado
clean <- gsub("\n\n\n", "\n", clean, fixed = TRUE)
Error: objeto 'clean' no encontrado

cat(paste("---\n\n", clean, "\n---"))
Error: objeto 'clean' no encontrado
```

---

AGENCIA ESTATAL DE METEOROLOGÍA
PREDICCIÓN GENERAL PARA ESPAÑA
DÍA 26 DE NOVIEMBRE DE 2024 A LAS 07:50 HORA OFICIAL
PREDICCIÓN VÁLIDA PARA EL MARTES 26

A.- FENÓMENOS SIGNIFICATIVOS
Intervalos de viento fuertes en litorales de Galicia. Nieblas
localmente densas en las mesetas e interior peninsular. Descenso
notable de las máximas en amplias zonas de la meseta Norte, alto
Ebro, Cantábrico oriental e interiores del tercio este
peninsular.

B.- PREDICCIÓN
Se prevé que, tras el paso del frente frío del día anterior, se
establezca una situación de altas presiones, que desde Europa
central se extiendan hacia la península Ibérica. No obstante, el
acercamiento de un nuevo frente atlántico dejará abundante
nubosidad de tipo medio y alto en la Península y Baleares, con
cielos nubosos o cubiertos en Galicia y precipitaciones afectando
a su mitad oeste, sin descartarlas en el resto de la Comunidad
así como en el extremo occidental de Asturias. Asimismo existe
una baja probabilidad de alguna precipitación débil y ocasional
en el Pirineo oriental, litorales de Cataluña, norte de Baleares
y sistemas Béticos. También se espera abundante nubosidad baja,
con probables nieblas matinales, en áreas de ambas mesetas,
sierras de Andalucía, Baleares y depresiones del nordeste. En
Canarias, predominarán los cielos nubosos en el norte de las
islas de mayor relieve con posibles chubascos ocasionales, con
probabilidad de ser más intensos en el este de La Palma, y con
intervalos de nubes medias y altas en el resto del archipiélago.

Probabilidad de calima débil en las islas Canarias orientales.

Las temperaturas descenderán de forma prácticamente generalizada
en la Península y Baleares, exceptuando aumentos en Galicia y
Asturias, y con pocos cambios en Canarias. Los descensos de las
máximas serán notables en amplias zonas de la meseta Norte, alto
Ebro, Cantábrico oriental e interiores del tercio este
peninsular. Heladas débiles en montañas, más intensas en
Pirineos.

Soplarán vientos de componente norte en la mitad septentrional
del área mediterránea y predominarán los vientos flojos del sur
y suroeste en el Cantábrico y cuadrante noroeste, más intensos
en Galicia, también con intervalos de fuerte en sus litorales.
Vientos flojos variables con predominio de la componente oeste en
el resto. En Canarias se espera un alisio de flojo a moderado.


---

## Example: Maps

AEMET also provides map data, usually on `image/gif` format. One way to get this
Expand All @@ -134,27 +78,22 @@ a_map <- "/api/mapasygraficos/analisis"

# Metadata
knitr::kable(get_metadata_aemet(a_map))
```



|unidad_generadora |descripción |periodicidad |formato |copyright |notaLegal |
|:---------------------------------|:------------------------------------------|:-----------------------------------------------------------------------------------------|:---------|:-------------------------------------------------------------------------------------------------------|:----------------------------------|
|Grupo Funcional de Jefes de Turno |Mapas de análisis de frentes en superficie |Dos veces al día, a las 02:00 y 14:00 h.o.p. en invierno y a las 03:00 y 15:00 en verano. |image/gif |© AEMET. Autorizado el uso de la información y su reproducción citando a AEMET como autora de la misma. |https://www.aemet.es/es/nota_legal |



``` r
#> Error in `httr2::req_perform()` at climaemet/R/aemet_api_query.R:308:3:
#> ! Failed to perform HTTP request.
#> Caused by error in `curl::curl_fetch_memory()`:
#> ! Failure when receiving data from the peer [opendata.aemet.es]: Recv failure: Connection was reset

the_map <- get_data_aemet(a_map)
#>
#> Results are MIME type: image/gif
#> Returning raw data
#> Error in `httr2::req_perform()` at climaemet/R/aemet_api_query.R:308:3:
#> ! Failed to perform HTTP request.
#> Caused by error in `curl::curl_fetch_memory()`:
#> ! Failure when receiving data from the peer [opendata.aemet.es]: Recv failure: Connection was reset


# Write as gif and include it
giffile <- "example-gif.gif"
writeBin(the_map, giffile)
#> Error: objeto 'the_map' no encontrado

# Display on the vignette
knitr::include_graphics(giffile)
Expand Down
Binary file modified vignettes/spatial-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 4ec7bd8

Please sign in to comment.