
                           CivilTools
                          ============

               Civil Engineering Design Software
                       v. 1.1, Shareware


CivilTools is Copyright (c) 1997-98 by Renaissance Endeavours
and Allan Herle.  It is not public domain or free software.  


WHAT IS CivilTools?
===================

CivilTools is a suite of spreadsheet-like tools intended to
assist a qualified Civil Engineering designer in performing
calculations related to the flow of water in pipes, culverts,
ditches, and channels. The specific situations addressed are:

A.   Analysis of capacity, flow velocity, and depth of flow in
     a round pipe flowing full or partially full (by gravity).

B.   Analysis of capacity, flow velocity, and depth of flow in
     a box section pipe flowing full or partially full (by
     gravity).

C.   Design of a round or box section culvert, including 
     analysis of inlet control, outlet control, and tailwater
     conditions

D.   Analysis of flow in a channel such as a ditch or canal,
     including a determination of whether the flow will be
     subcritical or supercritical, and an estimate of the size
     of sediment (bed load) that will be transported.

E.   Design of a storm sewer system using the Rational Method.

In many cases, special algorithms are used to solve complex
non-linear hydraulic equations, when a direct solution is not
possible.  The software is arranged in a manner that will be
familiar to spreadsheet users.  Program modules, which each 
perform an individual task, are arranged like sheets or pages
in a spreadsheet program.  Full context-sensitive help is also
provided.


USE BY A QUALIFIED DESIGNER ONLY
================================

Please note that this software is intended to ASSIST a
qualified designer, not replace one.  This software should
only be used by a qualified designer familiar with hydraulic
principles and with thorough knowledge of the system being
designed or modelled.
In all cases, the responsibility for a design rests with the
designer.


                           CivilTools
                          ============
           V. 1.1, September 1998 (Shareware Version)



                        Table of Contents
                       ===================


                                         
Disclaimer ................................................ 1
License Agreement ......................................... 2
Why Register? ............................................. 3

What's New For Version 1.1 ................................ 4
tall/Uninstall ............................................ 5
Instructions for Use ...................................... 6

PIPE ...................................................... 7
BOX PIPE .................................................. 8
CULVERT ................................................... 9
BOX CULVERT .............................................. 10
CHANNEL .................................................. 11
RATIONAL METHOD .......................................... 12

How to Contact Us ........................................ 13

Registration Form .............................. REGISTER.TXT


PLEASE NOTE THAT USE OF THIS SOFTWARE CONSTITUTES ACCEPTANCE
OF THE FOLLOWING DISCLAIMER AND LICENSE AGREEMENT


1.  DISCLAIMER
    ===========

CivilTools (HEREINAFTER REFERRED TO AS 'THE SOFTWARE', IS 
SUPPLIED 'AS IS'.  RENAISSANCE ENDEAVOURS AND ALLAN HERLE MAKE
NO WARRANTIES, EXPRESSED OR IMPLIED, REGARDING THIS PRODUCT,
ITS MERCHANTABILITY, OR ITS FITNESS FOR ANY PURPOSE.  
RENAISSANCE ENDEAVOURS AND ALLAN HERLE ASSUME NO LIABILITY FOR
ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DIRECT,
INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF PROFIT, SPECIAL,
PUNITIVE, OR OTHER DAMAGES) FOR ANY REASON WHICH MAY RESULT
FROM THE USE OF OR INABILITY TO USE THE SOFTWARE.  ALL RISKS
ARE ASSUMED BY THE USER OF THE SOFTWARE.

THE SOFTWARE CONTAINS SAMPLE DATA INTENDED TO ILLUSTRATE THE
USE OF THE SOFTWARE.  THESE SAMPLE DATA DO NOT CONSTITUTE A
RECOMMENDED OR SUGGESTED DESIGN OR DESIGN STANDARD AND MUST
NOT BE INTERPRETED AS SUCH.


2.  LICENSE AGREEMENT
    ==================

Please read the following terms and conditions carefully.  
Your use of the software constitutes acceptance of them and
your agreement to be bound by them.

CivilTools is copyrighted software and all rights are reserved.
It may be freely distributed as long as it is unaltered and
complete with all of the following files:

README.TXT   (This document)
REGISTER.TXT (Registration form)
CIVIL.INI
CIVIL.HLP
CIVILMSG.HLP
CIVIL.EXE
CIVIL.TBD
CIVIL.BWB
CIVIL.BDG
VBRT0xx.DLL (45 files with xx being 00 through 44)
METRIC.BDT (Sample data)
FEET.BDT  (Sample data)

These are the files that are present after installation.
The software may be distributed in a compressed format and may
contain other files to facilitate distribution or installation.

