### Analyses manager window |  |

Through this window you can :

- create, modify and delete analysis elements.
- create, manage and execute analyses.

It is divided in two parts : the analyses components lists, and the defined analyses list.

##### Analyses components

The top part of the window contains three selection lists :

- The types of analysis available. A description is given for each analysis in the introduction chapter.
- The scenes currently loaded.
- The analysis elements already defined or loaded from a workspace file.

The selection mechanism for these lists (as for any list of this kind) is :

- Simple click mouse left button on an item, select this item and unselect all the others in the list.
- Click + drag mouse left button : multiple selection.
- Ctrl key down + click mouse left button on an item inverts its selection state.
- One mouse left button click on an item and another one on a different item while holding the shift key down, selects these two items plus all items in between.

To the right of the elements list, a tool bar allow to manage these elements.

| Edits the first (topmost) selected element. You can also double-click on an element to launch the edition window for this element.
| When an element is modified, ALL the calculations items already executed (partially or completely) on this element are flagged as to do analyses.
| Deletes all the selected elements.
| When an element is deleted, ALL the analyses items defined on this element are also deleted, but, the results files of these analyses are NOT deleted.

To create analyses items, You can select any number of analysis types, any number of loaded scenes, any number of elements and clicks on the button. The analysis items are added to the list in the bottom part of the window. Each [analysis type/scene/element] can only be added once.

##### Defined Analyses list

This list gives all the created analyses and (if any) the analyses loaded from a workspace file. This list has four columns :

- Status flags : - : to be computed, - : computation stopped, or, - : computation completed
- The analysis type (Solar access, Confort,...)
- The analysed scene name
- The element on which the analysis will be executed

The list top bar proposes sorting buttons for each one of the four columns. One click on a button sorts alphabetically the list in one order and a second click does it in the reverse order.

Notes:

- When you create analyses (or loads from a TWS file), the application will look in its temporary results directory (Settings/Miscellaneous) for a file that matches the data of the added analysis. If so, the status done flag (or if uncomplete) is displayed in the analysis status column.
- The selection mechanism is the same one as mentionned above for the other lists.
- The execution of the selected analysis is done sequentially from top to bottom.

To the right of the analyses list, the analyses tool bar :

| Moves up the selected analyses. Each click on this tool moves any selected analysis one place up in the list until it reaches the top of the list or the topmost unselected place.
| Moves down the selected analyses in the same way as the move-up tool above.
| Deletes all the selected analyses. The results files created by the execution of any of the deleted analyses are NOT deleted..
| Inspects the topmost selected analysis that was completely executed. It opens the results viewing window. This can also be done by a mouse left button double-click on the analysis item.
| Exports all the selected and completely executed analyses. You will be asked to specify the directory in which files will be exported. Files are exported in text format. It contains the scene file name, the analysis type, the description of the analysis element and the extra-data used in the calculation. For example, in the exported file for a solar access analysis, the extra-data encompass the latitude value, the altitude value, the monthly data used for every calculated day,...etc. The results comprise, for each point of the used element, for each computed day and for each hour, the values of each computed energy.

Push the button to start the execution of all selected analyses. The analyses already completely computed are not re-computed, unless you decide to force all calculations by ckecking on the check box.

When the execution starts, the label of the Execute button changes to a stop button; you can stop and resume computations at any time.

Attention: If any "critical" changes are applied to the elements or to the parameters and data used for the calculations, when resumed, the partially computed analyses will be discarded and their computation restarts from scratch.
For example, in solar access or confort calculations, critical changes in parameters are : the latitude, the number of days, the type of energy, etc. And any changes in the points coordinates, step (if any) or orientation vector of the element used are also considered as 'critical' and, when applied, the status flag of all the concerned analyses turns directly to to do flag.

As mentionned before, for each calculation, TownScope keeps the results in the ts_temp directory. You can choose this directory in the Settings/Miscellaneous panel. The name of the results file is composed depending on the calculation components :

[Analysis acronym]_[scene name]_[element type code]_[element name].trf

Acronyms are : SA for Solar Access, CE for Comfort Evaluation, VL for View Lengths, SO for Sky Opening and VS for Visibility.

When you load any .trf file, the application searches the defined analyses to see if one matches the data of the loaded results file. If so, the file is associated with the analysis that will be flagged as done ().

Help main page