Skip to content

Commit 6bca4dd

Browse files
committed
*** v0.8.1 *** Feature release with daily netCDF input and output, and more convenience and flexibility for getField().
1 parent 25d528f commit 6bca4dd

File tree

3 files changed

+30
-2
lines changed

3 files changed

+30
-2
lines changed

DESCRIPTION

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Package: DGVMTools
22
Type: Package
3-
Version: 0.8.0
3+
Version: 0.8.1
44
Title: DGVM Processing, Analysis and Plotting Tools
55
Date: 2019-02-27
66
Authors@R: c(person("Matthew", "Forrest", role=c("aut", "cre"), email="[email protected]"),

NEWS.md

+28
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,31 @@
1+
# DGVMTools v0.8.1 (2019-04-30)
2+
3+
A few new features in this release.
4+
5+
## Feature improvements:
6+
7+
* When a call to getField() is made to read data, if an appropriate Quantity object is not found then it will be automatically created. This is particularly useful for LPJ-GUESS users who want to open their own custom non-standard 'xxxxx.out' files. It is no longer necessary to define metadata for such a file before reading it. The only drawback is that it won't have the units defined or a nicely descriptive name.
8+
* Writing daily data to netCDF with function writeNetCDF now implemented (time axis is always "days since ..."). A "365_day" calendar is assumed.
9+
* Reading daily data from netCDF using DGVMData now implemented (time axis is always "days since ..."). In principle all common calendars are supported, but aggregateSubannual() assumes a 365 day year, so only "365_day" is fully supported by the package and is therefore preferred.
10+
* The function getField() now takes a 'file.name' argument for files which do not have their standard name, or for Formats which don't have a guaranteed unique or easily comstructable file name.
11+
* Function copyLayers() will fill data across dimensions in the 'to' argument which don't exist in the 'from' argument, provide that new argument 'fill.dims' is set to TRUE.
12+
13+
## Potential breaks:
14+
15+
* The new 'file.name' argument to getField() may cause problems with the argument ordering in pre-existing scripts.
16+
* Some DGVMData files may no longer be readable due to changes in reading the time axis.
17+
* Arguments to writeNetCDF() changed. Function now only takes 'time.intervals' and 'start.date', the 'monthly' and 'annual' arguments have been removed as it is now redundant since the time axis is defined purely in terms of 'time.intervals' since 'start.date'.
18+
19+
## Bug fixes:
20+
21+
* crop() methods now called setKeyDGVM().
22+
23+
## Behind the scenes:
24+
25+
* getField_DGVMData() substantially re-worked and is now much more robust.
26+
* writeNetCDF() and FieldToArray re-worked somewhat to define time dimension labels in terms of days only.
27+
28+
129
# DGVMTools v0.8.0 (2019-03-18)
230

331
This release has a couple of new features, few minor bug fixes and some tidying and cleaning. See also new repository for example scripts at https://github.com/MagicForrest/DGVMTools_Scripts

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ devtools::install_github("MagicForrest/DGVMTools", ref = "master", dependencies
4343

4444
### News and Releases
4545

46-
Current release is v0.8.0. See [NEWS.md](NEWS.md).
46+
Current release is v0.8.1. See [NEWS.md](NEWS.md).
4747

4848
---
4949

0 commit comments

Comments
 (0)