Merge pull request #20 from oxfordcontrol/v0.11.1

Version 0.11.1 update

Author: bnaras

.Rbuildignore

@@ -16,3 +16,4 @@
 
 ^src/rust/.cargo$
 ^src/Makevars$
+^cran-comments\.md$

DESCRIPTION

@@ -1,22 +1,22 @@
 Package: clarabel
 Type: Package
 Title: Interior Point Conic Optimization Solver
-Version: 0.10.1
+Version: 0.11.1
 Authors@R: c(person("Balasubramanian", "Narasimhan", role = c("aut", "cre"),
 	   	   email = "naras@stanford.edu"),
 	     person("Paul", "Goulart", role = c("aut", "cph")),
 	     person("Yuwen", "Chen", role = c("aut")),
              person("Hiroaki", "Yutani", role = c("ctb"),
 	            comment = "For vendoring/Makefile hints/R scripts for generating crate authors/licenses"),
              person("David", "Zimmermann-Kollenda", role = c("ctb"),
-	             comment = "For configure scripts and tools/msvr.R lifted from rtitoken package"), 
+	             comment = "For configure scripts and tools/msvr.R lifted from rtiktoken package"), 
 	     person(given = "The authors of the dependency Rust crates", role = c("ctb"),	
                     comment = "see inst/AUTHORS file for details"))
 Description: A versatile interior point solver that solves linear programs (LPs), quadratic programs (QPs), second-order cone programs (SOCPs), semidefinite programs (SDPs), and problems with exponential and power cone constraints (<https://clarabel.org/stable/>). For quadratic objectives, unlike interior point solvers based on the standard homogeneous self-dual embedding (HSDE) model, Clarabel handles quadratic objective without requiring any epigraphical reformulation of its objective function. It can therefore be significantly faster than other HSDE-based solvers for problems with quadratic objective functions. Infeasible problems are detected using using a homogeneous embedding technique.
 License: Apache License (== 2.0)
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.2
+RoxygenNote: 7.3.3
 URL: https://oxfordcontrol.github.io/clarabel-r/
 BugReports: https://github.com/oxfordcontrol/clarabel-r/issues
 Suggests: 

NEWS.md

@@ -1,3 +1,12 @@
+# clarabel 0.11.1
+
+- Synced up to v0.11.1 of `Clarabel.rs`
+- Fixed `flang` issues shown on CRAN for fedora-clang-rdevel
+
+# clarabel 0.10.1
+
+- Minor fixes to fix CRAN issues
+
 # clarabel 0.10.0
 
 - Synced up to v0.10.0 of `Clarabel.rs`

R/clarabel.R

@@ -1,4 +1,4 @@
-#' @title Interface to 'Clarabel', an interior point conic solver
+#' Interface to 'Clarabel', an interior point conic solver
 #'
 #' @description
 #'
@@ -80,7 +80,7 @@
 #' cone of size 2, followed by a zero cone of size 3, and finally a second-order
 #' cone of size 3. Generalized power cones parameters have to specified as named lists, e.g., `list(z = 2L, gp1 = list(a = c(0.3, 0.7), n = 3L), gp2 = list(a = c(0.5, 0.5), n = 1L))`.
 #'
-#' _Note that when `strict_cone_order = FALSE`, types of cone parameters such as integers, reals have to be explicit since the parameters are directly passed to the Rust interface with no sanity checks.!_
+#' _Note that when `strict_cone_order = FALSE`, types of cone parameters such as integers, reals have to be explicit since the parameters are directly passed to the Rust interface with no sanity checks!_
 #'
 #' @examples
 #' A <- matrix(c(1, 1), ncol = 1)
@@ -175,7 +175,7 @@ clarabel <- function(A, b, q, P = NULL, cones, control = list(),
 #' @param equilibrate_max_scaling maximum equilibration scaling allowed (`1e+4`)		 
 #' @param linesearch_backtrack_step linesearch backtracking (`0.8`)			 
 #' @param min_switch_step_length minimum step size allowed for asymmetric cones with PrimalDual scaling (`1e-1`)		 
-#' @param min_terminate_step_length minimum step size allowed for symmetric cones && asymmetric cones with Dual scaling (`1e-4`)		 
+#' @param min_terminate_step_length minimum step size allowed for symmetric cones && asymmetric cones with Dual scaling (`1e-4`)
 #' @param max_threads maximum solver threads for multithreaded KKT solvers, 0 lets the solver choose for itself (`0L`)
 #' @param direct_kkt_solver use a direct linear solver method (required true) (`TRUE`)		 
 #' @param direct_solve_method direct linear solver (`"qdldl"`, `"mkl"` or `"cholmod"`) (`"qdldl"`)		 
@@ -191,11 +191,14 @@ clarabel <- function(A, b, q, P = NULL, cones, control = list(),
 #' @param iterative_refinement_max_iter iterative refinement maximum iterations (`10L`)			 
 #' @param iterative_refinement_stop_ratio iterative refinement stalling tolerance (`5.0`)
 #' @param presolve_enable whether to enable presolvle (`TRUE`)
+#' @param input_sparse_dropzeros explicitly drop structural zeros from sparse data inputs (`FALSE`); see details
 #' @param chordal_decomposition_enable whether to enable chordal decomposition for SDPs (`FALSE`)
 #' @param chordal_decomposition_merge_method chordal decomposition merge method, one of `'none'`, `'parent_child'` or `'clique_graph'`, for SDPs (`'none'`)
 #' @param chordal_decomposition_compact a boolean flag for SDPs indicating whether to assemble decomposed system in _compact_ form for SDPs (`FALSE`)
 #' @param chordal_decomposition_complete_dual a boolean flag indicating complete PSD dual variables after decomposition for SDPs
 #' @return a list containing the control parameters.
+#' @details
+#' Setting `input_sparse_dropzeros` to `TRUE` will disable parametric updating functionality. See documentation of ‘dropzeros’ in Rust `struct CscMatrix` for dropping structural zeros before passing to the solver. 
 #' @export clarabel_control
 clarabel_control <- function(
                              ## Main algorithm settings
@@ -246,6 +249,7 @@ clarabel_control <- function(
                              iterative_refinement_max_iter = 10L,
                              iterative_refinement_stop_ratio = 5.0,
                              presolve_enable = TRUE,
+                             input_sparse_dropzeros = FALSE,
                              chordal_decomposition_enable = FALSE,
                              chordal_decomposition_merge_method = c('none', 'parent_child', 'clique_graph'),
                              chordal_decomposition_compact = FALSE,
@@ -263,6 +267,7 @@ clarabel_control <- function(
   ## Rust has strict type and length checks, so try to avoid panics
   bool_params <- c("verbose", "equilibrate_enable", "direct_kkt_solver", "static_regularization_enable",
                    "dynamic_regularization_enable", "iterative_refinement_enable", "presolve_enable",
+                   "input_sparse_dropzeros",
                    "chordal_decomposition_enable", "chordal_decomposition_compact",
                    "chordal_decomposition_complete_dual")
 

_pkgdown.yml

@@ -1,8 +1,15 @@
+template:
+  bootstrap: 5
+
 destination: docs
+
+url: https://oxfordcontrol.github.io/clarabel-r/
+
 authors:
   Balasubramanian Narasimhan:
     href: https://naras.su.domains/
   Paul Goulart:
     href: https://users.ox.ac.uk/~engs1373/
   Yuwen Chen:
+    href: https://yuwenchen95.github.io/
 

cleanup

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+rm -rf src/*.o src/*.so src/*.dll src/*.a src/rust/vendor src/rust/target

cran-comments.md

@@ -0,0 +1,4 @@
+## R CMD check results
+
+- Note `Size of tarball is: 5875906 bytes`: This is due to vendored Rust sources (size 5.5Mb)
+