CreateRunOptions.R 15.4 KB
Newer Older
1
2
3
4
5
CreateRunOptions <- function(FUN_MOD, InputsModel, IndPeriod_WarmUp = NULL, IndPeriod_Run,
                             IniStates = NULL, IniResLevels = NULL, 
                             Outputs_Cal = NULL, Outputs_Sim = "all",
                             RunSnowModule, MeanAnSolidPrecip = NULL,
                             warnings = TRUE, verbose = TRUE) {
6
7
  
  if (!missing(RunSnowModule)) {
8
    warning("argument 'RunSnowModule' is deprecated; please adapt 'FUN_MOD' instead.", call. = FALSE)
9
  }
10
  
11
  ObjectClass <- NULL
12
  
Delaigue Olivier's avatar
Delaigue Olivier committed
13
  ##check_FUN_MOD
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
  BOOL <- FALSE;
  if (identical(FUN_MOD, RunModel_GR4H)) {
    ObjectClass <- c(ObjectClass, "GR", "hourly")
    BOOL <- TRUE
  }
  if (identical(FUN_MOD, RunModel_GR4J) | identical(FUN_MOD, RunModel_GR5J) | identical(FUN_MOD, RunModel_GR6J)) {
    ObjectClass <- c(ObjectClass, "GR", "daily")
    BOOL <- TRUE
  }
  if (identical(FUN_MOD, RunModel_GR2M)) {
    ObjectClass <- c(ObjectClass, "GR", "monthly")
    BOOL <- TRUE
  }
  if (identical(FUN_MOD, RunModel_GR1A)) {
    ObjectClass <- c(ObjectClass, "GR", "yearly")
    BOOL <- TRUE
  }
  if (identical(FUN_MOD, RunModel_CemaNeige)) {
    ObjectClass <- c(ObjectClass, "CemaNeige", "daily")
    BOOL <- TRUE
  }
  if (identical(FUN_MOD, RunModel_CemaNeigeGR4J) | identical(FUN_MOD, RunModel_CemaNeigeGR5J) | identical(FUN_MOD, RunModel_CemaNeigeGR6J)) {
    ObjectClass <- c(ObjectClass, "GR", "CemaNeige", "daily")
    BOOL <- TRUE
  }
  if (!BOOL) {
40
    stop("incorrect 'FUN_MOD' for use in 'CreateRunOptions'")
41
42
  }
  
Delaigue Olivier's avatar
Delaigue Olivier committed
43
  ##check_InputsModel
44
  if (!inherits(InputsModel, "InputsModel")) {
45
    stop("'InputsModel' must be of class 'InputsModel'")
46
47
  }
  if ("GR" %in% ObjectClass & !inherits(InputsModel, "GR")) {
48
    stop("'InputsModel' must be of class 'GR'")
49
50
51
  }
  if ("CemaNeige" %in% ObjectClass &
      !inherits(InputsModel, "CemaNeige")) {
52
    stop("'InputsModel' must be of class 'CemaNeige'")
53
54
55
  }
  if ("hourly" %in% ObjectClass &
      !inherits(InputsModel, "hourly")) {
56
    stop("'InputsModel' must be of class 'hourly'")
57
58
  }
  if ("daily" %in% ObjectClass & !inherits(InputsModel, "daily")) {
59
    stop("'InputsModel' must be of class 'daily'")
60
61
62
  }
  if ("monthly" %in% ObjectClass &
      !inherits(InputsModel, "monthly")) {
63
    stop("'InputsModel' must be of class 'monthly'")
64
65
66
  }
  if ("yearly" %in% ObjectClass &
      !inherits(InputsModel, "yearly")) {
67
    stop("'InputsModel' must be of class 'yearly'")
68
69
70
  }
  
  
Delaigue Olivier's avatar
Delaigue Olivier committed
71
  ##check_IndPeriod_Run
72
  if (!is.vector(IndPeriod_Run)) {
73
    stop("'IndPeriod_Run' must be a vector of numeric values")
74
75
  }
  if (!is.numeric(IndPeriod_Run)) {
76
    stop("'IndPeriod_Run' must be a vector of numeric values")
77
78
  }
  if (identical(as.integer(IndPeriod_Run), as.integer(seq(from = IndPeriod_Run[1], to = tail(IndPeriod_Run, 1), by = 1))) == FALSE) {
79
    stop("'IndPeriod_Run' must be a continuous sequence of integers")
80
81
  }
  if (storage.mode(IndPeriod_Run) != "integer") {
82
    stop("'IndPeriod_Run' should be of type integer")
83
84
85
  }
  
  
Delaigue Olivier's avatar
Delaigue Olivier committed
86
  ##check_IndPeriod_WarmUp
87
88
  WTxt <- NULL
  if (is.null(IndPeriod_WarmUp)) {
89
    WTxt <- paste0(WTxt,"\t Model warm up period not defined -> default configuration used")
90
91
92
    ##If_the_run_period_starts_at_the_very_beginning_of_the_time_series
    if (IndPeriod_Run[1] == as.integer(1)) {
      IndPeriod_WarmUp <- as.integer(0)
93
      WTxt <- paste0(WTxt,"\t    No data were found for model warm up!")
Delaigue Olivier's avatar
Delaigue Olivier committed
94
      ##We_look_for_the_longest_period_preceeding_the_run_period_with_a_maximum_of_one_year
95
96
97
98
99
100
101
    } else {
      TmpDateR0 <- InputsModel$DatesR[IndPeriod_Run[1]]
      TmpDateR  <- TmpDateR0 - 365 * 24 * 60 * 60
      ### minimal date to start the warmup
      if (format(TmpDateR, format = "%d") != format(TmpDateR0, format = "%d")) {
        ### leap year
        TmpDateR <- TmpDateR - 1 * 24 * 60 * 60
Delaigue Olivier's avatar
Delaigue Olivier committed
102
      }
103
104
105
      IndPeriod_WarmUp <- which(InputsModel$DatesR == max(InputsModel$DatesR[1], TmpDateR)):(IndPeriod_Run[1] - 1)
      if ("hourly"  %in% ObjectClass) {
        TimeStep <- as.integer(60 * 60)
106
      }
107
108
      if ("daily"   %in% ObjectClass) {
        TimeStep <- as.integer(24 * 60 * 60)
109
      }
110
111
      if ("monthly" %in% ObjectClass) {
        TimeStep <- as.integer(30.44 * 24 * 60 * 60)
112
      }
113
114
      if ("yearly"  %in% ObjectClass) {
        TimeStep <- as.integer(365.25 * 24 * 60 * 60)
115
      }
116
117
118
119
120
      if (length(IndPeriod_WarmUp) * TimeStep / (365 * 24 * 60 * 60) >= 1) {
        WTxt <- paste0(WTxt, "\t    The year preceding the run period is used \n")
      } else {
        WTxt <- paste0(WTxt, "\t    Less than a year (without missing values) was found for model warm up: \n")
        WTxt <- paste0(WTxt, "\t    (", length(IndPeriod_WarmUp), " time-steps are used for initialisation) \n")
121
      }
122
123
124
125
    }
  }
  if (!is.null(IndPeriod_WarmUp)) {
    if (!is.vector(IndPeriod_WarmUp)) {
126
      stop("'IndPeriod_WarmUp' must be a vector of numeric values")
127
128
    }
    if (!is.numeric(IndPeriod_WarmUp)) {
129
      stop("'IndPeriod_WarmUp' must be a vector of numeric values")
130
131
    }
    if (storage.mode(IndPeriod_WarmUp) != "integer") {
132
      stop("'IndPeriod_WarmUp' should be of type integer")
133
    }
134
135
    if (identical(IndPeriod_WarmUp, as.integer(0)) & verbose) {
      message(paste0(WTxt, "\t No warm up period is used \n"))
136
137
138
139
140
    }
    if ((IndPeriod_Run[1] - 1) != tail(IndPeriod_WarmUp, 1) & !identical(IndPeriod_WarmUp, as.integer(0))) {
      WTxt <- paste0(WTxt, "\t Model warm up period is not directly before the model run period \n")
    }
  }
141
  if (!is.null(WTxt) & warnings) {
142
143
144
145
146
147
148
149
    warning(WTxt)
  }
  
  
  ## check IniResLevels    
  if ("GR" %in% ObjectClass & ("monthly" %in% ObjectClass | "daily" %in% ObjectClass | "hourly" %in% ObjectClass)) {
    if (!is.null(IniResLevels)) {
      if (!is.vector(IniResLevels) | !is.numeric(IniResLevels) | any(is.na(IniResLevels))) {
150
        stop("'IniResLevels' must be a vector of numeric values")
Delaigue Olivier's avatar
Delaigue Olivier committed
151
      }
152
153
154
155
156
      if ((identical(FUN_MOD, RunModel_GR4H) |
           identical(FUN_MOD, RunModel_GR4J) | identical(FUN_MOD, RunModel_CemaNeigeGR4J) |
           identical(FUN_MOD, RunModel_GR5J) | identical(FUN_MOD, RunModel_CemaNeigeGR5J) |
           identical(FUN_MOD, RunModel_GR2M)) &
          length(IniResLevels) != 2) {
157
        stop("The length of 'IniResLevels' must be 2 for the chosen 'FUN_MOD'")
158
      }
159
160
      if ((identical(FUN_MOD,RunModel_GR6J) | identical(FUN_MOD,RunModel_CemaNeigeGR6J)) &
          length(IniResLevels) != 3) {
161
        stop("The length of 'IniResLevels' must be 3 for the chosen 'FUN_MOD'")
162
      }
163
164
165
166
167
    } else if (is.null(IniStates)) {
      if (identical(FUN_MOD, RunModel_GR6J) | identical(FUN_MOD, RunModel_CemaNeigeGR6J)) {
        IniResLevels <- as.double(c(0.3, 0.5, 0))
      } else {
        IniResLevels <- as.double(c(0.3, 0.5, NA))
168
      }
Delaigue Olivier's avatar
Delaigue Olivier committed
169
    }
170
171
  } else {
    if (!is.null(IniResLevels)) {
172
      stop("'IniResLevels' can only be used with monthly or daily or hourly GR models")
173
174
175
    }
  }
  ## check IniStates
176
  if (is.null(IniStates) & is.null(IniResLevels) & warnings) {
177
    warning("\t Model states initialisation not defined -> default configuration used")
178
  }
179
  if (!is.null(IniStates) & !is.null(IniResLevels) & warnings) {
180
    warning("\t 'IniStates' and 'IniResLevels' are both defined -> Store levels are taken from 'IniResLevels'")
181
182
183
184
185
186
187
188
189
190
191
192
  }
  if ("CemaNeige" %in% ObjectClass) {
    NLayers <- length(InputsModel$LayerPrecip)
  } else {
    NLayers <- 0
  }
  NState <- NULL
  if ("GR" %in% ObjectClass | "CemaNeige" %in% ObjectClass) {
    if ("hourly"  %in% ObjectClass) {
      NState <- 7 + 3 * 24 * 20
    }
    if ("daily"   %in% ObjectClass) {
193
      NState <- 7 + 3 * 20 + 4 * NLayers
194
195
196
197
198
199
200
201
202
203
204
    }
    if ("monthly" %in% ObjectClass) {
      NState <- 2
    }
    if ("yearly"  %in% ObjectClass) {
      NState <- 1
    }
  }
  if (!is.null(IniStates)) {
    
    if (!inherits(IniStates, "IniStates")) {
205
      stop("'IniStates' must be an object of class 'IniStates'\n")
206
207
    }
    if (sum(ObjectClass %in% class(IniStates)) < 2) {
208
      stop(paste0("Non convenient 'IniStates' for this 'FUN_MOD'\n"))
209
210
    }
    if (identical(FUN_MOD, RunModel_GR1A) & !is.null(IniStates)) { ## GR1A
211
      stop(paste0("'IniStates' is not available for this 'FUN_MOD'\n"))
212
213
    }
    if ((identical(FUN_MOD, RunModel_GR5J) | identical(FUN_MOD, RunModel_CemaNeigeGR5J)) & !all(is.na(IniStates$UH$UH1))) { ## GR5J
214
      stop(paste0("Non convenient IniStates for this 'FUN_MOD.' In 'IniStates', UH1 has to be a vector of NA for GR5J"))
215
216
    }
    if ((identical(FUN_MOD, RunModel_GR6J) | identical(FUN_MOD, RunModel_CemaNeigeGR6J)) & is.na(IniStates$Store$Exp)) { ## GR6J
217
      stop(paste0("Non convenient IniStates for this 'FUN_MOD.' GR6J needs an exponential store value in 'IniStates'"))
218
219
    }
    if (!(identical(FUN_MOD, RunModel_GR6J) | identical(FUN_MOD, RunModel_CemaNeigeGR6J)) & !is.na(IniStates$Store$Exp)) { ## except GR6J
220
      stop(paste0("Non convenient IniStates for this 'FUN_MOD.' No exponential store value needed in 'IniStates'"))
221
222
    }
    # if (length(na.omit(unlist(IniStates))) != NState) {
223
    #   stop(paste0("The length of IniStates must be ", NState, " for the chosen FUN_MOD"))
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
    # }
    if (!"CemaNeige" %in% ObjectClass & any(is.na(IniStates$CemaNeigeLayers$G  ))) {
      IniStates$CemaNeigeLayers$G   <- NULL
    }
    if (!"CemaNeige" %in% ObjectClass & any(is.na(IniStates$CemaNeigeLayers$eTG))) {
      IniStates$CemaNeigeLayers$eTG <- NULL
    }
    IniStates$Store$Rest <- rep(NA, 4)
    IniStates <- unlist(IniStates)
    IniStates[is.na(IniStates)] <- 0
    if ("monthly" %in% ObjectClass) {
      IniStates <- IniStates[seq_len(NState)]
    }
  } else {
    IniStates <- as.double(rep(0.0, NState))
  }
  
  
Delaigue Olivier's avatar
Delaigue Olivier committed
242
  ##check_Outputs_Cal_and_Sim
243
244
245
246
  
  ##Outputs_all
  Outputs_all <- NULL
  if (identical(FUN_MOD,RunModel_GR4H)) {
247
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = "GR4H")$GR)
248
249
  }
  if (identical(FUN_MOD,RunModel_GR4J) | identical(FUN_MOD,RunModel_CemaNeigeGR4J)) {
250
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = "GR4J")$GR)
251
252
  }
  if (identical(FUN_MOD,RunModel_GR5J) | identical(FUN_MOD,RunModel_CemaNeigeGR5J)) {
253
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = "GR5J")$GR)
254
255
  }
  if (identical(FUN_MOD,RunModel_GR6J) | identical(FUN_MOD,RunModel_CemaNeigeGR6J)) {
256
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = "GR6J")$GR)
257
258
  }
  if (identical(FUN_MOD,RunModel_GR2M)) {
259
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = "GR2M")$GR)
260
261
  }
  if (identical(FUN_MOD,RunModel_GR1A)) {
262
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = "GR1A")$GR)
263
264
  }
  if ("CemaNeige" %in% ObjectClass) {
265
    Outputs_all <- c(Outputs_all, .FortranOutputs(GR = NULL, isCN = TRUE)$CN)
266
267
268
269
  }
  
  ##check_Outputs_Sim
  if (!is.vector(Outputs_Sim)) {
270
    stop("Outputs_Sim must be a vector of characters")
271
272
  }
  if (!is.character(Outputs_Sim)) {
273
    stop("Outputs_Sim must be a vector of characters")
274
275
  }
  if (sum(is.na(Outputs_Sim)) != 0) {
276
    stop("Outputs_Sim must not contain NA")
277
278
279
280
281
282
  }
  if ("all" %in% Outputs_Sim) {
    Outputs_Sim <- c("DatesR", Outputs_all, "StateEnd")
  }
  Test <- which(Outputs_Sim %in% c("DatesR", Outputs_all, "StateEnd") == FALSE)
  if (length(Test) != 0) {
283
    stop(paste0( "'Outputs_Sim' is incorrectly defined: ",
284
                 paste(Outputs_Sim[Test], collapse = ", "), " not found"))
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
  }
  Outputs_Sim <- Outputs_Sim[!duplicated(Outputs_Sim)]
  
  
  ##check_Outputs_Cal
  if (is.null(Outputs_Cal)) {
    if ("GR" %in% ObjectClass) {
      Outputs_Cal <- c("Qsim")
    }
    if ("CemaNeige" %in% ObjectClass) {
      Outputs_Cal <- c("all")
    }
    if ("GR" %in% ObjectClass &
        "CemaNeige" %in% ObjectClass) {
      Outputs_Cal <- c("PliqAndMelt", "Qsim")
    }
  } else {
    if (!is.vector(Outputs_Cal)) {
303
      stop("'Outputs_Cal' must be a vector of characters")
304
305
    }
    if (!is.character(Outputs_Cal)) {
306
      stop("'Outputs_Cal' must be a vector of characters")
307
308
    }
    if (sum(is.na(Outputs_Cal)) != 0) {
309
      stop("'Outputs_Cal' must not contain NA")
310
311
312
313
314
315
    }
  }
  if ("all" %in% Outputs_Cal) {
    Outputs_Cal <- c("DatesR", Outputs_all, "StateEnd")
    
  }
