Skip to content

Conversation

@arnavk23
Copy link
Contributor

@arnavk23 arnavk23 commented Dec 8, 2025

Reference Issues/PRs

Fixes #313 by double checking and adding comments in the private function docstring

What does this implement/fix? Explain your changes.

Add comprehensive documentation of censoring indicator conventions
used across lifelines, scikit-survival, and ngboost adapters.

Clarifies:

  • skpro convention: C=0 (uncensored), C=1 (censored)
  • lifelines: event_col=1 (uncensored), event_col=0 (censored)
  • scikit-survival: delta=True (uncensored), delta=False (censored)
  • ngboost: E=1 (uncensored), E=0 (censored)

All existing transformations are confirmed to be correct.
All external packages use the same opposite convention to skpro.

Does your contribution introduce a new dependency? If yes, which one?

What should a reviewer concentrate their feedback on?

Did you add any tests for the change?

Any other comments?

PR checklist

For all contributions
  • I've added myself to the list of contributors with any new badges I've earned :-)
    How to: add yourself to the all-contributors file in the skpro root directory (not the CONTRIBUTORS.md). Common badges: code - fixing a bug, or adding code logic. doc - writing or improving documentation or docstrings. bug - reporting or diagnosing a bug (get this plus code if you also fixed the bug in the PR).maintenance - CI, test framework, release.
    See here for full badge reference
  • The PR title starts with either [ENH], [MNT], [DOC], or [BUG]. [BUG] - bugfix, [MNT] - CI, test framework, [ENH] - adding or improving code, [DOC] - writing or improving documentation or docstrings.
For new estimators
  • I've added the estimator to the API reference - in docs/source/api_reference/taskname.rst, follow the pattern.
  • I've added one or more illustrative usage examples to the docstring, in a pydocstyle compliant Examples section.
  • If the estimator relies on a soft dependency, I've set the python_dependencies tag and ensured
    dependency isolation, see the estimator dependencies guide.

Add comprehensive documentation of censoring indicator conventions
used across lifelines, scikit-survival, and ngboost adapters.

Clarifies:
- skpro convention: C=0 (uncensored), C=1 (censored)
- lifelines: event_col=1 (uncensored), event_col=0 (censored)
- scikit-survival: delta=True (uncensored), delta=False (censored)
- ngboost: E=1 (uncensored), E=0 (censored)

All existing transformations are confirmed to be correct.
All external packages use the same opposite convention to skpro.
Add detailed comments and docstring updates to clarify the censoring
indicator conventions for issue sktime#313.

Changes:
- Add explicit transformation comments in lifelines adapter
- Add explicit transformation comments in scikit-survival adapter
- Add explicit transformation comments in ngboost adapter
- Update docstrings to document the convention conversions

All adapters correctly translate between:
- skpro: C=0 (uncensored), C=1 (censored)
- lifelines: event_col=1 (uncensored), event_col=0 (censored)
- scikit-survival: delta=True (uncensored), delta=False (censored)
- ngboost: E=1 (uncensored), E=0 (censored)
Add detailed summary documenting:
- Issue investigation and findings
- Verification of all three adapters (lifelines, scikit-survival, ngboost)
- Confirmation that all implementations are correct
- Documentation and code enhancements made
- Verification steps performed

All censoring indicator translations are correct and now well-documented
to prevent future confusion.
Copy link
Collaborator

@fkiraly fkiraly left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for checking!

There is no need to change the comments in the code though if they are complete and correct?

@fkiraly fkiraly added documentation Documentation & tutorials module:survival&time-to-event module for time-to-event prediction aka survival prediction labels Dec 11, 2025
@arnavk23 arnavk23 requested a review from fkiraly December 12, 2025 04:04
Copy link
Collaborator

@fkiraly fkiraly left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@fkiraly fkiraly merged commit 46825b6 into sktime:main Dec 12, 2025
35 checks passed
@arnavk23 arnavk23 deleted the fix/issue-313-censoring-indicator branch December 15, 2025 16:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation & tutorials module:survival&time-to-event module for time-to-event prediction aka survival prediction

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ENH] checking survival module: are translations of censoring indicator correct for interfaced packages?

2 participants