cuProj Python and C++ Documentation (#1237)

Adds doxygen configuration for libcuproj, and Python documentation.

Depends on #1217 
Fixes #1239

Authors:
  - Mark Harris (https://github.com/harrism)
  - Michael Wang (https://github.com/isVoid)
  - AJ Schmidt (https://github.com/ajschmidt8)

Approvers:
  - Ben Jarmak (https://github.com/jarmak-nv)
  - H. Thomson Comer (https://github.com/thomcom)
  - Paul Taylor (https://github.com/trxcllnt)
  - Michael Wang (https://github.com/isVoid)
  - Ray Douglass (https://github.com/raydouglass)

URL: #1237

ci/build_docs.sh

@@ -24,19 +24,27 @@ rapids-mamba-retry install \
   --channel "${CPP_CHANNEL}" \
   --channel "${PYTHON_CHANNEL}" \
   libcuspatial \
-  cuspatial
+  cuspatial \
+  cuproj
 
 export RAPIDS_VERSION_NUMBER="23.08"
 export RAPIDS_DOCS_DIR="$(mktemp -d)"
 
-rapids-logger "Build CPP docs"
+rapids-logger "Build cuSpatial CPP docs"
 pushd cpp/doxygen
 doxygen Doxyfile
 mkdir -p "${RAPIDS_DOCS_DIR}/libcuspatial/html"
 mv html/* "${RAPIDS_DOCS_DIR}/libcuspatial/html"
 popd
 
-rapids-logger "Build Python docs"
+rapids-logger "Build cuProj CPP docs"
+pushd cpp/cuproj/doxygen
+doxygen Doxyfile
+mkdir -p "${RAPIDS_DOCS_DIR}/libcuproj/html"
+mv html/* "${RAPIDS_DOCS_DIR}/libcuproj/html"
+popd
+
+rapids-logger "Build cuSpatial Python docs"
 pushd docs
 sphinx-build -b dirhtml source _html -W
 sphinx-build -b text source _text -W
@@ -45,4 +53,13 @@ mv _html/* "${RAPIDS_DOCS_DIR}/cuspatial/html"
 mv _text/* "${RAPIDS_DOCS_DIR}/cuspatial/txt"
 popd
 
+rapids-logger "Build cuProj Python docs"
+pushd docs/cuproj
+sphinx-build -b dirhtml source _html -W
+sphinx-build -b text source _text -W
+mkdir -p "${RAPIDS_DOCS_DIR}/cuproj/"{html,txt}
+mv _html/* "${RAPIDS_DOCS_DIR}/cuproj/html"
+mv _text/* "${RAPIDS_DOCS_DIR}/cuproj/txt"
+popd
+
 rapids-upload-docs

ci/release/update-version.sh

@@ -34,10 +34,13 @@ sed_runner 's/'"CUSPATIAL VERSION .* LANGUAGES"'/'"CUSPATIAL VERSION ${NEXT_FULL
 sed_runner 's/'"CUPROJ VERSION .* LANGUAGES"'/'"CUPROJ VERSION ${NEXT_FULL_TAG} LANGUAGES"'/g' cpp/cuproj/CMakeLists.txt
 sed_runner 's/'"cuspatial_version .*)"'/'"cuspatial_version ${NEXT_FULL_TAG})"'/g' python/cuspatial/CMakeLists.txt
 sed_runner 's/'"cuproj_version .*)"'/'"cuproj_version ${NEXT_FULL_TAG})"'/g' python/cuproj/CMakeLists.txt
+sed_runner 's/'"cuproj_version .*)"'/'"cuproj_version ${NEXT_FULL_TAG})"'/g' python/cuproj/cuproj/cuprojshim/CMakeLists.txt
 
 # RTD update
 sed_runner 's/version = .*/version = '"'${NEXT_SHORT_TAG}'"'/g' docs/source/conf.py
 sed_runner 's/release = .*/release = '"'${NEXT_FULL_TAG}'"'/g' docs/source/conf.py
+sed_runner 's/version = .*/version = '"'${NEXT_SHORT_TAG}'"'/g' docs/cuproj/source/conf.py
+sed_runner 's/release = .*/release = '"'${NEXT_FULL_TAG}'"'/g' docs/cuproj/source/conf.py
 
 # Python __init__.py updates
 sed_runner "s/__version__ = .*/__version__ = \"${NEXT_FULL_TAG}\"/g" python/cuspatial/cuspatial/__init__.py
@@ -46,10 +49,14 @@ sed_runner "s/__version__ = .*/__version__ = \"${NEXT_FULL_TAG}\"/g" python/cupr
 # rapids-cmake version
 sed_runner 's/'"branch-.*\/RAPIDS.cmake"'/'"branch-${NEXT_SHORT_TAG}\/RAPIDS.cmake"'/g' fetch_rapids.cmake
 
-# Doxyfile update
+# Doxyfile update - cuspatial
 sed_runner "/PROJECT_NUMBER[ ]*=/ s|=.*|= ${NEXT_FULL_TAG}|g" cpp/doxygen/Doxyfile
 sed_runner "/TAGFILES/ s|[0-9]\+.[0-9]\+|${NEXT_SHORT_TAG}|g" cpp/doxygen/Doxyfile
 
+#Doxyfile update - cuproj
+sed_runner "/PROJECT_NUMBER[ ]*=/ s|=.*|= ${NEXT_FULL_TAG}|g" cpp/cuproj/doxygen/Doxyfile
+sed_runner "/TAGFILES/ s|[0-9]\+.[0-9]\+|${NEXT_SHORT_TAG}|g" cpp/cuproj/doxygen/Doxyfile
+
 # CI files
 for FILE in .github/workflows/*.yaml; do
   sed_runner "/shared-action-workflows/ s/@.*/@branch-${NEXT_SHORT_TAG}/g" "${FILE}"
@@ -66,6 +73,8 @@ DEPENDENCIES=(
   libcudf
   librmm
   rmm
+  cuspatial
+  cuproj
 )
 
 for DEP in "${DEPENDENCIES[@]}"; do
@@ -82,3 +91,18 @@ sed_runner "s/^version = .*/version = \"${NEXT_FULL_TAG_PEP440}\"/g" python/cupr
 
 # Dependency versions in dependencies.yaml
 sed_runner "/-cu[0-9]\{2\}==/ s/==.*/==${NEXT_SHORT_TAG_PEP440}.*/g" dependencies.yaml
+
+# Version in cuspatial_api_examples.ipynb
+sed_runner "s/rapids-[0-9]*\.[0-9]*/rapids-${NEXT_SHORT_TAG}/g" docs/source/user_guide/cuspatial_api_examples.ipynb
+sed_runner "s/cuproj=[0-9]*\.[0-9]*/cuproj=${NEXT_SHORT_TAG}/g" docs/source/user_guide/cuspatial_api_examples.ipynb
+sed_runner "s/cuspatial=[0-9]*\.[0-9]*/cuspatial=${NEXT_SHORT_TAG}/g" docs/source/user_guide/cuspatial_api_examples.ipynb
+# Version in cuproj_api_examples.ipynb
+sed_runner "s/rapids-[0-9]*\.[0-9]*/rapids-${NEXT_SHORT_TAG}/g" docs/cuproj/source/user_guide/cuproj_api_examples.ipynb
+sed_runner "s/cuproj=[0-9]*\.[0-9]*/cuproj-${NEXT_SHORT_TAG}/g" docs/cuproj/source/user_guide/cuproj_api_examples.ipynb
+sed_runner "s/cuspatial=[0-9]*\.[0-9]*/cuspatial=${NEXT_SHORT_TAG}/g" docs/cuproj/source/user_guide/cuproj_api_examples.ipynb
+
+# Versions in README.md
+sed_runner "s/cuspatial:[0-9]\+.[0-9]/cuspatial:${NEXT_SHORT_TAG}/g" README.md
+sed_runner "s/cuspatial=[0-9]\+.[0-9]/cuspatial=${NEXT_SHORT_TAG}/g" README.md
+sed_runner "s/notebooks:[0-9]\+.[0-9]/notebooks:${NEXT_SHORT_TAG}/g" README.md
+

cpp/cuproj/benchmarks/wgs_to_utm_bench.cu

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-#include <cuproj/projection_factories.hpp>
+#include <cuproj/projection_factories.cuh>
 #include <cuspatial/geometry/vec_2d.hpp>
 
 #include <cuproj_test/convert_coordinates.hpp>
@@ -64,11 +64,11 @@ static void cuproj_wgs_to_utm_benchmark(benchmark::State& state)
 
   for (auto _ : state) {
     cuda_event_timer raii(state, true);
-    proj.transform(input.begin(),
-                   input.end(),
-                   output.begin(),
-                   cuproj::direction::FORWARD,
-                   rmm::cuda_stream_default);
+    proj->transform(input.begin(),
+                    input.end(),
+                    output.begin(),
+                    cuproj::direction::FORWARD,
+                    rmm::cuda_stream_default);
   }
 
   state.SetItemsProcessed(num_points * state.iterations());