RISATower File-Level User Tags

26632 Towne Centre Drive, Suite 210 Foothill Ranch, California 92610 (949) 951-5815 (949) 951-5848 (FAX) www.risatech.com October 1, 2008

2 •••• File-Level User Tags

Copyright 2008 by RISA Technologies, LLC. All rights reserved.

No portion of the contents of this publication may be reproduced or transmitted in any means without the express written permission of RISA Technologies, LLC.

We have done our best to ensure that the material found in this publication is both useful and accurate. However, please be aware that errors may exist in this publication, and that RISA Technologies, LLC makes no guarantees concerning accuracy of the information found here or in the use to which it may be put.

File-Level User Tags •••• 3

File-Level User Tags

Summary RISATower allows users to insert their own optional data into an eri file by editing the file with a word processor. Once read in, the user data is maintained in the memory of the program and saved back into the eri file along with the rest of RISATower data. This additional data is not used by the program in any way, it is merely transported from one eri file instance to another.

Manual editing of RISATower input files (.eri) creates the risk of file corruption and data loss. Please backup the project files before attempting to make any modifications to them.

There are two categories of these tags:

• Record tags: Tags for Antenna (i.e., Upper Structure), Tower (i.e., Base Tower), Dish, Feedline, or Discrete Load records

• Universal tags: Tags for the whole model/file

Inserting Tags The record tags can be entered for each Antenna, Tower, Feedline, Discrete Load, or Dish .The tags need to contain tag type identifying strings, as follows:

<AntennaTag>

<TowerTag>

<FeedLineTag>

<TowerLoadTag>

<DishTag>

Warning

About User-supplied File Tags

Record tags

4 •••• File-Level User Tags

As an example, we will input a tag for a dish in a model.

First open up an eri file that contains dishes in a text editor (e.g., Microsoft Word):

DishRec=1 DishEnabled=Yes DishDatabase=harris (cci) DishDescription=5115 DishGroup=1 DishNote= DishNum=1 DishFace=0 DishType=Paraboloid w/o Radome DishOffsetType=None DishVertOffset=0.000000 ... ...

Insert your tags anywhere within a dish record. Individual dish records start with the “DishRec=# ” line and end on the line immediately preceding the next dish record (with another “DishRec=# ”) or the next data segment.

DishRec=1 DishEnabled=Yes DishDatabase=harris (cci) DishDescription=5115 DishGroup=1 DishNote= DishNum=1 MyFirst<DishTag>=Anything here (numbers or text) The Last <DishTag>=1 + 2 = 12 DishFace=0 DishType=Paraboloid w/o Radome DishOffsetType=None DishVertOffset=0.000000 ... ...

Dish tags need to contain the string “<DishTag>” within the user defined tag as shown above. Antenna, Tower, Feedline and Discrete Loads tags need to contain “<AntennaTag>”, “<TowerTag>”, “<FeedLineTag>”, and “<TowerLoadTag>”, respectively. However, there are no restrictions on the value of the tag (anything after the “=” sign of the tag entry)

Save the file as plain text.

File-Level User Tags •••• 5

Universal tags are placed RIGHT AFTER the “[End Application] ” label. See the following example: ... ... WindDir2_14=No WindDir2_15=No SuppressWindPatternLoading=No [End Structure] [End Application] [Universal Tags] Whoever’s Info=Chicago All Symbols=!@#$%^&*()_+-0={}:”>?<,./;’[]\| A=alpha B=beta C= D=dharma [End Universal Tags] [CHRONOS] [Nodes] #node_number activity x y z 1 1 1.25 220 0.721688 2 1 1.25 200 0.721688 3 1 1.25 220 0.721688 ... ...

Universal tags start with the label “[Universal Tags] ” and end with “ [End Universal Tags] ”. There are no restrictions on the value of the tag and, unlike with record tags, there are no restrictions on the universal tag names.

Record tags may be inserted anywhere within a record, but RISATower will not remember this arrangement in the file. Using Dish tags as an example, when RISATower saves record tags back into the eri file, it will save all the tags right after the “DishRec=#” line. The order of the tags will depend on which tags RISATower encountered first when it was scanning the file from top to bottom. See the following example:

After user input: DishRec=1 DishEnabled=Yes DishDatabase=harris (cci) DishDescription=5115 DishGroup=1 MyFirst<DishTag>=Anything here (numbers or text) DishNote= DishNum=1 DishFace=0 The Last <DishTag>=1 + 2 = 12 DishType=Paraboloid w/o Radome DishOffsetType=None DishVertOffset=0.000000 ... ...

Universal tags

Additional Notes for

Record Tags

6 •••• File-Level User Tags

After RISATower opened the eri file and saved it again DishRec=1 MyFirst<DishTag>=Anything here (numbers or text) The Last <DishTag>=1 + 2 = 12 DishEnabled=Yes DishDatabase=harris (cci) DishDescription=5115 DishGroup=1 DishNote= DishNum=1 DishFace=0 DishType=Paraboloid w/o Radome DishOffsetType=None DishVertOffset=0.000000 ... ...