There are three ways to run the program, depending on how you installed it
(windows setup, executables or source files). See Installing the application above.
- Windows setup installation
You can launch the program by:
- Double-clicking the Desktop icon. When the main window appears, click the
"Open Parameter File" toolbar button and select a parameter file (.par).
You can start with "Parameters.par" at the "examples" folder.
- Click the Windows Start Menu / All Programs / lossifilters and select the
"mwfiltersgui" executable. When the main window appears, click the
"File Open" toolbar button and select a parameter file (.par). You can
start with "Parameters.par" at the "examples" folder.
- Double-clicking a parameter file (.par) in your Windows Explorer. The installer
has asscoiated .par files with the mwfiltersgui executable. When the program opens,
it will automatically open your parameter file.
- Executable files installation
The executables are autoextractable compressed files that embed the sources and
the python interpreter. The required shared libraries are supplied with the
executables and must be installed in the same directory (see section Installing the application above).
The executable file name is "mwfiltersgui". See below the command line syntax.
Clicking or doublecliking the mwfiltersgui executable file in a file manager
should open the GUI. Then you can load a parameter file as explained above in this
section.
- Source file installation
With the Python interpreter and required libraries installed (see annex ), you
can run the mwfiltersgui.py source file. This is the recommended option in linux
systems. See below the command line syntax.
If the .py file extension is associated with the Python interpreter, clicking or
doublecliking the mwfiltersgui.py source file in a file manager should open the GUI.
Then you can load a parameter file as explained above in this section. While in
Windows systems the Python installation automatically associates .py files with the
interpreter, it is not like that in most linux distributions. If this is your case,
you have to use the settings application of your desktop manager to create the
association.
After loading a parameter file, the parameter edit window will show the contents
of your parameter file. Then click the "Compute" pushbutton in the
parameter edit window or the "Execute Synthesis" button in the main window
toolbar. A figure plotting [S] parameters will appear. The you can click the
"Coupling Matrix" toolbar button in the main window and go to the coupling
matrix window, where you can edit or transform the matrix.
mwfiltersgui.py [-hvsrmep:] [filename]
mwfiltersgui.py [-hvs] --nogui [filename]
- - -nogui:
- Do not open the GUI and run the synthesis from the console. Needs a filename
parameter.
- filename:
- Parameter file name. Mandatory for the console interface (- -nogui option),
optional for the GUI.
- -h:
- Print a complete list of command line arguments.
- -v:
- Verbose output. Show more information (for debugging) at the log in the main
window (or at the console with –nogui flag).
- -s:
- Automatically symmetrize Generalized Chebyshev zeros in Hz in order to compute
a folded matrix with uniform Q in resonators.
- -r:
- Automatically run Synthesis. Needs simultaneous parameter file specification.
Meaningless with console interface (- -nogui option), since in this case it
always automatically runs synthesis and saves the results.
- -m:
- Automatically open Coupling Matrices window. Needs simultaneous -r flag.
Meaningless with console interface (- -nogui option), since in this case it
cannot open windows.
- -e:
- Automatically open Matrix Edit window. Needs simultaneous -m flag.
Meaningless with console interface (- -nogui option), since in this case it
cannot open windows.
- -p N:
- Save all default coupling matrices to file after they are computed, using N
significant digits. By default the matrices must be saved manually using the GUI.
- Running executables in MS-Windows:
Double click mwfiltersgui.exe in the windows explorer or open a DOS terminal and
run:
c:\folder> mwfiltersgui -h
c:\folder> mwfiltersgui --nogui parameter_file
c:\folder> mwfiltersgui [parameter_file]
- Running executables in Linux:
Open a Linux console and run:
$ mwfiltersgui -h
$ mwfiltersgui --nogui parameter_file
$ mwfiltersgui [parameter_file]
- Running sources in MS-Windows:
In MS-Windows, the .py files will be opened by the python interpreter. Double
click mwfiltersgui.py in the windows explorer or run:
c:\folder> mwfiltersgui.py -h
c:\folder> mwfiltersgui.py --nogui parameter_file
c:\folder> mwfiltersgui.py [parameter_file]
- Running sources in Linux:
In most linux distributions python sources files will be automatically opened by
the python interpreter if they have execute permission.
Open a Linux console and run:
$ mwfiltersgui.py -h
$ mwfiltersgui.py --nogui parameter_file
$ mwfiltersgui.py [parameter_file]
If the system does not identify these files as python sources, run:
$ python mwfiltersgui.py -h
$ python mwfiltersgui.py --nogui parameter_file
$ python mwfiltersgui.py [parameter_file]