feat: add description_long to all cacao fpsexec compute units

AOloopControl/modalCTRL_stats.c

@@ -15,7 +15,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "modalCTRLstats",
     .cmdkey      = "modalCTRLstats",
-    .description = "compute modal control stats"
+    .description = "compute modal control stats",
+    .description_long =
+        "Compute real-time statistics of modal control loop performance. Tracks RMS residual, actuator stroke, and temporal power spectra per mode."
 };
 
 // Local variables pointers

AOloopControl/modalfilter.c

@@ -31,7 +31,9 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mfilt",
     .cmdkey      = "modalfilter",
     .description =
-        "Modal Filtering AO processing"
+        "Modal Filtering AO processing",
+    .description_long =
+        "Apply modal filtering in a real-time AO control loop. Decomposes WFS signals into modes, applies per-mode gains and temporal filters, and reconstructs DM commands."
 };
 
 

AOloopControl/modalfilter_test.c

@@ -37,7 +37,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mfilttest",
     .cmdkey      = "mfilttest",
-    .description = "test input for modal filter"
+    .description = "test input for modal filter",
+    .description_long =
+        "Generate synthetic test input for the modal filter module. Produces known modal coefficient sequences for validation and benchmarking."
 };
 
 #define SNAMEPREFIX "tseqPF"

AOloopControl/modalstatsTUI.c

@@ -88,7 +88,9 @@ typedef struct
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "modalstatsTUI",
     .cmdkey      = "modalstatsTUI",
-    .description = "modal stats TUI"
+    .description = "modal stats TUI",
+    .description_long =
+        "TUI (Text User Interface) for real-time display of modal AO control statistics. Shows per-mode gains, RMS, and temporal evolution."
 };
 
 static uint64_t *AOloopindex;

AOloopControl/zonalfilter.c

@@ -28,7 +28,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "zonalfilter",
     .cmdkey      = "zonalfilter",
-    .description = "zonal filtering"
+    .description = "zonal filtering",
+    .description_long =
+        "Apply zonal (per-actuator) filtering in a real-time AO control loop. Processes WFS signals directly in actuator space without modal decomposition."
 };
 
 

AOloopControl_DM/AOloopControl_DM_comb.c

@@ -33,7 +33,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "dmcomb",
     .cmdkey      = "dmcomb",
-    .description = "Combine DM channels"
+    .description = "Combine DM channels",
+    .description_long =
+        "Combine multiple DM command channels (correction, offsets, perturbations) into a single output. Applies per-channel gain, clipping limits, and response matrix mapping."
 };
 
 

AOloopControl_DM/DMturbulence.c

@@ -34,7 +34,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "dmturb",
     .cmdkey      = "atmturbulence",
-    .description = "DM turbulence simulation"
+    .description = "DM turbulence simulation",
+    .description_long =
+        "Simulate atmospheric turbulence on a deformable mirror by applying time-evolving Kolmogorov phase screens. Used for closed-loop testing without a real atmosphere."
 };
 
 

AOloopControl_DM/mk3Ddmgrid.c

@@ -15,7 +15,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mk3Ddmgrid",
     .cmdkey      = "mk3Ddmgrid",
-    .description = "create DM calibration pattern sequence"
+    .description = "create DM calibration pattern sequence",
+    .description_long =
+        "Create a 3D sequence of DM calibration patterns. Generates systematic poke patterns for response matrix acquisition."
 };
 
 // Local variables pointers

AOloopControl_DM/pokerndmodes.c

@@ -21,7 +21,9 @@ static float *pokempha = NULL;
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "pokerndmodes",
     .cmdkey      = "pokerndmodes",
-    .description = "poke modes with random amplitudes"
+    .description = "poke modes with random amplitudes",
+    .description_long =
+        "Poke deformable mirror modes with random amplitudes for system identification and response matrix calibration."
 };
 
 // Local variables pointers

AOloopControl_IOtools/WFScamsim.c