Renaissance Endeavours and Allan Herle hereby grant you, the
end user, a non-exclusive license to evaluate this software
for a period of up to 30 days.  You may also distribute the
software as long as it is unmodified and in its entirety.  
After the evaluation period you must either register the 
software or cease to use it.
Registering the software allows you to use it on a single
personal computer system; however, you may make copies for
backups and archives.  Use of the software on more than one
computer requires that a registration fee be paid for the
software on each computer.  Please see the file Register.txt
for information on how to register the software.

3.  WHY REGISTER?
    =============

It is legally and ethically required to register the software
to use it beyond the 30 day trial period.  Besides that, there
are several practical reasons why you should do so:

A.   Receive the complete version.  The unregistered 
     (shareware) version of the software does not allow the
     user to save or print data files and results.  
     The registered version does not have this limitation.

B.   Free Updates.  It is intended that this product will be
     updated at regular intervals.  Registered users will 
     receive updates for free by email (or by first-class 
     mail for a nominal shipping and handling charge, if you 
     prefer) for a period of two years from the registration
     date.  As more features and modules are added, the price
     will likely go up, but as a registered user you will 
     continue to get the updated versions for free!

C.   Free Technical Support.  We will provide unlimited 
     (within reason) free technical support for our products
     via email or regular mail.  Unfortunately, at this time 
     we cannot offer telephone support, but email and regular
     mail will be dealt with promptly.

D.   A chance to shape the software!  Tell us what changes or
     additions you would like to see to better serve your 
     needs, and we will do our best to see that your 
     suggestions appear in future versions.


4.  What's New For Version 1.1?
    ===========================

The following features have been added or improved for 
Version 1.1:

A. A Box Culvert design module has been added to allow you to
   design or evaluate box section drainage culverts as well as
   round ones.

B. A 'Comments' column has been added to the Rational Method
   module.

C.Ability to optionally print or hide the 'Comments' column
   and design data in the Rational Method module has been 
   added.

D. Printing has been improved in several modules.

E. The current data file name is now shown in the title bar.

F. Data files from previous versions are automatically updated
   to version 1.1 format when they are opened.


5.  INSTALL/UNINSTALL
    =================

To install, simply run the included installation utility. If
you use Windows 3.1 or 3.11, run the Setup31.EXE program.  If
you are using Windows 95, run Setup95.EXE.  The default
installation directory is C:\CVLTOOLS, but you can change this
to whatever you like when prompted to do so.  Simply follow
the instructions on screen.  

To uninstall the software, run Setup31.exe or Setup95.exe
again, and select the Remove option.  Or, just delete all the
files in the directory you installed the software to.  The 
software does not alter Registry settings or pre-existing
*.ini files, or place new files anywhere but in the 
installation directory.

As mentioned above, the key data entry cells contain text
coloured dark blue, for easy identification.  If your default
Windows text colour is also dark blue, it may be difficult to
identify which are the data entry cells.  If this is the case,
we recommend that you change your default Windows text colour
to a different one.


6.  INSTRUCTIONS FOR USE
    ====================

CivilTools is a suite of spreadsheet-like tools designed to
assist a Civil Engineering designer in many of his/her daily
design calculations.  Each of the program modules, or pages,
is selected by clicking on its page tab at the bottom of the
screen.  Data is entered in the data input cells, which are
easily identified by their blue colour.  Other cells,
displayed in black, red, or your default text colour, cannot
be altered.  Calculated results are displayed immediately.  
Context-sensitive help is available at all locations by
pressing the F1 key.

We reiterate that this software should only be used by persons
who are familiar with the hydraulic and engineering principles
involved and who have a thorough knowledge of the system being
designed or modelled.

7.  PIPE

This page calculates the depth of flow and flow velocity in a
round pipe given the pipe size, flow rate, slope, and 
roughness.  It is useful in situations where you need to know
the actual flow depth or travel time of water in a partially-
full round pipe.  The software will also report the minimum
slope on the pipe that would be required to convey the design
flow with the pipe flowing full and with the slope of the 
hydraulic grade line equal to the slope of the pipe.

This program module (page) is valid where flow is steady and
is not accelerating.  It is not intended to estimate the depth
of flow at the point where water enters a pipe from a ditch or
pond - use the CULVERT page for that.


8.  BOX PIPE

This page performs the same types of calculations as the PIPE
page described above, but for box-section pipes.

This page has several sections, and you choose the one you
want to use depending on the parameter that you want to solve
for.

First, decide whether you want to calculate using a box
section pipe flowing full or part full.  To calculate based on
a box section pipe flowing full, use the modules in Part One. 
To calculate for a box section pipe flowing part full, or for
an open-topped rectangular channel, use the modules in Part 
Two.

