====== ForcKey.txt/ForcKey_nnn.txt ======

In the basic case, forcing data time series are given for each subbasin. It is possible to use one time series of forcing to represent the conditions for several subbasins. In this case the forcing data time series are given an identification (obsid) separate from the subid. The ForcKey-file gives the coupling between subbasins and forcing data. It can also hold information about elevation for temperature observations ([[start:hype_file_reference:tobs.txt|Tobs.txt]]) that will be used for temperature corrections with parameter ''tcobselev''. 

The file is optional and located in the [[start:hype_file_reference:info.txt&#general|forcingdir]] folder given in  [[start:hype_file_reference:info.txt|info.txt]]. You can use code ''readobsid'' in info.txt to use this file, but default is to use the file so it is not necessary to set the flag. Turning off ''readobsid'' will force HYPE not to read and use an existing ForcKey.txt file. 

The file has column headings on first row, and data from second and onward. The number of data rows is assumed to be the same as in [[start:hype_file_reference:geodata.txt|GeoData.txt]]. Missing values are not allow (program won’t check!). Columns with unknown column headings are skipped while reading the file and can be used for comments. Such columns must not contain more than 100 characters.

/**
 * ____________IMPORTANT!__________IMPORTANT!________________IMPORTANT!_______________________IMPORTANT!______________
 *
 * The table below is maintained in spreadsheed file 'file_reference_tables.xlsx'
 * in the wiki back-up folder on our server.
 * Please edit table contents there and then copy-paste the updated full table to this page. Ask René if something is 
 * unclear. Thanks.
 * ___________________________________________________________________________________________________________________
 */


<sortable>
^ Column ^ Format ^ Description ^
|''subid''|//integer//|id number for subbasins (mandatory)|
|''pobsid''|//integer//|id number for precipitation data (<100000000)|
|''tobsid''|//integer//|id number for air temperature data (<100000000)|
|''tobselev''|//real//|elevation of temperature observation in meter|
|''sfobsid''|//integer//|id number for snowfall data (<100000000)|
|''swobsid''|//integer//|id number for shortwave radiation data (<100000000)|
|''uobsid''|//integer//|id number for wind speed data (<100000000)|
|''rhobsid''|//integer//|id number for relative humidity data (<100000000)|
|''tminobsid''|//integer//|id number for minimum air temperature data (<100000000)|
|''tmaxobsid''|//integer//|id number for maximum air temperature data (<100000000)|
</sortable>

ForcKey_nnn.txt holds information on forcing data - subbasin coupling for data of sequence with seqnr nnn. For seqnr 0 is ForcKey.txt used.