316
  Test <- which(Outputs_Cal %in% c("DatesR", Outputs_all, "StateEnd") == FALSE)
317
  if (length(Test) != 0) {
318
    stop(paste0("'Outputs_Cal' is incorrectly defined: ",
319
                paste(Outputs_Cal[Test], collapse = ", "), " not found"))
320
  }
321
  Outputs_Cal <- unique(Outputs_Cal)
322
323
324
325
326
327
328
329
330
331
332
  
  
  ##check_MeanAnSolidPrecip
  if ("CemaNeige" %in% ObjectClass & is.null(MeanAnSolidPrecip)) {
    NLayers <- length(InputsModel$LayerPrecip)
    SolidPrecip <- NULL
    for (iLayer in 1:NLayers) {
      if (iLayer == 1) {
        SolidPrecip <-
          InputsModel$LayerFracSolidPrecip[[1]] * InputsModel$LayerPrecip[[iLayer]] /
          NLayers
Delaigue Olivier's avatar
Delaigue Olivier committed
333
      } else {
334
        SolidPrecip <- SolidPrecip + InputsModel$LayerFracSolidPrecip[[iLayer]] * InputsModel$LayerPrecip[[iLayer]] / NLayers
Delaigue Olivier's avatar
Delaigue Olivier committed
335
336
      }
    }
337
338
339
340
341
342
343
344
345
346
347
348
349
350
    Factor <- NULL
    if (inherits(InputsModel, "hourly")) {
      Factor <- 365.25 * 24
    }
    if (inherits(InputsModel, "daily")) {
      Factor <- 365.25
    }
    if (inherits(InputsModel, "monthly")) {
      Factor <- 12
    }
    if (inherits(InputsModel, "yearly")) {
      Factor <- 1
    }
    if (is.null(Factor)) {
351
      stop("'InputsModel' must be of class 'hourly', 'daily', 'monthly' or 'yearly'")
352
353
354
    }
    MeanAnSolidPrecip <- rep(mean(SolidPrecip) * Factor, NLayers)
    ### default value: same Gseuil for all layers
355
    if (warnings) {
356
357
358
      warning("\t 'MeanAnSolidPrecip' not defined -> it was automatically set to c(",
              paste(round(MeanAnSolidPrecip), collapse = ","), ")  from the 'InputsModel' given to the function. ",
              "Be careful in case your application is (short-term) forecasting.\n")
359
360
361
362
    }
  }
  if ("CemaNeige" %in% ObjectClass & !is.null(MeanAnSolidPrecip)) {
    if (!is.vector(MeanAnSolidPrecip)) {
363
      stop(paste0("'MeanAnSolidPrecip' must be a vector of numeric values"))
364
365
    }
    if (!is.numeric(MeanAnSolidPrecip)) {
366
      stop(paste0("'MeanAnSolidPrecip' must be a vector of numeric values"))
367
368
    }
    if (length(MeanAnSolidPrecip) != NLayers) {
369
      stop(paste0("'MeanAnSolidPrecip' must be a numeric vector of length ", NLayers, ""))
370
371
372
373
    }
  }
  
  