For example, if you know pipe dimensions and the design flow
rate, and you want to know the minimum slope that the pipe has
to be laid at to achieve the design flow rate, you would use
section 1B.  The sections are independent of one another.  
Changes you make in one section do not affect the data or 
results in other sections.


9.  CULVERT

This page estimates the depth of ponding that will occur at
the inlet of a drainage culvert.  The user enters the design
flow through the culvert and the culvert parameters - size, 
material, entrance type, length, slope, and roughness.  
Culvert material and entrance type is selected by double
clicking on the indicated cell, which will cause a menu of
available entrance types to appear.

This page is used for round culverts only.  For box section
culverts, use the Box Culvert page.  

The program checks whether the culvert will flow under inlet
control or outlet control for these conditions, and estimates
the depth of ponding that will occur at the inlet.  By 
checking the predicted depth of ponding versus the allowable
depth for that particular installation, the designer can
decide whether or not the culvert selected is appropriate.

The use of a spreadsheet-like interface makes it easy to
compare the performance of different culvert and entrance
configurations to find the most effective and economical 
culvert for a given application.


10.  BOX CULVERT

This page functions very much like the Culvert page, except
that it is used to analyse culverts with a rectangular cross
section.


11.  CHANNEL

This page uses Manning's Equation to analyse the flow of water
in a trapezoidal channel such as a drainage ditch, irrigation
canal, or other watercourse.

The channel is described in terms of the bed width (W), the
side slopes (SS), the bed slope, and the roughness (Manning's
'n').  Flow in the channel is described in terms of the volume
flowrate and the depth of flow.  Three sections are given in
the program page.  The one you choose to use will depend on
which parameter you want to solve for.  All of the sections
will also report the flow velocity, the critical depth, the
flow type (subcritical or supercritical), and give an estimate
of the size of rock or gravel that will be transported along
the bed.  Sections are independent of one another - changes in
one section will not affect data or results in other sections.

The side slope is entered as a single number corresponding to
the horizontal distance that produces a unit change in 
vertical height.  For instance, if the side slope is 2.5 feet
horizontally for each 1 foot vertically (2.5H:1V) you would
enter 2.5 in the SS cell.  The other inputs are self 
explanatory.

This page is intended to be used for 'typical' situations
where sizes and slopes are reasonable.  It is not intended to
be used where flows are very small or very large, or slopes 
exceed about 5%.  If in doubt about whether or not the 
software is applicable, the designer must rely upon his/her
own judgement.


12. RATIONAL METHOD

This page performs the calculations necessary for the Rational
Method of storm sewer design.  This page is intended to be 
used only by persons who fully understand the principles and
use of the Rational Method.

Many approving authorities require designers to submit 
Rational Method calculations for approval along with their
designs.  This page is designed to assist with those 
calculations and provide a convenient means of presenting the
results.

The Rational Method is well known and the basic required input
data - runoff coefficient, rainfall intensity, tributary area,
time of concentration, and pipe size, length, slope, and
roughness - is understood by any designer who knows the
method.  This program, however, contains a few innovations
which bear explanation:

A.   Calculation of rainfall intensity.  The program includes
     a dialog box to assist you in calculating the correct
     rainfall intensity for a given time of concentration.  To
     use it, first select Input_IDF_Curve from the Tools menu.
     Then, choose two data points from the rainfall Intensity-
     Duration-Frequency (IDF) curve for the area you are
     modelling.  The two data points should bracket the range
     of times of concentration you will be using in your
     model.  For instance, if your minimum time of
     concentration is 10 minutes, and you expect that the time
     of concentration at the downstream end of your storm
     sewer system will be about 20 minutes, use 10 minutes and
     20 minutes as your data points.  Enter the two data
     points you have chosen, and their associated rainfall
     intensities from the curve, in the appropriate areas.  A
     curve fitting formula converts the data points to
     parameters that are then used to calculate a rainfall
     intensity for any given time of concentration.

B.   Minimum Slope calculations.  In some instances, the storm
     sewer design is governed by a certain minimum flow
     velocity required in the pipe.  This minimum flow
     velocity can be added in the Minimum Velocity column,
     which will then report a minimum pipe slope that is
     required to achieve that velocity (for the pipe size and
     roughness stated, flowing full or half full).  The
     designer can then use this information to select an
     appropriate slope for the pipe.

     The minimum slope required for the specified pipe size to
     convey the calculated flow is also reported.


13. How to Contact Us
    =================

Inquiries, comments, and suggestions can be sent to:

Renaissance Endeavours
Box 419, 7101C - 120th Street
Delta, BC
Canada V4E 2A9

or via Internet email to:

CivilTools@Canada.com
http://welcome.to/civiltools

We look forward to hearing from you, and thank you for 
taking the time to evaluate CivilTools!

