--- xnecview-1.35.orig/Imakefile +++ xnecview-1.35/Imakefile @@ -1,6 +1,6 @@ SYS_LIBRARIES = `pkg-config gtk+-2.0 --libs` -lm -lpng DEFINES = -DHAVE_LIBPNG -INCLUDES = `pkg-config gtk+-2.0 --cflags` +INCLUDES = `pkg-config gtk+-2.0 --cflags` -I/usr/include/libpng SRCS = xnecview.h config.h xnecview.c xwin.c parse_input.c parse_output.c draw.c draw_opaque.c freqplot.c postscript.c OBJS = xnecview.o xwin.o parse_input.o parse_output.o draw.o draw_opaque.o freqplot.o postscript.o ComplexProgramTarget(xnecview) --- xnecview-1.35.orig/config.h +++ xnecview-1.35/config.h @@ -57,6 +57,6 @@ #define XFONT "6x10" /* font for text in the on-screen drawing */ #define PSFONT "helvetica" /* font for postscript output (size is derived by scaling the X font) */ -#define R0 50.0 /* default reference impedance for SWR calculation */ +#define DEFAULTR0 50.0 /* default reference impedance for SWR calculation */ #define Polthr (M_SQRT2-1) /* threshold of axial ratio used in polarization-colouring */ --- xnecview-1.35.orig/debian/README.debian +++ xnecview-1.35/debian/README.debian @@ -0,0 +1,9 @@ +xnecview for Debian +---------------------- + +This is built linked against libpng for fullest functionality, although this is +an option in the upstream source, obtained from +http://www.cs.utwente.nl/~ptdeboer/ham/xnecview/ + + Tue, 3, Jul 2001 15:00:00 +0000 + --- xnecview-1.35.orig/debian/changelog +++ xnecview-1.35/debian/changelog @@ -0,0 +1,212 @@ +xnecview (1.35-8) unstable; urgency=medium + + * QA upload. + * Set maintainer to QA address + * Apply wrap-and-sort + * Change B-D to libpng-dev (Closes: #662566) + * Fix "FTBFS with libpng16", using Nobuhiro's patch (Closes: #649798) + * Making the build reproducible, patch from Chris Lamp via the BTS + (Closes: #777332) + + -- Tobias Frost Thu, 07 Jan 2016 17:10:57 +0100 + +xnecview (1.35-7.1) unstable; urgency=low + + * Non-maintainer upload. + * R0 is already taken as a register name on armel, rename xnecview's + constant to DEFFAULTR0. + Closes: #621392 + * Add ${misc:Depends} to Depends, thanks lintian. + + -- Evgeni Golov Mon, 02 May 2011 09:14:19 +0200 + +xnecview (1.35-7) unstable; urgency=low + + * correct nonsensical standards version number of 3.8.22 to 3.8.2 + + -- Alan Bain Wed, 5 Aug 2009 20:10:10 +0100 + +xnecview (1.35-6) unstable; urgency=low + + * fix syntax error in this changelog + * remove duplicated fields from control file + * update packaging copyright statement + + -- Alan Bain Tue, 30 Jul 2009 22:00:01 +0100 + +xnecview (1.35-5.1) unstable; urgency=low + + * Non-maintainer upload. + * Always use C locale to prevent issues with locales that have + different (other than '.') decimal-point chars. + Thanks to Fernando M. Maresca for debugging and testing. + Closes: #511852. + * debian/rules: + + Call dh_clean instead of several rm -f in the clean target, + that cleans debian/ better, especially the debhelper logs. + + Add Makefile and xnecview._man to the cleaned files, + so they don't show up in the diff.gz. + + -- Evgeni Golov Tue, 20 Jan 2009 08:27:19 +0100 + +xnecview (1.35-5) unstable; urgency=low + * Fix md5sums file + * Change strip options to remove .comment and .note sections + * Added debian watch file + -- Alan Bain Tue, 8 Jul 2008 22:30:45 +0100 + +xnecview (1.35-4) unstable; urgency=low + * Set backing pixmap depth to depth of window not visual + (closes: bug#484725) + * removed build-depends on xutils + -- Alan Bain Tue, 8 Jul 2008 19:45:06 +0100 + +xnecview (1.35-3) unstable; urgency=low + * Don't set DH_COMPAT but use debian/compat + -- Alan Bain Tue, 6 May 2008 21:10:00 +0100 + +xnecview (1.35-2) unstable; urgency=low + * Don't rely on Makefile having clean target (closes: bug#478737) + + -- Alan Bain Tue, 6 May 2008 19:55:00 +0100 + +xnecview (1.35-1) unstable; urgency=low + * New upstream source + * Support for rectangular, triangular and quadrilateral surface + patches in NEC input. + * Turn hypens into minus signs in man page + * md5sums file now created. + + -- Alan Bain Sun, 27 Apr 2008 14:30:56 +0100 + +xnecview (1.34-8) unstable; urgency=low + * no strip option supported (closes: bug#438321) + -- Alan Bain Thu, 24 Apr 2008 23:00:56 +0000 + +xnecview (1.34-7.2) unstable; urgency=high + + * Non-maintainer upload. + * Ship manpages in /usr/share/man (Closes: #344230). + * Remove xlibs-dev build-dep. + + -- Luk Claes Sun, 8 Jan 2006 00:44:52 +0100 + +xnecview (1.34-7.1) unstable; urgency=medium + + * Non-maintainer upload. + * libpng transition (Closes: #328334). + + -- Luk Claes Thu, 27 Oct 2005 19:19:04 +0200 + +xnecview (1.34-7) unstable; urgency=low + * fixed libpng10 png.h include path (closes: bug#324393) + -- Alan Bain Wed, 24 Aug 2005 23:04:56 +0100 + +xnecview (1.34-6) unstable; urgency=low + * moved from /usr/X11R6/ to /usr/ hierarchy + * moved manpage from section 1x to section 1 + + -- Alan Bain Tue, 23 Aug 2005 20:28:20 +0100 + + +xnecview (1.34-5) unstable; urgency=low + * updated standards version + * removed .note and .comment sections from xnecview binary + * install section and priority into control file. + + -- Alan Bain Tue, 23 Aug 2005 19:26:20 +0100 + +xnecview (1.34-4) unstable; urgency=low + * Fixed build so dinstall doesn't think this is NMU. + * Hence closes: bug#263248, bug#230135, bug#230688, bug#230884 + + -- Alan Bain Wed, 10 Aug 2005 23:25:11 +0100 + +xnecview (1.34-3) unstable; urgency=low + * Link against libpng10 not libpng2 (closes: bug#263248) + * Man page updated to include option (closes: bug#230135) + * Error code returned to caller if No Data (closes: bug#230688) + * --expeps and --exppng error code reporting fixed + (closes: bug#230884) + + -- Alan Bain Wed, 10 Aug 2005 23:25:11 +0100 + +xnecview (1.34-2) unstable; urgency=low + * Fixed error in build which caused xnecview (1.34-1) to be + recorded as a NMU when it was in fact a maintainer release. + * Hence (closes: bug #151378 and closes: bug#152837) + + -- Alan Bain Sun, 4 Jan 2004 21:34:00 +0000 + +xnecview (1.34-1) unstable; urgency=low + * new upstream relase + * fully dynamic memory allocation (closes: bug#151378) + * opaque drawing bugfixes + * support for Numerical Green's Functions (GF card) (closes: bug#152837) + + -- Sun, 4 Jan 2004 14:59:00 +0000 + +xnecview (1.32-1) unstable; urgency=low + * New upstream release adds hidden line removal for the gain + pattern. + + -- Fri, 21 Sep 2002 21:59:00 +0100 + +xnecview (1.31-3) unstable; urgency=low + * Added libxaw7-dev to Build-Depends really closing bug + #103484 + + -- Fri, 6 Jul 2001 17:00:00 +0100 + +xnecview (1.31-2) unstable; urgency=low + * Added xlibs-dev and xutils to the Build-Depends closing + bug #103484 + + -- Wed, 4 Jul 2001 16:00:00 +0100 + +xnecview (1.31-1) unstable; urgency=low + * New upstream release + * variable number of subdivisions possible along axis + * Z0 can now have 4 digits instead of the previous 2 + * option -aupdate allows the update interval of the + animation to be set. + + -- Tue, 3 Jul 2001 16:00:00 +0100 + +xnecview (1.30-1) unstable; urgency=low + * New upstream release + * uses the GTK library instead of Xaw/Xmu/Xt. + * Plots of SWR, gain etc. as a function of freqency are now available + * Multiple frequency support + * Display of phase and magnitudes of currents in wires, with possibility of + animation. + * Display of E and B near field vectors and Poynting vector + * Dynamic memory allocation for radiation pattern data + * Export of PNG files is now possible. + * Plots of phi(X) and abs(Z) are possible + + -- Fri, 23 Feb 2001 15:00:00 +0000 + +xnecview (1.0-2) unstable; urgency=low + * fixed error in prerm script + -- Tue, 26 Oct 1999 11:00:00 +0100 + +xnecview (1.0-1) unstable; urgency=low + * New upstream source + * Almost all imput cards now supported + * Gain pattern can now be plotted + * Colour added + * Postscript Output + * Double Buffering of rotation display + * Wire numbers displayed, along with excitations and loads + -- Thu, 7 Oct 1999 15:13:00 +0100 + +xnecview (0.1-1) unstable; urgency=low + + * Initial release. + * Fixed copyright + -- Sun, 30 May 1999 12:00:00 +0100 + +Local variables: +mode: debian-changelog +End: --- xnecview-1.35.orig/debian/compat +++ xnecview-1.35/debian/compat @@ -0,0 +1 @@ +5 --- xnecview-1.35.orig/debian/control +++ xnecview-1.35/debian/control @@ -0,0 +1,22 @@ +Source: xnecview +Section: hamradio +Priority: extra +Maintainer: Debian QA Group +Standards-Version: 3.8.2 +Build-Depends: debhelper(>=5.0), + libgtk2.0-dev, + libpng-dev, + libxaw7-dev, + xutils-dev + +Package: xnecview +Architecture: any +Depends: ${misc:Depends}, ${shlibs:Depends} +Description: NEC structure and gain pattern viewer + xnecview allows a representation of a NEC (Numerical Electromagnetics + Code) structure, such as an antenna which is to be modelled to be + displayed on the screen. After an NEC run the gain pattern in various + formats can also be superimposed. This can be rotated and translated for + viewing from different angles. Plots of SWR and gain as a function of + frequency can also be produced. In addition to on screen display, + Postscript or PNG output can also be produced. --- xnecview-1.35.orig/debian/copyright +++ xnecview-1.35/debian/copyright @@ -0,0 +1,36 @@ +This package was originally debianized by afrb2@debian.org +Thu, 27 May 1999 16:53:48 +0100. + +The original version of this package was downloaded from + +ftp://ftp.qsl.net/pub/wb6tpu/NEC/xnecview-0.1.tar + +Later versions were downloaded from the xnecview homepage +http://www.cs.utwente.nl/~ptdeboer/ham/xnecview/ + +Copyright: + + +Copyright (C) 1998-2006, Pieter-Tjerk de Boer + +----------------------------------------------------------------------- +This program is free software; you can redistribute it and/or modify +it under the terms of version 2 of the GNU General Public License as +published by the Free Software Foundation. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, +MA 02110-1301, USA. +----------------------------------------------------------------------- + +On Debian systems, the complete text of the GNU General Public +License, version 2, can be found in /usr/share/common-licenses/GPL-2. + +The Debian packaging is Copyright (C) 1999-2008 Alan Bain +and is licensed under the GPL-2, see above. --- xnecview-1.35.orig/debian/dirs +++ xnecview-1.35/debian/dirs @@ -0,0 +1,2 @@ +usr/bin +usr/share/man/man1 --- xnecview-1.35.orig/debian/prerm +++ xnecview-1.35/debian/prerm @@ -0,0 +1,6 @@ +#!/bin/sh +set -e +if [ \( "$1" = "upgrade" -o "$1"="remove" \) -a \ + -L /usr/doc/xnecview ]; then + rm -f /usr/doc/xnecview +fi --- xnecview-1.35.orig/debian/rules +++ xnecview-1.35/debian/rules @@ -0,0 +1,77 @@ +#!/usr/bin/make -f +# Made with the aid of debmake, by Christoph Lameter, +# based on the sample debian/rules file for GNU hello by Ian Jackson. + +package=xnecview + +INSTALL = /usr/bin/install +INSTALL_PROGRAM = $(INSTALL) -o root -g root -m 0755 + +CDEBUGFLAGS = -g +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) + CDEBUGFLAGS += -O0 +else + CDEBUGFLAGS += -O2 +endif + + + +build: + $(checkdir) + xmkmf + $(MAKE) CDEBUGFLAGS="$(CDEBUGFLAGS)" + touch build + +clean: + $(checkdir) + dh_clean build *.o xnecview *.bak *~ core Makefile \ + xnecview._man debian/substvars + +binary-indep: checkroot build + $(checkdir) +# There are no architecture-independent files to be uploaded +# generated by this package. If there were any they would be +# made here. + +binary-arch: checkroot build + $(checkdir) + -rm -rf debian/tmp + install -d debian/tmp + install -d debian/tmp/DEBIAN \ + -d debian/tmp/usr/share/doc/$(package) + install -m 755 debian/prerm debian/tmp/DEBIAN + cd debian/tmp && install -d `cat ../dirs` + $(INSTALL_PROGRAM) xnecview `pwd`/debian/tmp/usr/bin/xnecview +ifeq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS))) + strip --remove-section=.comment --remove-section=.note `pwd`/debian/tmp/usr/bin/xnecview +endif + install -o root -g root -m 0644 xnecview.1x \ + `pwd`/debian/tmp/usr/share/man/man1/xnecview.1 + gzip -9n `pwd`/debian/tmp/usr/share/man/man1/xnecview.1 + cp debian/copyright debian/tmp/usr/share/doc/$(package)/. + + cp debian/changelog \ + debian/tmp/usr/share/doc/$(package)/changelog.Debian + cp README debian/tmp/usr/share/doc/$(package)/README + cp HISTORY debian/tmp/usr/share/doc/$(package)/changelog + + cd debian/tmp/usr/share/doc/$(package) && gzip -9nv changelog changelog.Debian README + + dpkg-shlibdeps $(package) + dpkg-gencontrol -isp + dh_md5sums --tmpdir=debian/tmp + chown -R root.root debian/tmp + chmod -R go=rX debian/tmp + dpkg --build debian/tmp .. + +define checkdir + test -f debian/rules +endef + +binary: binary-indep binary-arch + +checkroot: + $(checkdir) + test root = "`whoami`" + +.PHONY: binary binary-arch binary-indep clean checkroot --- xnecview-1.35.orig/debian/watch +++ xnecview-1.35/debian/watch @@ -0,0 +1,6 @@ +# Mandatory version line +version=3 + +# Peter Tjerk de Boer's website +http://wwwhome.cs.utwente.nl/~ptdeboer/ham/xnecview/xnecview-(.*)\.tgz + --- xnecview-1.35.orig/freqplot.c +++ xnecview-1.35/freqplot.c @@ -28,7 +28,7 @@ int plot2_z2=0; /* show the phi(z)/abs(z) graph? */ int plot2_dir=0; /* show the direction-of-maximum-gain graph? */ -double r0=R0; /* reference impedance for SWR calculation */ +double r0=DEFAULTR0; /* reference impedance for SWR calculation */ --- xnecview-1.35.orig/xnecview.1x +++ xnecview-1.35/xnecview.1x @@ -122,7 +122,7 @@ .TP .B lin.P/lin.V/arrl/log toggles gain scaling (linear in power, linear in voltage, ARRL-style, -or logarithmic with -40 dB at the center). +or logarithmic with \-40 dB at the center). .TP .B total/hor./vert./lhcp/rhcp/colour determines the handling of radiation's polarization: @@ -244,7 +244,7 @@ The polarization actually used, is the one selected by the polarization button in the top row; choosing "total" there (default), switches the projection operation off, so 'raw' phases and magnitudes are used. -If left- or right-hand circular polarization is selected, +If left-hand or right-hand circular polarization is selected, the projection is also not performed, but every current gets an extra phase shift proportional to the angle its projection perpendicular to the viewing direction makes with horizontal. @@ -377,90 +377,90 @@ The following options are available: .TP -.B -h, --help +.B \-h, \-\-help show usage information .TP -.B --struct +.B \-\-struct set structure view to 'struct' .TP -.B --tags +.B \-\-tags set structure view to 'struct+tags' .TP -.B --currents +.B \-\-currents set structure view to 'currents' .TP -.B --animation +.B \-\-animation set structure view to 'animation' .TP -.B --slice +.B \-\-slice set radiation view to 'slice' .TP -.B --frame +.B \-\-frame set radiation view to 'frame' .TP -.B --opaque +.B \-\-opaque set radiation view to 'opaque' .TP -.B --near +.B \-\-near set radiation view to 'near field' .TP -.B --linpower +.B \-\-linpower set radiation scale linear in power .TP -.B --linvoltage +.B \-\-linvoltage set radiation scale linear in voltage .TP -.B --arrl +.B \-\-arrl set radiation scale to ARRL style .TP -.B --log +.B \-\-log set radiation scale to logarithmic .TP -.B --pol=x +.B \-\-pol=x choose polarization; x may be total, hor, vert, lhcp, rhcp or colour . .TP -.B --qscale num +.B \-\-qscale num set charges scale (animation) .TP -.B --iscale num +.B \-\-iscale num set currents scale (animation) .TP -.B --escale num +.B \-\-escale num set electric field scale .TP -.B --hscale num +.B \-\-hscale num set magnetic field scale .TP -.B --hidepoynting +.B \-\-hidepoynting hide Poynting vector in near field display .TP -.B --afreq num +.B \-\-afreq num set animation frequency (Hz) .TP -.B --aphase num +.B \-\-aphase num set animation phase (degrees) .TP -.B --aupdate num +.B \-\-aupdate num set animation update interval (milliseconds). Default is 100, but on a slow computer and/or with a large data set it may be useful to set the update interval higher. Conversely, on a fast computer and with a simple data set, a smaller setting provides smoother movement. .TP -.B --freq num +.B \-\-freq num set frequency (MHz) .TP -.B --z0 num +.B \-\-z0 num set reference impedance (ohm) .TP -.B --expeps filename +.B \-\-expeps filename no X11 display, just export picture to .eps-file .TP -.B --exppng +.B \-\-exppng no X11 display, just export picture to .png-file (only available if linked against the libpng library) .TP -.B --view phi,theta,zoom,trx,try +.B \-\-view phi,theta,zoom,trx,try set viewing direction and zoom .PP Note: typing 'v' in window 1 writes the current values for --- xnecview-1.35.orig/xnecview.c +++ xnecview-1.35/xnecview.c @@ -15,6 +15,8 @@ #include #include +#include + #ifndef NO_GETOPT #include #endif @@ -373,6 +375,8 @@ initX(&argc,argv); inputfilename=NULL; + setlocale(LC_ALL, "C"); + wires=mymalloc(maxwires*sizeof(Wire)); surfaces=mymalloc(maxsurfaces*sizeof(Surface)); excis=mymalloc(maxexcis*sizeof(Exci)); --- xnecview-1.35.orig/xnecview.man +++ xnecview-1.35/xnecview.man @@ -0,0 +1,474 @@ +.\" Copyright (c) 1999-2002, Pieter Tjerk de Boer (pa3fwm@amsat.org) +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, +.\" USA. +.\" +.TH XNECVIEW 1 +.SH NAME +xnecview \- A program for visualizing NEC2 input and output files +.SH SYNOPSIS +.B xnecview +.I "[options]" +.I "filename" +.I "[filename....]" + +.SH DESCRIPTION +.B Xnecview +can visualize NEC2 input (structure of the antenna model) and output +data files +(gain as a function of direction, gain and impedance as a function of +frequency). +Structure and gain are shown as a three-dimensional picture which +can be rotated by the mouse. +The program will determine the type of data (input or output) from the files +themselves. + +More information and some examples can be found on the web at + http://www.cs.utwente.nl/~ptdeboer/ham/xnecview/ + +.SH USAGE + +On the commandline, the program expects to find one or more filenames, +each containing either NEC2 structure (input) data, or output data +(impedance and radiation pattern). +The program will determine the type of data from the data itself. +Depending on the data found in the file(s) specified, one or two windows +are opened. +Window 1 shows a 3D plot of the structure (wires etc.) of the antenna, +and/or the spatial distribution of the radiation. +Window 2 shows a set of graphs of several quantities (SWR, gain, etc.) +as a function of frequency. + + +.SS Window 1 + +This window shows the antenna's structure and/or the gain pattern. +Initially, the Z axis points up, the X axis points to lower left, and +the Y axis points to lower right (unless you changed those settings in +the source code). + +The view can be manipulated using the mouse as follows: +.TP +.B rotate +move mouse while holding left button depressed +(additionally, keep CTRL depressed to drag only a partial picture for higher speed) +.TP +.B zoom +move mouse up/down while holding middle button depressed +(additionally, keep CTRL depressed to drag only a partial picture for higher speed); +alternatively, click left mouse button for zooming in +or click right mouse button for zooming out. +.TP +.B move picture +move mouse while holding right button depressed +(additionally, keep CTRL depressed to drag only a partial picture for higher speed) +.TP +.B go back to original view +click middle mouse button +.PP +The view can also be rotated using the arrow keys. +The keys PageUp and PageDown select a different frequency, if radiation +data is available at more than one frequency. + +The top of the window contains a set of buttons and other indicators; +from left to right these are: +.TP +.B quit +to stop the program; keyboard shortcut: Q +.TP +.B reload +to reload the files; keyboard shortcuts: R and . +.PP +.TP +.B export +for saving the picture as an (encapsulated) PostScript or a PNG file. +.TP +.B none/struct/+tags/currents/animation +toggles displaying of antenna structure on and off; +in '+tags' mode, segment tag numbers are displayed too (which can be +helpful when trying to modify an antenna structure). +For display of currents and animations, see below. +.TP +.B none/slice/frame/opaque/near +toggles display of gain pattern: either none is shown, +or only slices in the coordinate planes, or the entire 3D structure +(of course subject to the availability of data in NEC's output file, and +thus ultimately to the RP cards used in the input file). +The 3D structure can either be shown as a wire mesh (i.e., transparent), +or as an opaque surface (i.e., with hidden lines removed); the latter +usually gives a clearer picture, but is often somewhat slower, and is +not available if the NEC output data do not cover a theta range from +0 to 90 or 180 degrees, and a phi range from 0 to between 270 and 360 degrees; +note that the gain surface is only opaque w.r.t. itself, not to other +elements of the picture such as the antenna structure. +For display of near fields, see under 'animation' below. +.TP +.B lin.P/lin.V/arrl/log +toggles gain scaling (linear in power, linear in voltage, ARRL-style, +or logarithmic with \-40 dB at the center). +.TP +.B total/hor./vert./lhcp/rhcp/colour +determines the handling of radiation's polarization: +whether the gain shown is according to the total power regardless of +polarization, or only the horizontal/vertical/left-hand circular/right-hand circular +component. +Choosing "colour" also shows the total power, but uses colour to show +whether the radiation is mostly linearly polarized, or lhcp or rhcp. +This setting also influences the gain-vs-frequency plots in window 2, +and the currents display in window 1 (see below). +.TP +.B X, Y and Z +rotate view to viewing along X, Y or Z axis respectively. +A gain scale will appear, with +lines at several gain levels. +All of these gains are with respect to the maximum gain in the entire +set of output data. +.PP +Though xnecview should be quite liberal in accepting output data from +NEC, you might want to start out by using this line (card) in your input: +.nf +RP 0, 37, 72, 1000, 0, 0, 5, 5 +.fi +This will instruct NEC to calculate the gain at 5 degree intervals. + + +.SS Window 2: + +This window contains plots of several quantities as a function of +frequency, if the NEC output file contains data for several frequencies. +The following quantities can be plotted: +.TP +.B SWR +.TP +.B real and imaginary part of the input impedance +.TP +.B phase and magnitude of the input impedance +If the antenna has multiple sources, SWR and impedance are only plotted +for whichever source's data appears first in the output file. +.TP +.B maximum gain and corresponding front/back ratio +The gain as plotted is the maximum gain observed over the entire radiation +pattern; this may not be the direction in which the antenna was supposed +to radiate! The front/back ratio is just the ratio of the maximum observed +gain to the gain in the exactly opposite direction; again, this may not be +the front/back ratio you're interested in, e.g. if the main lobe is elevated +so the 'back' direction points into the ground. + +If a specific polarization (rather than total power) has been chosen +(by command-line option or by the button in the top row of window 1), +this also influences the graph. +Two gain lines then appear: a solid line showing the gain in the selected +polarization, and a dashed line showing the total gain (for comparison). +Also, two f/b lines appear: for both, the front power is only the selected +polarization component, while the back power is also the selected polarization +(solid line), or the total power (dashed line). +.TP +.B direction (phi and theta) of maximum gain +.TP +.B vgain and corresponding front/back ratio +This is the gain in the direction towards viewer +(as set by rotating the picture in window 1) +and the corresponding front/back ratio. +.PP + +The row of buttons at the top have the following functions: +.TP +.B quit +to stop the program; keyboard shortcut: Q +.TP +.B reload +to reload the files; keyboard shortcuts: R and . +.TP +.B export +for saving the picture as an (encapsulated) PostScript or a PNG file. +.TP +.B Z0=... +for setting the reference impedance for SWR calculations; +furthermore, the impedance plots are limited to 20*Z0. +.TP +.B maxgain, vgain, SWR, Re/Im, phi/abs, and dir +for toggling the display of the graphs. +.PP + +Finally, if radiation pattern data is available, a vertical line over the +entire height of the window shows the frequency at which the radiation +pattern is being shown in the other window. With a mouse click or drag, +or the keys PageUp, PageDown and arrow keys, another frequency can be +chosen. + + +.SS Display of current distribution: + +Window 1 can also be used to display the distribution of the current +flowing in the antenna wires, if this information is available in the +NEC output file(s); by default, it is, but it may be switched off by +a 'PT' card in the NEC input. +This display is enabled by selecting 'currents' in the none/struct/+tags/currents +menu. +Then the thickness of each wire segment indicates the magnitude of the current +flowing there, +while the colour indicates its phase. +At the bottom of the window a few extra controls appear: two sliders for +changing the colours and scaling the thicknesses, and some buttons which +are discussed below. + +Contrary to what might be expected, the magnitude and phase of the current +as plotted +are not necessarily directly the values present in the NEC output file. +Taking that data directly would typically not result in a meaningful +display, since there is a 180 degree phase ambiguity: if the endpoints +of a wire are exchanged, then the 'positive direction' in that wire is +reversed, so the phase calculated by NEC changes by 180 degrees even though +the antenna and its properties don't change. +Therefore, it is preferable to project the current in each segment onto some +reference direction, e.g., horizontal. +The result of this is a measure for the contribution of that segment +to the horizontally polarized radiation of the antenna. +The polarization actually used, is the one selected by the polarization +button in the top row; choosing "total" there (default), switches +the projection operation off, so 'raw' phases and magnitudes are used. +If left-hand or right-hand circular polarization is selected, +the projection is also not performed, but every current +gets an extra phase shift proportional to the angle its projection +perpendicular to the viewing direction makes with horizontal. + +Actually, the phase displayed as discussed above is still not very interesting. +Consider the following: +if one segment is further away from the target to which the antenna is +supposed to radiate than another segment, then the radiation from the +former segment will incur a larger delay before reaching the target +than the radiation from the latter segment. +Effectively, this introduces another phase-shift, whose value depends +on the position of the segments in space. +Xnecview can compensate for this effect, by calculating this additional +phase-shift in the direction toward the viewer (i.e., perpendicular to +the screen); this option can be switched on and off by the first +button on the bottom row. + +The second button locks the direction used in the phase-shift calculation; +its use can best be explained by an example. +Consider a yagi antenna which is aimed along the X axis. +Then in order to get the correct phase-shift, one needs to rotate +the picture such that the X axis points to the viewer. +Unfortunately, in that orientation all elements are behind each +other, so it is impossible to distinguish them in order to compare +their colours. +This problem is resolved by pressing the 'lock' button to lock the +phase-shift calculation and then +rotating the antenna to an orientation in which the elements are +distinguishable. + + +.SS Animated display of currents, charges and near fields: + +Antennas as modeled by NEC are driven by a source (or more +than one) which applies a voltage or current to the antenna, +varying sinusoidally in time. +Consequently, the currents in the antenna wires, the charges +on the wires, and also the electric and magnetic field in the +surrounding space, vary sinusoidally in time too, at the +same frequency as the driving force, but possibly with a +different phase. +The display of the currents as described in the previous section +represents these time-varying currents by their amplitude +(thickness in the picture) and phase w.r.t. the source (colour +in the picture). + +For some purposes, this is not very intuitive. +Therefore, xnecview can also show the currents (and charges and +field strengths) exactly as they vary in time: an animation. +Basically, the process which in reality happens at a frequency +of thousands or more cycles per second is slowed down to a +frequency of about 1 cycle per second, and at that speed +the currents and charges are displayed. + +The animated display of currents and charges is enabled by +selecting 'animation' from the none/struct/+tags/currents/animation +menu. +Then each segment of each wire is replaced by a short blue line, one +end of which is at the center of the wire, while the other +end indicates the direction and (relative) magnitude of the +current. +Furthermore, around each segment a square is drawn. This +square represents the charge built up on that segment. +The size of the square is proportional to the magnitude of the +charge, while the colour shows the sign: cyan for positive +charge, magenta for negative. + +The animated display of the electric and magnetic field near +the antenna is chosen by selecting 'near' from the none/slice/frame/near +menu. +Then at every point for which near field data is found in the +NEC output file, three coloured lines (vectors) are drawn. +A red one indicates the direction and (relative) magnitude of +the electric field, +and a green one indicates the direction and (relative) magnitude of +the magnetic field. +From the electric and magnetic field vectors, the so-called Poynting +vector is calculated, and displayed in yellow. This vector can be +interpreted as the flow of energy; see a textbook on electromagnetic +theory for details. + +When either or both of the animated displays is selected, an +additional set of controls appears at the bottom of the window. +The left four of these are sliders to control the scaling of +(from left to right) currents, charges, electric and magnetic +field strength. +To the right of these, an on/off control labelled 'P' is shown, +which controls whether or not the Poynting vectors are drawn. +The rightmost slider controls the speed of the animation: if +your computer is fast enough, the number at the slider is the +number of animated cycles per second. +By setting this slider to 0, or hitting the 'z' key, +the animation can be frozen. +Then the phase can be changed back and forth by typing '<' and '>' +on the keyboard. + +Obviously, xnecview can only show currents, charges and +near fields if such information is available in the NEC +output file being visualized. +As discussed earlier in this manual, the inclusion of +currents is controlled by the PT card in the NEC input. +The inclusion of charge information is controlled by the +PQ card, and the calculation of near electric and magnetic +fields is controlled by NE and NH cards, respectively. +Examples are: +.nf +PQ 0, 0 +NE 0, 1,20,20, 0,0.05,0.05, 0,0.05,0.05 +NH 0, 1,20,20, 0,0.05,0.05, 0,0.05,0.05 +.fi +These instruct NEC to include the charge information, +and to calculate the near fields at 20 x 20 points in a +grid with stepsize 0.05, in the Y-Z-plane. +For more information see NEC documentation. + +.SH COMMAND-LINE OPTIONS + +In normal usage of xnecview, command-line options (other than the +names of the files to be displayed) are rarely needed. +However, they can be useful to bring xnecview quickly in +the desired state, or to use xnecview for non-interactive, +automated generation of plots. + +Command-line options can not only be given on the command line +with which xnecview is started, but they can also be embedded +as a CM card (line) in the NEC input file to be read. +In order for the content of a CM card to be recognized as +xnecview options, the CM card should contain the word +xnecview: (including the colon) before those options. + +The following options are available: +.TP +.B \-h, \-\-help +show usage information +.TP +.B \-\-struct +set structure view to 'struct' +.TP +.B \-\-tags +set structure view to 'struct+tags' +.TP +.B \-\-currents +set structure view to 'currents' +.TP +.B \-\-animation +set structure view to 'animation' +.TP +.B \-\-slice +set radiation view to 'slice' +.TP +.B \-\-frame +set radiation view to 'frame' +.TP +.B \-\-opaque +set radiation view to 'opaque' +.TP +.B \-\-near +set radiation view to 'near field' +.TP +.B \-\-linpower +set radiation scale linear in power +.TP +.B \-\-linvoltage +set radiation scale linear in voltage +.TP +.B \-\-arrl +set radiation scale to ARRL style +.TP +.B \-\-log +set radiation scale to logarithmic +.TP +.B \-\-pol=x +choose polarization; x may be total, hor, vert, lhcp, rhcp or colour . +.TP +.B \-\-qscale num +set charges scale (animation) +.TP +.B \-\-iscale num +set currents scale (animation) +.TP +.B \-\-escale num +set electric field scale +.TP +.B \-\-hscale num +set magnetic field scale +.TP +.B \-\-hidepoynting +hide Poynting vector in near field display +.TP +.B \-\-afreq num +set animation frequency (Hz) +.TP +.B \-\-aphase num +set animation phase (degrees) +.TP +.B \-\-aupdate num +set animation update interval (milliseconds). Default is 100, +but on a slow computer and/or with a large data set +it may be useful to set the update interval higher. +Conversely, on a fast computer and with a simple data set, +a smaller setting provides smoother movement. +.TP +.B \-\-freq num +set frequency (MHz) +.TP +.B \-\-z0 num +set reference impedance (ohm) +.TP +.B \-\-expeps filename +no X11 display, just export picture to .eps-file +.TP +.B \-\-exppng +no X11 display, just export picture to .png-file +(only available if linked against the libpng library) +.TP +.B \-\-view phi,theta,zoom,trx,try +set viewing direction and zoom +.PP +Note: typing 'v' in window 1 writes the current values for +all of these settings to the standard output. + + + +.SH AUTHOR +Pieter-Tjerk de Boer; Internet e-mail: pa3fwm@amsat.org, +amateur packet-radio: PA3FWM @ PI8DAZ.#TWE.NLD.EU. + --- xnecview-1.35.orig/xwin.c +++ xnecview-1.35/xwin.c @@ -277,7 +277,12 @@ fclose(f); return 1; } + +#if PNG_LIBPNG_VER_MAJOR >= 1 && PNG_LIBPNG_VER_MINOR >= 4 + if (setjmp(png_jmpbuf(pp))) { +#else if (setjmp(pp->jmpbuf)) { +#endif png_destroy_write_struct(&pp,&ip); fclose(f); gdk_image_destroy(image); @@ -360,7 +365,7 @@ winsizex=ev->width; winsizey=ev->height; gdk_pixmap_unref(gbackg); - gbackg=gdk_pixmap_new(w->window,winsizex,winsizey,depth); + gbackg=gdk_pixmap_new(w->window,winsizex,winsizey,gdk_drawable_get_depth(w->window)); calcproj(); redraw=1; #if 0 @@ -876,7 +881,7 @@ win2sizex=ev->width; win2sizey=ev->height; gdk_pixmap_unref(gbackg2); - gbackg2=gdk_pixmap_new(w->window,win2sizex,win2sizey,depth); + gbackg2=gdk_pixmap_new(w->window,win2sizex,win2sizey,gdk_drawable_get_depth(w->window)); redraw2=1; return TRUE; @@ -1386,7 +1391,7 @@ winsizex=toprow->requisition.width; calcproj(); } - gbackg=gdk_pixmap_new(w->window,winsizex,winsizey,depth); + gbackg=gdk_pixmap_new(w->window,winsizex,winsizey,gdk_drawable_get_depth(w->window)); upd_msg(); @@ -1482,7 +1487,7 @@ ggc2 = gdk_gc_new(w->window); - gbackg2=gdk_pixmap_new(w->window,win2sizex,win2sizey,depth); + gbackg2=gdk_pixmap_new(w->window,win2sizex,win2sizey,gdk_drawable_get_depth(w->window)); gtk_signal_connect( GTK_OBJECT(w), "expose_event", GTK_SIGNAL_FUNC(expose_event2), NULL);