Delaigue Olivier's avatar
Delaigue Olivier committed
374
  ##check_PliqAndMelt
375
376
377
  if ("GR" %in% ObjectClass & "CemaNeige" %in% ObjectClass) {
    if ("PliqAndMelt" %in% Outputs_Cal == FALSE & "all" %in% Outputs_Cal == FALSE) {
      WTxt <- NULL
378
      WTxt <- paste0(WTxt, "\t 'PliqAndMelt' was not defined in 'Outputs_Cal' but is needed to feed the hydrological model with the snow modele outputs \n")
379
      WTxt <- paste0(WTxt, "\t -> it was automatically added \n")
380
      if (!is.null(WTxt) & warnings) {
381
382
383
        warning(WTxt)
      }
      Outputs_Cal <- c(Outputs_Cal, "PliqAndMelt")
Delaigue Olivier's avatar
Delaigue Olivier committed
384
    }
385
386
    if ("PliqAndMelt" %in% Outputs_Sim == FALSE & "all" %in% Outputs_Sim == FALSE) {
      WTxt <- NULL
387
      WTxt <- paste0(WTxt, "\t 'PliqAndMelt' was not defined in 'Outputs_Sim' but is needed to feed the hydrological model with the snow modele outputs \n")
388
      WTxt <- paste0(WTxt, "\t -> it was automatically added \n")
389
      if (!is.null(WTxt) & warnings) {
390
391
392
393
394
395
396
        warning(WTxt)
      }
      Outputs_Sim <- c(Outputs_Sim, "PliqAndMelt")
    }
  }
  
  
Delaigue Olivier's avatar
Delaigue Olivier committed
397
  ##Create_RunOptions
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
  RunOptions <- list(IndPeriod_WarmUp = IndPeriod_WarmUp,
                     IndPeriod_Run = IndPeriod_Run,
                     IniStates = IniStates,
                     IniResLevels = IniResLevels,
                     Outputs_Cal = Outputs_Cal,
                     Outputs_Sim = Outputs_Sim)
  
  if ("CemaNeige" %in% ObjectClass) {
    RunOptions <-
      c(RunOptions, list(MeanAnSolidPrecip = MeanAnSolidPrecip))
  }
  class(RunOptions) <- c("RunOptions", ObjectClass)
  
  return(RunOptions)
  
  
Delaigue Olivier's avatar
Delaigue Olivier committed
414
415
}