Skip to content

Document supported features - #11

Draft
smartalecH wants to merge 1 commit into
mainfrom
docs/supported-features
Draft

Document supported features#11
smartalecH wants to merge 1 commit into
mainfrom
docs/supported-features

Conversation

@smartalecH

Copy link
Copy Markdown
Collaborator

Closes #9.

Adds docs/features.md: a running list of what the Julia and Python packages each support, compiled by reading the current sources (src/julia/SSP/src/*.jl, the ChainRulesCore extension, and src/python/ssp_topopt/*.py) rather than from memory.

The page has three parts:

  • a feature table comparing Julia and Python, naming the actual exported functions;
  • known limitations that apply to both implementations;
  • a not yet supported list of gaps, so the page doubles as a roadmap.

Notable asymmetries it records:

  • Julia only: cubic-interpolation SSP1 (ssp1), dilation/erosion (dilation_distance), minimum-lengthscale constraints (constraint_solid / constraint_void), and the low-level init / solve! / adjoint_solve! API.
  • Python only: get_conic_radius_from_eta_e, a public tanh_projection, and periodic_axes in conic_filter.
  • Both: the subpixel fill factor is the 2D circular-kernel expression, so the projection assumes dx == dy. Julia's routines are written generically over dimension, but only 2D is covered by tests and examples, so the table says that rather than claiming 3D support.

Also links the new page from the top-level and Julia READMEs, and adds Julia installation instructions to the top-level README (it previously only covered pip).

@lxvm could you sanity-check the Julia column before this comes out of draft?

Adds a running Julia-vs-Python feature list, compiled from the current
sources, covering the filters, SSP1/SSP2 projections, dilation/erosion,
lengthscale constraints, AD support, and the low-level Julia API, plus
known limitations and gaps.

Also links the new page from the top-level and Julia READMEs and adds
Julia installation instructions to the top-level README.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document supported features in README

1 participant