CoLRev

Manual

  • Steps and operations
  • Workflow
  • Step 1: Problem formulation
  • Step 2: Metadata retrieval
  • Step 3: Metadata prescreen
  • Step 4: PDF retrieval
  • Step 5: PDF screen
  • Step 6: Data extraction and synthesis
  • Command-line Interface
  • Collaboration
  • Packages
  • Appendix

Developer documentation

  • Setup
  • Package development
  • Development status
  • API reference
  • Github repository
  • PyPI

Governance

  • CoLRev enhancement proposals (CEPs)
  • About
CoLRev
  • colrev.ops.search.Search
  • Edit on GitHub

colrev.ops.search.Search¶

class colrev.ops.search.Search(*, review_manager, notify_state_transition_operation=True)[source]¶

Bases: Operation

Search for new records

Methods

add_most_likely_sources

Get the most likely SearchSources

add_source_and_search

Add a SearchSource and run the search

check_precondition

Check the operation precondition

conclude

Conclude the operation (stop Docker containers)

decorate

Decorator for operations

get_new_search_files

Retrieve new search files (not yet registered in settings)

get_new_source_heuristic

Get the heuristic result list of SearchSources candidates

main

rtype:

Callable

notify

Notify the review_manager about the next operation

Attributes

type

add_most_likely_sources()[source]¶

Get the most likely SearchSources

returns a dictionary: {“filepath”: [SearchSource1,..]}

Return type:

None

add_source_and_search(search_file)[source]¶

Add a SearchSource and run the search

Return type:

None

check_precondition()¶

Check the operation precondition

Return type:

None

conclude()¶

Conclude the operation (stop Docker containers)

Return type:

None

classmethod decorate()¶

Decorator for operations

Return type:

Callable

get_new_search_files()[source]¶

Retrieve new search files (not yet registered in settings)

Return type:

list[Path]

get_new_source_heuristic(filename)[source]¶

Get the heuristic result list of SearchSources candidates

returns a dictionary: {“filepath”: ({“search_source”: SourceCandidate1”, “confidence”: 0.98},..]}

Return type:

list

notify(*, state_transition=True)¶

Notify the review_manager about the next operation

Return type:

None


© Copyright 2025, Gerit Wagner and Julian Prester.

Built with Sphinx using a theme provided by Read the Docs.