@@ -14,7 +14,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "WFScamsim",
     .cmdkey      = "WFScamsim",
-    .description = "simulate WFS camera"
+    .description = "simulate WFS camera",
+    .description_long =
+        "Simulate a wavefront sensor camera by applying photon noise, readout noise, and detector response to an ideal WFS image."
 };
 
 // Local variables

AOloopControl_IOtools/WFSmap.c

@@ -13,7 +13,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mapWFS",
     .cmdkey      = "mapWFS",
-    .description = "remap WFS image"
+    .description = "remap WFS image",
+    .description_long =
+        "Remap wavefront sensor pixels using a geometric transformation map. Corrects optical distortion or aligns subapertures."
 };
 
 static char wfsinsname[FUNCTION_PARAMETER_STRMAXLEN];

AOloopControl_IOtools/acquireWFSim.c

@@ -17,7 +17,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "acquireWFS",
     .cmdkey      = "acquireWFS",
-    .description = "acquire WFS image"
+    .description = "acquire WFS image",
+    .description_long =
+        "Acquire and preprocess wavefront sensor images from a camera stream. Applies background subtraction and normalization."
 };
 
 

AOloopControl_IOtools/acquireWFSspec.c

@@ -13,7 +13,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "acquire_spectra",
     .cmdkey      = "acquire_spectra",
-    .description = "acquire spectra"
+    .description = "acquire spectra",
+    .description_long =
+        "Acquire spectral data from a wavefront sensor for chromatic characterization and dispersed fringe tracking."
 };
 
 // Local variables

AOloopControl_IOtools/ao188_preprocessor.c

@@ -25,7 +25,9 @@ static float one_sided_curv_integrator_gain = 0.01; // TODO FPS
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "ao188preproc",
     .cmdkey      = "ao188preproc",
-    .description = "AO188 APD Preprocessor"
+    .description = "AO188 APD Preprocessor",
+    .description_long =
+        "Preprocess APD (Avalanche Photodiode) count data from the Subaru AO188 system. Converts photon counts to WFS slope signals."
 };
 
 static char apd_mat_name[FUNCTION_PARAMETER_STRMAXLEN];

AOloopControl_IOtools/findspots.c

@@ -15,7 +15,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "findspots",
     .cmdkey      = "findspots",
-    .description = "find spots in inmage"
+    .description = "find spots in inmage",
+    .description_long =
+        "Detect and locate bright spots in a wavefront sensor image. Uses thresholding and centroiding to find subaperture positions."
 };
 
 static char inimname[

AOloopControl_IOtools/spotpos.c

@@ -16,7 +16,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "spotpos",
     .cmdkey      = "spotpos",
-    .description = "measure spot position, photocenter"
+    .description = "measure spot position, photocenter",
+    .description_long =
+        "Measure the precise centroid position of spots in a WFS image using photocenter calculation with configurable weighting."
 };
 
 static char inimname[FUNCTION_PARAMETER_STRMAXLEN];

AOloopControl_PredictiveControl/AOloopControl_PredictiveControl.c

@@ -54,7 +54,9 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "aolPFwatchin",
     .cmdkey      = "aolPFwatchin",
     .description =
-        "watch telemetry for PF input"
+        "watch telemetry for PF input",
+    .description_long =
+        "Monitor AO telemetry and prepare input buffers for the predictive filter engine. Watches WFS and DM streams and triggers filter updates."
 };
 
 #define FPS_PARAMS(X) \
@@ -113,7 +115,9 @@ static FPS_APP_INFO FPS_app_info_map = {
     .fps_name    = "aolmappfilt",
     .cmdkey      = "aolmappfilt",
     .description =
-        "map/search predictive filter"
+        "map/search predictive filter",
+    .description_long =
+        "Monitor AO telemetry and prepare input buffers for the predictive filter engine. Watches WFS and DM streams and triggers filter updates."
 };
 
 #define FPS_PARAMS_MAP(X) \
