docs: add sampled transfer functions documentation

feat: add documentation for sampled PSFs and OTFs
fix: correct type parameter order in apply function signature
chore: reorder documentation pages and update navigation structure

Author: kunzaatko

docs/make.jl

@@ -32,10 +32,11 @@ makedocs(;
         "General Interface" => "pages/02_interface.md",
         "Transfer Functions" => [
             "Transfer Function Models" => "pages/03_model_tfs.md",
-            "Transfer Functions Measurements" => "pages/04_measured_tfs.md"],
+            "Transfer Functions Measurements" => "pages/04_measured_tfs.md",
+            "Sampled Transfer Functions" => "pages/05_sampled_tfs.md",],
         "References" => [
-            "API" => "pages/05_apireference.md",
-            "Bibliography" => "pages/06_bibliography.md"
+            "API" => "pages/06_apireference.md",
+            "Bibliography" => "pages/07_bibliography.md"
         ]],
     plugins=[bib, links],
     # NOTE: doctesting is done in the `runtests.jl` so it is not necessary to do here

docs/src/pages/05_sampled_tfs.md

@@ -0,0 +1,13 @@
+```@meta
+CurrentModule = TransferFunctions
+```
+
+# Sampled PSFs
+```@docs
+apply(::SampledOTF{N, OTF} where OTF<:TransferFunctions.OpticalTransferFunction{N}, ::AbstractArray{T, N}) where {N, T}
+```
+
+# Sampled OTFs
+```@docs
+apply(::SampledPSF{N, PSF} where PSF<:TransferFunctions.PointSpreadFunction{N}, ::AbstractArray{T, N}) where {T, N}
+```

docs/src/pages/05_apireference.md renamed to docs/src/pages/06_apireference.md

@@ -204,7 +204,7 @@ julia> img = testimage("moonsurface.tiff");
 julia> blurred_img = apply(sampled_otf, img);
 ```
 """
-apply(tf::SampledOTF{N}, img::AbstractArray{T,N}) where {N,T} = ifft(fft(gray.(img)) .* otf(tf, size(img)))
+apply(tf::SampledOTF{N}, img::AbstractArray{T,N}) where {T,N} = ifft(fft(gray.(img)) .* otf(tf, size(img)))
 
 # FIX: Add support for N-dim <30-11-23> 
 # @traitfn function otf_support(