IBM Release 1.93 manual Command Reference, Poems Command-Line Options, Global Group

Page 14

3. USING POEMS

Everything in POEMS is case-insensitive. Case is preserved but not significant in file names; specifying two names equal except for case will cause the first to be overwritten in Windows and OS/2 but not in Linux.

3.1. Command Reference

3.1.1. poems Command-Line Options

The calling syntax for POEMS is

 

poems parmfile <- option1 <option2 <option3>>>

 

where the options are one of DEBUG VERBOSE and RESTART.

 

DEBUG prints lots of debugging information,

 

VERBOSE prints more detail in the ordinary console output, and

 

RESTART causes POEMS to parse the specified simplex file and

 

restart the optimization run following the last completed iteration."

3.1.2. GLOBAL Group

ASSERT

Syntax: ASSERT <expression>

 

Allows the user to add parameter error checking to the simulations.

 

ASSERT functions very much like the assert() macro in C. Each

 

time the input file is parsed (i.e. at the beginning of the run and

 

before each iteration of the optimizer or stepper), <expression> is

 

evaluated. If the result is zero, the run is stopped and a specific

 

error message printed.

 

Example: ASSERT SourceZ Zsize-Tpml-lambda

COMMENT

Syntax: COMMENT anything you want to say

 

Specifies a string that is to be included in all text and HTML output

 

files. Useful for identifying information. You can use as many of

 

these as you like. The output files will be more readable if you

 

keep the total line length reasonable, e.g. 75 columns.

 

Comment lines treat trailing commas as punctuation, not line

 

continuation characters, so multi-line comments must be coded as a

 

separate COMMENT statement for each comment line.

DEBUG

Syntax: DEBUG onoff

 

Output lots of debugging information as the run proceeds. Useful

 

mostly for the developer.

10

Image 14
Contents IBM T. J. Watson Research Center Yorktown Heights, NY Page IBM T. J. Watson Research Center Yorktown Heights, NY Using Poems HOW Poems WorksChapter Introduction MotivationPhilosophy Structure OptimizationPage Poems system organization Script Operation Program OrganizationFront-End Script poems.cmd Fdtd Engine FIDO/TEMPEST Postprocessor EmpostVisualization System VIS5D Cluster ControlParallel Processing Global Group Command ReferencePoems Command-Line Options Function FreqLambda HostsWhich means that the host’s predefined hostname is not used MacdefMacro PrintSimulator RandomseedSET Verbose World GroupTitle BoundaryXrange Yrange Material GroupBasicstep DefineParameters epsReal epsImag muReal muImag FAN Object GroupBlock Tiledplane GratingHollowbox Cylinder Curve3DCURVE Source Group Command Group Output GroupCAD Postprocess GroupField WebpageIntegral FarfieldFlux List ModematchMovie MOVIE3DDissipation SliceGuess Optimize GroupVariables Penalty Merit LimitStore Range Schedule GroupParameters Computational Domain SymmetryObjects Perfectly-Matched Layers MaterialsPlane Waves Page Beam Sources Optimization Merit FunctionsPhase uniformity across a plane Worked Example Optimizing a V Antenna 10 Optimized V antenna refractivePage Predefined Constants Worked Example Doped Silica Waveguide ModeWorked Example Glass Ridge Waveguide to Free Space Coupler Reserved Names ConfinePredefined Mathematical Functions Arithmetic OperatorsAcos Logical OperatorsABS AcoshCOS ATAN2Ceil ElintkMAX Integral20. LN MINRound RandomROOT1D SignFlattop Analytical Pupil FunctionsMaterial Parameter Functions Time step Tempest and General Fdtd InformationStartup and Steady State Page Appendix A. V-Antenna Optimization Run Poems Input DIPOLE2I.PAR END Material END World Subdomain ALL END ObjectEND Output END CommandEND Source END Optimize Phaseex END Postprocess AmplexPage Page Page END Tempest Input File DIPOLE2I.PAR.IN Written by Phil Hobbs Pages of pointsource statements omitted DIPOLE2IEXI Postprocessor orders DIPOLE2I.ORDERSALL DIPOLE2IEXQDIPOLE2IEZI DIPOLE2IEYIDIPOLE2IEYQ DIPOLE2IEZQArray Amplex MiddlefluxPOSTPROC.1.NAME POSTPROC.1.PARMSTRINGPOSTPROC.2.PARMSTRING DIPOLE2IPHASEEXArray FF2Array Poyntingz DIPOLE2IPXPOSTPROC.6.NAME DIPOLE2IPZPOSTPROC.11.NAME POSTPROC.9.PARMSTRINGPOSTPROC.10.PARMSTRING Slice IndexnDIPOLE2IPZXY0.BMP Slice PoyntingzPOSTPROC.13.COMPARISONDOMAIN POSTPROC.14.NAMEPOSTPROC.17.NAME POSTPROC.16.COMPARISONDOMAINDIPOLE2IPXZX0.BMP Slice AmplexPOSTPROC.20.COMPARISONDOMAIN DIPOLE2IPHASEEXXY0.BMPDIPOLE2IPHASEEXZX0.BMP DIPOLE2IDISSZX0.BMPPOSTPROC.24.COMPARISONDOMAIN DIPOLE2IEXQZX0.BMPRun Results DIPOLE2I.SIMPLEX Page Page Page Page Page Fdtd and Tempest Tempest patchesAdvice common to all or most Fdtd programs Tempest limitationsWindow System Configuration Sample X11 ConfigurationWish list Running Vis5DRelease Notes Beta Release Limitations Page Page Matlab IndexEmdenormal Emunderflow Maxordersources 81 Maxpointsources