HLCP Help file specifications

Thursday, September 6, 2007

HLCP requires that a suitable graphical help file be provided.

The Help file is a combination of still screenshots with text boxes, and short animated screen captures, for each "How To" for HLCP, basically to focus on how to get things done, rather than explain everything. Information needs to be presented in a logical manner so that the work flow is clear.



Since it is presumed that the user is familiar with HVAC Load calculations, there is no link to any "Reference" as such, but brief introductionary details shall be provide in text boxes on static screens to explain certain features such as "Project Masters", Schedule Masters", etc. which may be new to the HVAC engineer experienced only in manual Heat Loads .

To meet this end, an sectionalised HTML Help file, each section being a mix of static screenshots with dialogue boxes giving explanations, and short animated swf flash screen captures, which show an animated mouse cursor actually performing a certain task

The final file shall be a set of swf files, linked to HTML files, which can be accessed through the menubar of HLCP or even ported to a website.

"Wink" shall be used to create the animations, and "Shalom Help Maker v 0.6.1" shall be used for the compiled help file.

Download links here:


Wink

http://www.debugmode.com/wink/download.php


Shalom Help Maker

http://www.danish-shareware.dk/soft/shelpm/

You will need the compiler files for turning your project (the shp file and images) into a help file.


Help Compiler

http://www.danish-shareware.dk/soft/shelpmbeta/helpcompiler.zip


A preliminary broad index for the various Sections of the Help file is given below. (Note that within these sections, there would be sub-sections, i.e., that for each section, we may need subdivided sections to cover all aspects.

The proposed sections (index) of the HLCP Help.

Index for HCLP Help file.

Introduction to HLCP
What is HLCP?


Starting HLCP
Accessing the Getting Started pdf file
Accessing the FAQ pdf file


Defining a Building

The HLCP Environment
The Menubar
The tab bar
Getting Help

The user files
eplusout.csv
PostProcess.csv

projectname_input.csv
projectname_postprocess.csv
projectname.pdf

What is a Project
Starting a new Project
Opening an existing Project
Filling in Project Details
Saving a Project
Deleting a Project
Deleting a Project Master
Deleting a Schedule Master

Projects Tab

Selecting the units
Location / Weather Tab
Selecting the location
Selecting the Weather Data source
Selecting the City
Selecting the Range

Project Master tab

Project Masters Tab
What is a Project Master
Creating a new Project Master
Loading an existing Project Master
Saving a Project Master

Select the Project Master tab
Selecting a U value for the Project Master
Adding / deleting a value in the Project Master
Changing default safeties

U value calculator

Opaque U value calculator
What is the opaque U value calculator
Film coefficients
Maximum number of layers
Order of layers
Units

How to create a new opaque Construction...
How to select and transfer an opaque Construction...
How to delete an opaque Construction
How to add a U value directly
Exiting the U value Calculator

How to create a new window Construction...
How to select and transfer a window Construction...
How to delete a window Construction
How to add a U value directly*
Exiting the U value Calculator


Shedule Master tab

What is a Schedule Master
Creating a new Schedule Master
Loading an existing schedule Master
Saving a Schedule Master

System Details tab

What are System Details
Adding a new System
Deleting a System
Duplicating a system
Inside Design Conditions
Bypass factor
System multiplier

Zone Details tab

Defining a new Zone
Entering basic Zone details
Drawing a Zone
Saving a Zone

Entering Wall/ Partition details
Entering Window details
Entering shade (external to window) details
Entering Blinds / Drapes details
Entering Door details
Entering Floor details
Entering Flat Roof/Ceiling details
Entering Skylight details
Entering Gable Roof details

Internal Loads tab

Entering Occupancy details
Entering Infiltration details
Entering Heat Recovery details
Entering Ventilation Air details
Entering Equipment details
Entering lighting details

Input Summary tab

Reports tab

What are seasonal loads
What are monthly loads
What are hourly loads

Selecting the output type required.
Adding a monthly time period
Adding a hourly time period

The Run tab

Save and Simulate
Save and Simulate Later

The Outputs Tab

The Seasonal load output
Accessing the output csv files

The Error window

Posted by Kaks at 1:09 PM  

0 comments:

Post a Comment