Providing Reliable Signal Processing Solutions Since 2001

THE ADAPTIVE SIGNAL PROCESSING TOOLBOX

Please remember that FREE-ASPT filters are limited to 32 coefficients and is intended for the purpose of evaluating the commercial ASPT products. For more information, refer to FREE-ASPT Home Page.
  • FREE-ASPT for Matlab

    Downloading

    FREE-ASPT for Matlab is currently available as a p-code toolbox for all platforms supported by Matlab. For all platforms, download the following package file and save it on your computer.


    The FREE-ASPT package file includes the following:
    • Implementations of 16 adaptive algorithms and their initialization functions
    • Matlab help files in the help directory.
    • Source code of a short application for each included adaptive filter in the test directory.
    Only Matlab help files are included with this distribution. You can access and download the complete ASPT for Matlab user manual in html or PDF format from the ASPT for Matlab home page.

    Installation and Configuration

    • Unpack the package file in a suitable place on your computer, below I assume that you are using Windows OS and you unpacked the package on "D:\", if you are using other OS, Unix or Linux for instance, replace "D:\" with your home directory or where Matlab is installed. Unpacking will create a directory dspalgorithms\libfaspt-2.1\Matlab with several sub-directories in it.
    • Start your Matlab software and change the current working directory inside Matlab to dspalgorithms\libfaspt-2.1\Matlab. You can do this by typing the following at the Matlab prompt
      >> cd d:\dspalgorithms\libfaspt-2.1\Matlab
    • Run the installation program provided with the package by typing the following at the Matlab prompt:
      >> asptinstall
      You will need write permission to the Matlab path files for this installation step to complete successfully. If you do not have write permission for those files, you will need to run the installation program every time you start Matlab, since the path information will be lost.

    Getting Started with FREE-ASPT for Matlab

    • You are now ready to start using your freshly installed FREE-ASPT for Matlab. The best way to start is to browse the source code of the short applications located in the dspalgorithms\libfaspt-2.1\Matlab\test directory and run each of them to learn how to call ASPT filters and how each of them behaves. As an example, type the following at the Matlab prompt to run the short active noise and vibration control example using the filtered-x LMS algorithm.
      >> testfxlms
      You are encouraged to cut from the provided applications and paste into your own adaptive filter applications. You can list the contents of the toolbox by typing the following at the Matlab prompt.
      >> help aspt
    • To learn more about ASPT for Matlab functions, refer to the ASPT for Matlab User Guide, which also includes many tutorials, examples, and applications source code.

    Back to top

  • FREE-ASPT for Windows, for use with Microsoft Visual C++

    Downloading

    To develop stand-alone real-time adaptive filters executable programs for the Windows operating systems using ASPT API and Microsoft Visual C++ 6.0 or better, download the following package file.


    The above package file includes the following:
    • Two dynamic link libraries (DLL) and their corresponding import libraries providing the implementation of 16 adaptive filters in single and double precision floating point arithmetic.
    • Include files containing the declarations of the adaptive filters.
    • C source code of a short application for each included adaptive filter.
    • The complete C-ASPT API reference pages in HTML format.

    Installation and Configuration

    • Unpack the package file in a suitable place on your computer, below I assume that you unpacked the package on "D:\". Unpacking will create a directory d:\dspalgorithms\libfaspt-2.1 with several sub-directories in it. Those sub-directories are as follows. libfaspt-2.1\inc32f and libfaspt-2.1\inc64f containing the include files for the single and double precision floating point adaptive filters implementations, respectively. libfaspt-2.1\src32f and libfaspt-2.1\src64f directories containing the C source code of an application for each filter included in the package, again for single and double precision floating point implementations, respectively. libfaspt-2.1\docs directory containing the complete C-ASPT API reference pages, and finally, the libfaspt-2.1\Win32\vcpp\lib directory containing the libfaspt32f.dll and libfaspt64f.dll dynamic link libraries and their corresponding libfaspt32f.lib and libfaspt64f.lib import libraries, together with other files.
    • You do not need any further configuration steps, assuming of course you have VC++ 6.0 or better installed and configured on your computer.

    Compiling an application and linking to ASPT libraries

    • To make the process of using ASPT DLLs as easy as possible, the package also contains an example VC++ 6.0 project file called faspt.dsw in the libfaspt-2.1\Win32\vcpp\faspt directory. Double-click on this file to open the project in your VC++ IDE. This project contains one application source file from the libfaspt-2.1\src64f directory, and links the compiled object file of this source code to libfaspt64f.lib and asptdisplay64f.obj. The former is the FREE-ASPT import library containing information on the adaptive filters implementations (the implementation code itself will be loaded at run time from the ASPT DLL), and the latter is a support module containing functions to print vectors and matrices. It is important to note that the FREE-ASPT DLLs for Windows will work properly only when they are located in the same directory from which the application linked to them is launched. This is the reason that the example project is configured to place the compiled and linked executable program in the same directory where the DLLs are, namely libfaspt-2.1\Win32\vcpp\lib. To compile the example application, simply choose Build->Clean, then Build->Rebuild All from the VC++ menu. As mentioned before, the intermediate files will be placed in the libfaspt-2.1\Win32\vcpp\faspt\Release directory but the executable will be placed in the libfaspt-2.1\Win32\vcpp\lib directory.
    • To run the created faspt.exe console application, open a DOS command line window, change the current working directory to where the executable and DLLs are, and type faspt at the DOS prompt. This should print the final filter coefficients after convergence to the screen and create several text files. Depending on the application you are running, the created text files will contain the input, desired, output, and error signals (for system identification applications) or reference, primary, secondary, and sensor signals (for active noise and vibration control applications). The time signals in those text files can be analyzed with any plotting program to verify the adaptive filter performance.
    • To learn more, browse the source code of the provided applications which gives you an insight on how easy it is to use ASPT filters. Modifying and compiling those applications and experimenting with ASPT filters with different parameters is probably the best way to learn more about adaptive filters in general and ASPT APIs in particular. A great source of advanced information can also be found in the C-ASPT user manual, and the C-ASPT reference pages available at the C-ASPT home page

    Back to top

  • FREE-ASPT for Windows, for use with GNU C Compiler

    Downloading

    To develop stand-alone real-time adaptive filters executable programs for the Windows operating systems (including Windows XP, 2000, NT, ME, 98, and 95) using ASPT API and one of the Win32 ports of GCC 2.95 or better, download the following package file.


    The above package file includes the following:
    • Two dynamic link libraries (DLL) providing the implementation of 16 adaptive filters in single and double precision floating point arithmetic.
    • Include files containing the declarations of the adaptive filters.
    • C source code of a short application for each included adaptive filter.
    • The complete C-ASPT API reference pages in HTML format.

    Installation and Configuration

    • Unpack the package file in a suitable place on your computer, below I assume that you unpacked the package on "D:\". Unpacking will create a directory d:\dspalgorithms\libfaspt-2.1 with several sub-directories in it. Those sub-directories are as follows. libfaspt-2.1\inc32f and libfaspt-2.1\inc64f containing the include files for the single and double precision floating point adaptive filters implementations, respectively. libfaspt-2.1\src32f and libfaspt-2.1\src64f directories containing the C source code of an application for each filter included in the package, again for single and double precision floating point implementations, respectively. libfaspt-2.1\docs directory containing the complete C-ASPT API reference pages, and finally, the libfaspt-2.1\Win32\gcc\lib directory containing the libfaspt32f.dll and libfaspt64f.dll dynamic link libraries, together with other files.
    • The DLLs provided are compiled and configured to be used in a native Windows environment (opposed to the POSIX emulation layer provided by CYGWIN), and therefore, you will need to use the minGW package (www.mingw.org) to compile your applications that will be linked to ASPT DLLs. Make sure that you downloaded and installed the latest release of minGW before attempting to compile and link any applications that uses ASPT filters.

    Compiling an application and linking to ASPT libraries

    • To make the process of using ASPT DLLs as easy as possible, the package also contains an example Makefile (for GNU make) located in the libfaspt-2.1\Win32\gcc directory. Open this Makefile in your text editor, you will see that the Makefile compiles one of the applications source files from libfaspt-2.1\src32f and links the resulting object file to .\lib\libfaspt32f.dll and .\lib\asptdisplay32f.o. The former is the ASPT dynamic link library containing the adaptive filters implementations and the latter is a support module containing functions to print vectors and matrices. The resulting executable is placed where the DLLs are, namely in the .\lib directory. Note that the DLLs will work correctly only when they are located in the same directory from which the application linked to them is launched. This is the reason that the Makefile is configured to place the compiled executable program in the libfaspt-2.1\Win32\gcc\lib directory, where the DLL are located. Compile the example application by opening a DOS command line box, change directory to where the Makefile is, and type make at the DOS prompt.
    • To run the created faspt.exe console application, open a DOS command line window, change the working directory to where the executable and DLLs are, and type faspt at the DOS prompt. This should print the final filter coefficients after convergence to the screen and create several text files. Depending on the application you are running, the created text files will contain the input, desired, output, and error signals (for system identification applications) or reference, primary, secondary, and sensor signals (for active noise and vibration control applications). The time signals in those text files can be analyzed with any plotting program to verify the adaptive filter performance.
    • To learn more, browse the source code of the provided applications which gives you an insight on how easy it is to use ASPT filters. Modifying and compiling those applications and experimenting with ASPT filters with different parameters is probably the best way to learn more about adaptive filters in general and ASPT APIs in particular. A great source of advanced information can also be found in the C-ASPT user manual, and the C-ASPT reference pages available at the C-ASPT home page

    Back to top

  • FREE-ASPT for Linux and Unix

    Downloading

    To develop stand-alone real-time adaptive filters executable programs for the Linux or Unix operating systems using ASPT API and GCC 2.95 or better, download one of the following package file.


    Each of the above package files includes the following:
    • Two dynamic link libraries (DLL) providing the implementation of 16 adaptive filters in single and double precision floating point arithmetic.
    • Include files containing the declarations of the adaptive filters.
    • C source code of a short application for each included adaptive filter.
    • The complete C-ASPT API reference pages in HTML format.

    Installation and Configuration

    • Make sure to unpack the downloaded package file using
      > unzip -a faspt_*.zip
      to convert any text files to the preferred format for your platform. Below I assume that you unpacked the package in your home directory, referred to as "~/" below. Unpacking will create a directory ~/dspalgorithms/libfaspt-2.1 with several sub-directories in it. Those sub-directories are as follows. libfaspt-2.1/inc32f and libfaspt-2.1/inc64f containing the include files for the single and double precision floating point adaptive filters implementations, respectively. libfaspt-2.1/src32f and libfaspt-2.1/src64f directories containing the C source code of an application for each filter included in the package, again for single and double precision floating point implementations, respectively. libfaspt-2.1/docs directory containing the complete C-ASPT API reference pages, and finally, the libfaspt-2.1/ARCH/lib directory (where ARCH indicating the machine architecture, for example Solaris or Linux_x86) containing the libfaspt32f.so and libfaspt64f.so dynamic link libraries, together with other files.
    • If you need to move ASPT files around on your computer, make sure to use
      > cp -p
      to preserve files attributes, which are important for the correct operation of the library files.
    • Make sure that the libfaspt32f.so and libfaspt64f.so dynamic link libraries are executable. If not, you need to make them executable by using
      > chmod +x filename
    • You do not need any further configuration steps, assuming of course you have GCC 2.95 or better installed and configured on your computer.

    Compiling an application and linking to ASPT libraries

    • To make the process of using ASPT DLLs as easy as possible, the package comes with one or more example Makefiles (for GNU make) located in the libfaspt-2.1/ARCH directory. Open the Makefile.32f file in your text editor, you will see that it compiles one of the applications source files from libfaspt-2.1/src32f and links the resulting object file to ./lib/libfaspt32f.so and ./lib/asptdisplay32f.o. The former is the ASPT dynamic link library containing the adaptive filters implementations and the latter is a support module containing functions to print vectors and matrices. The resulting executable is placed where the Makefile is, namely in the libfaspt-2.1/ARCH directory. Note that the DLLs will work correctly only when they are located in the ./lib directory relative to the application. Note also that the DLL path is stored in the binary executable, and there is no need to add the directory where the DLLs are located to the dynamic loader path. Compile the example application by opening a shell command line box, change directory to where the Makefile is, and type the following at the system prompt
      > make -f Makefile.32f.
    • To run the created faspt32f console application, open a shell command line box, change the working directory to where the executable is, and type ./faspt32f at the system prompt. This should print the final filter coefficients after convergence to the screen and create several text files. Depending on the application you are running, the created text files will contain the input, desired, output, and error signals (for system identification applications) or reference, primary, secondary, and sensor signals (for active noise and vibration control applications). The time signals in those text files can be analyzed with any plotting program to verify the adaptive filter performance.
    • To learn more, browse the source code of the provided applications which gives you an insight on how easy it is to use ASPT filters. Modifying and compiling those applications and experimenting with ASPT filters with different parameters is probably the best way to learn more about adaptive filters in general and ASPT APIs in particular. A great source of advanced information can also be found in the C-ASPT user manual, and the C-ASPT reference pages available at the C-ASPT home page

    Back to top

  • FREE-ASPT Support

    FREE-ASPT is fully supported product by DSP ALGORITHMS. Please use the contact form to send us any questions, suggestions, or bug reports.

Copyright © DSP ALGORITHMS, All rights reserved.