@@ -153,7 +157,9 @@ static FPS_APP_INFO FPS_app_info_mk = {
     .fps_name    = "aolmkpfilt",
     .cmdkey      = "aolmkpfilt",
     .description =
-        "test predictive filter"
+        "test predictive filter",
+    .description_long =
+        "Monitor AO telemetry and prepare input buffers for the predictive filter engine. Watches WFS and DM streams and triggers filter updates."
 };
 
 #define FPS_PARAMS_MK(X) \
@@ -202,7 +208,9 @@ static FPS_APP_INFO FPS_app_info_ave = {
     .fps_name    = "aolpfsetave",
     .cmdkey      = "aolpfsetave",
     .description =
-        "set PF to integrator"
+        "set PF to integrator",
+    .description_long =
+        "Monitor AO telemetry and prepare input buffers for the predictive filter engine. Watches WFS and DM streams and triggers filter updates."
 };
 
 #define FPS_PARAMS_AVE(X) \

AOloopControl_acquireCalib/acquireWFSlincalib.c

@@ -19,7 +19,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "acqWFSlincal",
     .cmdkey      = "acqWFSlincal",
-    .description = "acquire linear WFS calibration"
+    .description = "acquire linear WFS calibration",
+    .description_long =
+        "Acquire WFS linear calibration data by systematically applying DM pokes and recording WFS responses. Builds the response matrix."
 };
 
 // Local variables pointers

AOloopControl_acquireCalib/measure_linear_resp.c

@@ -44,7 +44,9 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "measlinresp",
     .cmdkey      = "measlinresp",
     .description =
-        "measure linear response of one stream to another"
+        "measure linear response of one stream to another",
+    .description_long =
+        "Measure the linear response between two streams (input and output). Computes the transfer function by correlating perturbations with responses."
 };
 
 

AOloopControl_perfTest/compRMsensitivity.c

@@ -25,7 +25,9 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "compRMsensitivity",
     .cmdkey      = "compRMsensitivity",
     .description =
-        "Compute response matrix sensitivity"
+        "Compute response matrix sensitivity",
+    .description_long =
+        "Compute the sensitivity of a response matrix by analyzing singular value magnitudes and modal coupling coefficients."
 };
 
 

AOloopControl_perfTest/mlat.c

@@ -23,7 +23,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mlat",
     .cmdkey      = "mlat",
-    .description = "measure latency between DM and WFS"
+    .description = "measure latency between DM and WFS",
+    .description_long =
+        "Measure the end-to-end latency between DM commands and WFS responses. Applies a known DM pattern and cross-correlates with WFS to find the delay."
 };
 
 

AOloopControl_perfTest/mlat_decode.c

@@ -34,7 +34,9 @@ static uint32_t *nb0end;
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mlatdsdecode",
     .cmdkey      = "mlatdsdecode",
-    .description = "mlat diff sequence decode"
+    .description = "mlat diff sequence decode",
+    .description_long =
+        "Decode a latency measurement sequence to extract the frame-by-frame delay between DM and WFS streams."
 };
 
 #define FPS_PARAMS(X) \

AOloopControl_perfTest/streamlogtimesample.c

@@ -109,6 +109,8 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "slogtsample",
     .cmdkey      = "slogtsample",
     .description = "resample streams to common clock",
+    .description_long =
+        "Resample multiple logged streams to a common clock for synchronized temporal analysis."
 };
 
 #define FPS_PARAMS(X) \

AOloopControl_perfTest/wfsrefoptimselect.c

@@ -41,7 +41,9 @@ static float *selnormplaw;
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "wfsroptsel",
     .cmdkey      = "wfsroptsel",
-    .description = "WFS ref optimize by PSF selection"
+    .description = "WFS ref optimize by PSF selection",
+    .description_long =
+        "Optimize WFS reference selection based on PSF quality metrics. Selects the reference that maximizes Strehl ratio."
 };
 
 #define FPS_PARAMS(X) \

AOloopControl_perfTest/zoptsearch.c

