Source (user) Data

This unit appears in the source section of the 1D Water Quality datafile. The unit enables the user to store SOURCE data in files separate from the 1D Water Quality datafile.

Description

The data required by the SOURCE module can be quite extensive, especially if an annual simulation using TIME-HISTORY data is required. Such large amounts of data could make the 1D Water Quality datafile very large and unwieldy for the file editor to handle. For this reason the 1D Water Quality Solver offers the ability to store SOURCE data for a particular node in a separate file. The user is able to store statistical sources, time-history sources and internal boundary conditions. The user retains all the functionality described in the SOURCE section without creating a large 1D Water Quality datafile.
The format of the datafile is set out below, enabling the user to generate the datafile from raw data for the source.

Datafile Format

Line 1                       SOURCE
Line 2                       USER
Line 3                       label
Line 4                       USER
Line 5                       filename

The separate SOURCE file contains the same information described in the section SOURCE.

The format of the file is described below:

(1) When using the separate datafile to specify data statistically, use:

Line 1                       variable name 'Discharge'
Line 2                       STATISTICAL'
Line 3                       'OUTFALL' or 'INTAKE'
Line 4a-b                   flwann (l)
Line 5                       flwday (l)
Lines 6a-c                 flwhur (l)
Lines 7a-c                  varhur(I) (3 lines)
Line 8                       annflw

If line 3 is the keyword 'INTAKE', no concentration data is needed so the following line is used:

Line 9    END

Else if line 3 is the keyword 'OUTFALL', the following lines are used:
Line 9                       Variable name
Line 10                       STATISTICAL'
Line 11                       ADDED'
Line 12                       ’r;SEASONAL' or 'HOURLY'

If line 12 is the keyword 'SEASONAL' then the following lines are read:

Lines 13a-b                       pconst(I) (2 lines)
Line 14                       END or new variable name

Else if line 12 is the keyword 'HOURLY' then the following lines are read:

Lines 13a-c                       pconst(I) (3 lines)
Line 14                       END or new variable name

(2) When using the separate datafile to set the data as a time-history use:

Line 1                       variable name 'Discharge'
Line 2                       TIME-HISTORY
Line 3                       'DATE', 'SECONDS', 'MINUTES', 'HOURS', 'DAYS', 'WEEKS', 'LUNAR', 'MONTHS', 'YEARS', 'DECADES', or 'MULTIPLIER'

If the keyword 'MULTIPLIER' is used, then the following line is read

Line 3a                       fmult
Line 4                       'INTAKE' or 'OUTFALL'
Line 5                       ndat

If the keyword 'DATE' has been used the following line is read 'ndat' times:

Line 6a-end    ihour, imin, iday, imonth, iyear, flow

Else if the times are specified differently the following line is read 'ndat' times:

Line 6a-end                       flow, time

If line 4 is the keyword 'INTAKE', no concentration data is needed so the following line is used:

Line 7                       END

Else if line 4 is the keyword 'OUTFALL', the following lines are used:

Line 7                       Variable name
Line 8                       HISTORY
Line 9                       'DATE', 'SECONDS', 'MINUTES', 'HOURS', 'LUNAR', 'MONTHS', 'YEARS', 'DECADES' or 'MULTIPLIER'

If the keyword 'MULTIPLIER' is used, the following line is read:

Line 9a                       fmult
Line 10                       ADDED
Line 11                       ndat

If the keyword 'DATE' has been used the following line is read 'ndat' times:

Line 12a - end    ihour, imin, iday, imonth, iyear, conc
Line 13    END or new variable name (line 9)

Else if the times are specified differently the following line is read 'ndat' times:

Line 12a - end                       conc, time
Line 13                       END or new variable name (line 9)

(3) When using the SOURCE module to set an internal boundary condition use:

Line 1                       Variable name
Line 2                       TIME-HISTORY
Line 3                       'DATE', 'SECONDS', 'MINUTES', 'HOURS', 'LUNAR', 'MONTHS', 'YEARS', 'DECADES' or 'MULTIPLIER'

If the keyword 'MULTIPLIER' is used, the following line is read:
Line 3a                       fmult
Line 4                       IMPOSED
Line 5                       ndat

If the keyword 'DATE' has been used the following line is read 'ndat' times:
Line 6a-end                       ihour, imin, iday, imonth, iyear, conc
Line 7    END or new variable name

Else if the times are specified differently the following line is read 'ndat' times:
Line 6a-end                       conc, time
Line 7                       END or new variable name

Where

Field Name

Description

SOURCE

Keyword

USER

Keyword

STATISTICAL

Keyword

ADDED

Keyword

SEASONAL

Keyword

HOURLY

Keyword

TIME-HISTORY

Keyword

OUTFALL

Keyword

INTAKE

Keyword

END

Keyword

Label

Label of source node

Filename

Name of separate SOURCE file

flwann

Mean monthly flows for January, February etc

flwday

Mean daily flows for Monday, Tuesday etc

flwhur

Mean hourly flows for 1:00am, 2:00am etc

varhur

Standard deviation from mean for 1.00am, 2.00am etc

annflw

Mean annual flow

Variable name

Variable name for subsequent concentration data

pconst

Concentration of pollutant for January, February etc  OR

Concentration of pollutant for 1.00am, 2.00am etc (HOURLY)

fmult

Multiplier to convert times to hours

ndat

Number of data points in discharge hydrograph

ihour, imin, iday, imonth, iyear, flow

Time and date, discharge (m3/s)

flow, time

Discharge at source node (m3/s), time (secs, mins, hrs etc)

General

Only one SOURCE may be specified at any one model node. If water quality variables which are not being simulated are specified in SOURCE, then the 1D Water Quality Solver will ignore this redundant information.

Overview

Datafile Layout

Related Topics

Source Data