skypjack/qsapecng
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
QSapecNG README ~~~~~~~~~~~~~~~~ QSapecNG v2.1.1 Copyright (C) 2009, Michele Caini GNU General Public License v3 This program is free software: 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 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. What is it? ~~~~~~~~~~~ QSapecNG is a Qt-based program for symbolic analysis of linear analog circuits. In fact, it consists of two indipendent parts: the SapecNG framework engine and the application gui QSapecNG. It is an open source, multi-platform project, continuously enhanced by students and researchers of Department of Electronics and Telecommunications (DET) of the University of Florence. It comes as continuation of SapWin for Windows, in order to give to the project a full compatibility on other platforms. Through SapecNG/QSapecNG users can draw, solve and analyze analog circuits as well as manage them. Since version 2.0.0~beta1 there is also the full support for sub-circuits that can be created, saved, reopened and added as part of other circuits. SapecNG/QSapecNG is freely available on SourceForge.net <https://sourceforge.net/projects/qsapecng/>. A previous version of SapecNG is available too, on SourceForge.net <https://sourceforge.net/projects/sapec-ng/>. Pre-compiled packages will be also available from projects related pages. Installation ~~~~~~~~~~~~ * Windows: open the setup executable and follow the instructions * GNU/Linux - binaries: install with the package manager of your distribution - sources: see section "Building and Installing" below * MacOSX: open the dmg file and copy the application bundle to the Applications folder Requirements for building ~~~~~~~~~~~~~~~~~~~~~~~~~ * Qt v4.6.2 (http://qt.nokia.com/) [QtCore and QtGui are required] * Boost v1.46.0 (http://www.boost.org/) [required] * Qwt v6.0.0 (http://qwt.sourceforge.net/) [required] * CMake v2.8 (http://www.cmake.org/) [optional, only for building] * Doxygen (http://www.doxygen.org/) [optional, needed to generate the html documentation] * NSIS (http://nsis.sourceforge.net/) [optional, needed to generate Setup file on Windows] * 7-Zip (http://www.7-zip.org/) [optional, needed to generate zip of source and binary files on Windows] * tar+gzip (http://www.gnu.org/software/tar/ and http://www.gzip.org/) [optional, needed to generate tar.gz of source and binaries file on Unix] * tar+bzip (http://www.gnu.org/software/tar/ and http://www.bzip.org/) [optional, needed to generate tar.bz2 of source and binaries file on Unix] Note for MacOS: in order to compile properly, you need the latest "MacOS compilation workaround" patch available here https://sourceforge.net/tracker/?func=detail&aid=3269126&group_id=369990&atid=1541778 Building and Installing ~~~~~~~~~~~~~~~~~~~~~~~ To build QSapecNG you need to have CMake installed on your system, visit http://www.cmake.org/ to download it. * Unix systems Browse the filesystem to reach the root directory of the source files and execute: - mkdir build - cd build - cmake [OPTIONS] .. - make - make install This will build and install QSapecNG to /usr/local/bin, to install in a different path see 'Options' section in this readme. For MacOSX it's better not to execute "make install", see section 'Packages' below * Windows Open the program "CMake" or "cmake-gui" than - browse the filesystem and select the root directory of the source files - select the destination build directory (usually "${src_path}/build") - click on "Configure" button and select the wanted output project (i.e. Visual Studio) - click again on "Configure" and than on "Generate" The project is now ready to be opened with Visual Studio. Select "Release" instead of "Debug" and build QSapecNG. After building if you want to install the program simply compile the "INSTALL" project. Options ~~~~~~~ Specific options for QSapecNG can be passed to cmake program with the "-D" parameter followed by the desidered option. * CMAKE_LIBRARY_PATH=/path/to/the/libraries this option must be used if some of the required libraries listed above are not in default system path * CMAKE_INCLUDE_PATH=/path/to/the/include/files the same for included files of the above libraries * CMAKE_INSTALL_PREFIX=/some/path QSapecNG will be installed to /some/path/bin * (only for Windows) INCLUDE_QT_DLL_IN_BIN_PACKAGE=[ON|OFF] if you want/don't want to include the DLL files of Qt Libraries in the binary packages (this option is enabled only if you have installed Qt as shared DLL libraries) * (only for Windows) INCLUDE_QWT5_DLL_IN_BIN_PACKAGE=[ON|OFF] if you want/don't want to include the DLL files of Qwt Libraries in the binary packages (this option is enabled only if you have installed Qwt as shared DLL libraries) * (only for MacOSX) INCLUDE_REQUIRED_LIBRARIES_INTO_BUNDLE=[ON|OFF] if you want to include required libraries into the application Bundle See CMake web-site for other generic cmake options. Building the documentation with Doxygen ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * Unix systems: after the "cmake" command you can execute "make doc" to generate the html documentation that will be saved to the ./doc subfolder. * Windows: if Doxygen is installed in the system, also the "doc" project can be build with Visual Studio, it generates the html documentation in the ./doc subfolder. Uninstalling ~~~~~~~~~~~~ * From Sources If the building tree has not been deleted from the filesystem you can execute, on Unix systems, "make uninstall" to remove the installed files or you can build the project "uninstall" on Visual Studio. * From Binary Packages - If you have installed from (g|b)zipped binary file you can simply delete every file you have unzipped. - If you have installed from Windows setup file you can found the Uninstall link in Start-->QSapecNG-->Uninstall - If you have installed from deb or rpm package you can remove the program using the package manager of your GNU/Linux distribution. - If you have installed from dmg file on MacOS simply drag the icon program from Applications directory to the Trash. Note for Debian-based distributions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The sources are provided with the "debian" subfolder, and the building of QSapecNG in a Debian-based system can be done using the common Debian building tools 'devscripts'. To build execute (in the source folder) debuild binary dpkg -i ../qsapecng_${version}_${arch}.deb where ${version} is the current version of QSapecNG and ${arch} is your system architecture. To generate the whole set of debian-related files you need to create the 'orig' tarball, this can be done executing "make package_source", the resulting gzipped archive does not contain the debian subfolder and represents the 'orig' tarball. The archive containing only the debian folder can be created executing "make debian_tar". Note for (Slackware/Debian/RedHat)-based distributions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can use the "checkinstall" instead of "make install" to install the program, so a slackware/deb/rpm package will be generated and installed. If you have downloaded a not-stable version from svn repository, I suggest using checkinstall with the following command checkinstall --default \ --pkgname qsapecng \ --pkgversion 2.1.1 \ --pkggroup electronics Packages ~~~~~~~~ There are two additional targets for "make" command: - package_source - package The first will create compressed archives with all the source files without the debian subfolder, the second will create a binary compressed package on Unix systems, a setup executable on Windows (if the program NSIS http://nsis.sourceforge.net/ is installed on the system) and a .dmg file with the application bundle on MacOSX. * Debian users may execute (as root) "cpack -G DEB" instead of "make package" to build a .deb binary file. * RedHat users may execute (as root) "cpack -G RMP" instead of "make package" to build a .rmp binary file (this command has not been tested). Translations ~~~~~~~~~~~~ Currently only English language is supported. The Italian one is in progress and other translations are welcomed. Usage ~~~~~ TODO