@@ -82,7 +82,8 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "zoptsearch",
     .cmdkey      = "zoptsearch",
     .description = "stream zonal control optimize search",
-
+    .description_long =
+        "Search for optimal zonal control parameters by systematically varying gains and analyzing closed-loop residuals."
 };
 
 #define FPS_PARAMS(X) \

computeCalib/AOloopControl_computeCalib_processRM.c

@@ -649,7 +649,9 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mkCMsvd",
     .cmdkey      = "mkCMsvd",
     .description =
-        "compute SVD control matrix from RM"
+        "compute SVD control matrix from RM",
+    .description_long =
+        "Process a response matrix via SVD to compute the control matrix. Applies singular value filtering and modal truncation."
 };
 
 // Section 2: Local variables for FPS parameters

computeCalib/RM2zonal.c

@@ -69,7 +69,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "RM2zonal",
     .cmdkey      = "RM2zonal",
-    .description = "convert arbitrary response matrix to zonal"
+    .description = "convert arbitrary response matrix to zonal",
+    .description_long =
+        "Convert an arbitrary (e.g., modal) response matrix to zonal (per-actuator) representation."
 };
 
 static char RMmodesDM[FUNCTION_PARAMETER_STRMAXLEN];

computeCalib/actmap_sample2D.c

@@ -16,7 +16,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "sample2DWF",
     .cmdkey      = "sample2DWF",
-    .description = "sample 2D WF to act pos"
+    .description = "sample 2D WF to act pos",
+    .description_long =
+        "Sample a 2D wavefront at actuator positions to generate a discrete actuator command vector."
 };
 
 static char inWF2D[FUNCTION_PARAMETER_STRMAXLEN];

computeCalib/computeCalib.c

@@ -53,7 +53,9 @@ static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "aolHaddec",
     .cmdkey      = "aolHaddec",
     .description =
-        "decode Hadamard matrix"
+        "decode Hadamard matrix",
+    .description_long =
+        "Decode Hadamard-encoded response matrix measurements. Applies the inverse Hadamard transform to recover per-actuator responses."
 };
 
 #define FPS_PARAMS(X) \

computeCalib/computeHadamard.c

@@ -25,7 +25,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "mkHadamard",
     .cmdkey      = "mkHadamard",
-    .description = "make Hadamard modes"
+    .description = "make Hadamard modes",
+    .description_long =
+        "Generate Hadamard mode patterns for efficient response matrix acquisition. Uses balanced Hadamard matrices to minimize measurement noise."
 };
 
 static char inmask[FUNCTION_PARAMETER_STRMAXLEN];

computeCalib/compute_control_modes.c

@@ -22,7 +22,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "compctrlmodes",
     .cmdkey      = "compctrlmodes",
-    .description = "compute AO control modes in WFS and DM space"
+    .description = "compute AO control modes in WFS and DM space",
+    .description_long =
+        "Compute AO control modes in both WFS and DM coordinate spaces. Generates the modal basis for closed-loop control."
 };
 
 // Local variables

computeCalib/compute_masksWFSDM.c

@@ -22,7 +22,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "compmasksWFSDM",
     .cmdkey      = "compmasksWFSDM",
-    .description = "compute WFS and DM masks"
+    .description = "compute WFS and DM masks",
+    .description_long =
+        "Compute pupil masks for WFS and DM from response matrix data. Identifies active subapertures and actuators."
 };
 
 static char zrespWFS[FUNCTION_PARAMETER_STRMAXLEN];

computeCalib/compute_straight_CM.c

@@ -71,7 +71,9 @@
 static FPS_APP_INFO FPS_app_info = {
     .fps_name    = "compsCM",
     .cmdkey      = "compsCM",
-    .description = "compute straight control matrix"
+    .description = "compute straight control matrix",
+    .description_long =
+        "Compute a control matrix directly from a response matrix using straight pseudo-inversion without modal decomposition."
 };
 
 static char RMmodesDMfname[FUNCTION_PARAMETER_STRMAXLEN];