Galleries: 🎨 Sample notebooks (w/outputs)
¹Richard Schreier (2021). Delta Sigma Toolbox (https://www.mathworks.com/matlabcentral/fileexchange/19-delta-sigma-toolbox), MATLAB Central File Exchange. Retrieved March 20, 2021.
INTERMEDIATE STAGE OF PORT: A significant portion of the Delta Sigma toolbox has been ported.
The following high-level functionnality has (at least partially) been ported:
simulateDSM,simulateMS,simulateSNR,simulateHBFsynthesizeNTF,realizeNTF,realizeNTF_ctcalculateSNR,peakSNR,predictSNRcalculateTF,evalTF,evalTFPstuffABCD,scaleABCD,mapABCD,partitionABCDmapCtoD,mapQtoRexampleHBFpulse,impL1lollipop,logsmoothdocumentNTF,plotExampleSpectrum
And demos:
dsdemo1, ...,dsdemo6,dsexample1,dsexample2,demoLPandBP
- Description
- Sample usage
- Plotting
- Installation
- Running sample scripts
- Function (API) help
- Julia tips
- Known limitations
As its name suggests, RSDeltaSigmaPort.jl is a Julia port of Richard Schreier's Delta Sigma Toolbox.
Note that this module is not named something like DeltaSigmaModulators.jl, thus allowing someone else to appropriate the package name later on. Hopefully, RSDeltaSigmaPort will eventually be superseded by a more generically named package that is better integrated with Julia's ecosystem than this simple port.
This module tries to remain true to the original Delta Sigma Toolbox while conforming to some Julia patterns, including:
- Multiple dispatch (make function calls simpler to write).
- Not writing each function definition in its own, separate file.
- Using keyword arguments when deemed appropriate.
- Returning
NamedTuples instead of simple arrays when multiple values are returned. - ...
Progressively replacing modulator parameters in function calls with RealDSM and QuadratureDSM objects:
- Simplifies function interface for user.
- Centralizes defaults for parameter values on construction of
RealDSMandQuadratureDSM. - Looking to keep "original" function interface (with individual modulator parameters) available for accustomed users.
- Looking to remove default values from said interface to avoid unexpected bugs from inconsistent defaults.
- Might change with time (not sure if certain parameters, like
opt, should migrate to a NTF structure or something).
RSDeltaSigmaPort.jl uses CMDimData.jl/EasyPlot to handle plotting.
For examples on how to generate new/customized plots, see the built-in
functions found in plot_*.jl files in the source directory:
The RSDeltaSigmaPort.jl toolbox is written using the Julia programming
language. Unless you already have Julia installed, you will need to first
install the base language. Simply download & install the most recent version
of Julia from Julia's official "downloads" page.
Julia's official "downloads" page:
Step 2 is to install the RSDeltaSigmaPort.jl package itself. Since
RSDeltaSigmaPort.jl is registered with Julia's General registry, you can
automatically download & install it from Julia's built-in package manager.
Simply launch Julia, and run the following from the command prompt:
julia> ]
pkg> add RSDeltaSigmaPort
Sample scripts in the sample/ subdirectory can be run using include().
For convenience, the @runsample macro automatically locates the script path
and executes include() for you:
julia> using RSDeltaSigmaPort #Will take a while to load, compile, etc...
julia> import RSDeltaSigmaPort: @runsample
julia> @runsample("dsdemo1.jl")
julia> @runsample("dsdemo2.jl")
julia> @runsample("dsdemo3.jl")
julia> @runsample("dsdemo4_audio.jl")
julia> @runsample("dsdemo5.jl")
julia> @runsample("dsdemo6.jl")
julia> @runsample("dsexample1.jl")
julia> @runsample("dsexample2.jl")
julia> @runsample("demoLPandBP.jl")
Typing ?RSDeltaSigmaPort in Julia's command line gives you a list of available functions:
julia> ?
help?> RSDeltaSigmaPort
Information on individual functions can be obtained in a similar fashion. Example:
julia> ?
help?> simulateDSM
Richard Schreier's original documentation is available here:
Functions that are not supported:
printmif()
Extensive compatibility testing of RSDeltaSigmaPort.jl has not been performed.
The module has been tested using the following environment(s):
- Linux / Julia-1.6.0
- INTERMEDIATE STAGE OF PORT: A significant portion of the Delta Sigma toolbox has been ported.
- Jupyter notebooks might be slightly broken/out of date. If so,
see their counterparts in the
sample/directory for a more regularly maintained example. - The
RSDeltaSigmaPort.jlmodule is not yet mature. Expect significant changes.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent