You are on page 1of 6

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]
Whoevers 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
...
...