cocoaNEC 2.0 Reference Manual (Section 2)
NC Interpretive Language Interface
Kok Chen, W7AY
[w7ay (at) arrl (dot) net]
Last updated: January 10, 2011
The NC Interface
NC is a programming language
which you can use in cocoaNEC to describe antenna
geometries, set physical parameters, request different
output options and run optimization loops. The NC language
is patterned after the C Programming Language, thus the name
(NC stands for "NEC C").
To create a new NC model of an antenna, select New NC
Model in the File Menu, cocoaNEC will open a new
window for the model, with the title Untitled NC Model-N,
where N starts with 1 for the first window that you open in
cocoaNEC.
If you select Save in the File Menu while an NC
window is still untitled, cocoaNEC will use the same
mechanism as a Save As... .
Save As... presents you with a Save File dialog
for you to select the folder and file name to save the
model to. The model is saved as a plain text file. The
default extension for a NC file file is '.nc'.
If the NC window has previously been saved, or you have
opened the window from an existing .nc file by using the
Open NC Model item in the File Menu, Save
will update the NC file without prompting with a dialog.
Your program is entered as text into the NC Source
panel of the window.
The Output Console panel is where all
printf statements from your NC program send their
output to.
The Listing panel is where all syntax errors of
your programs are logged to. If NC finds a syntax error
when you press the Run button (Command G), it will
automatically switch the window to the Listing view.
If your NC programs runs successfully, the NEC-2 card dec
will be sent to the NEC-2 engine. If NEC-2 finds an error
(for example wires that are too close to ground), it may
not succeed in creating an output and nothing (including
the Card Deck) will show up in the Output window. However,
the deck that is generated will appear in the Card Deck
panel of the NC window and you might be able to discover
the cause of the problem.
There is a normally hidden Stop button next to the
Run button in the NC window.
This button appears while the NC program is running and is
hidden again when the NC program has finished executing.
The Stop button allows you to quit from a repeat
or while loop.