Search

Search sub-package for MaRDMO.

Provides search functionality across mathematical models, algorithms, and interdisciplinary workflows stored in the MaRDI Portal:

• :mod:~MaRDMO.search.providers — RDMO option set providers for all searchable entity types (research fields, models, algorithms, software, hardware, methods, instruments, data sets, research problems, computational tasks, formulas, algorithmic tasks, quantities and quantity kinds).
• :mod:~MaRDMO.search.worker — Background worker that builds and executes SPARQL queries for the three search modes (workflow, model, algorithm) and returns matching portal items.
• :mod:~MaRDMO.search.sparql — Parameterised SPARQL query templates and filter fragments for all three search modes, assembled at runtime.

SPARQL

SPARQL query templates and filter fragments used by the MaRDMO portal search.

Each QUERY_BASE_* string is a parameterised SPARQL SELECT template that is assembled at runtime by inserting placeholder fragments (*_SPARQL). The placeholder strings bind Wikibase item/property QIDs at format-time via :meth:str.format.

Providers

RDMO optionset providers for the cross-catalog MaRDI search questionnaire.

Each provider queries the MaRDI Portal for a specific entity type and returns matching options for use in RDMO option sets. All providers require at least 3 characters, search MaRDI only, and do not offer user creation.

Workflow search providers: - :class:ResearchField — academic disciplines (also used in model search) - :class:MathematicalModel — mathematical models - :class:Algorithm — algorithms - :class:Software — software (also used in algorithm search) - :class:Hardware — computer hardware - :class:Method — methods - :class:Instrument — research tools / instruments - :class:DataSet — data sets

Model search providers: - :class:ResearchField — academic disciplines (also used in workflow search) - :class:ResearchProblem — research problems - :class:ComputationalTask — computational tasks - :class:Formula — mathematical expressions / formulas - :class:QuantityOrQuantityKind — quantities and quantity kinds

Algorithm search providers: - :class:AlgorithmicProblem — algorithmic tasks - :class:Software — software (also used in workflow search)

Algorithm

Bases: Provider

Algorithm Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class Algorithm(Provider):
    '''Algorithm Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['algorithm']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['algorithm']
        ],
        sources = ['mardi'],
        not_found = False
    )

AlgorithmicProblem

Bases: Provider

Algorithmic Problem Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class AlgorithmicProblem(Provider):
    '''Algorithmic Problem Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['algorithmic task']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['algorithmic task']
        ],
        sources = ['mardi'],
        not_found = False
    )

ComputationalTask

Bases: Provider

Computational Task Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class ComputationalTask(Provider):
    '''Computational Task Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['computational task']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['computational task']
        ],
        sources = ['mardi'],
        not_found = False
    )

DataSet

Bases: Provider

Data Set Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class DataSet(Provider):
    '''Data Set Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['data set']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['data set']
        ],
        sources = ['mardi'],
        not_found = False
    )

Formula

Bases: Provider

Formula Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class Formula(Provider):
    '''Formula Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['formula']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['formula']
        ],
        sources = ['mardi'],
        not_found = False
    )

Hardware

Bases: Provider

Hardware Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class Hardware(Provider):
    '''Hardware Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['computer hardware']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['computer hardware']
        ],
        sources = ['mardi'],
        not_found = False
    )

Instrument

Bases: Provider

Instrument Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class Instrument(Provider):
    '''Instrument Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['research tool']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['research tool']
        ],
        sources = ['mardi'],
        not_found = False
    )

MathematicalModel

Bases: Provider

Mathematical Model Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class MathematicalModel(Provider):
    '''Mathematical Model Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['mathematical model']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['mathematical model']
        ],
        sources = ['mardi'],
        not_found = False
    )

Method

Bases: Provider

Method Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class Method(Provider):
    '''Method Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['method']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['method']
        ],
        sources = ['mardi'],
        not_found = False
    )

QuantityOrQuantityKind

Bases: Provider

Quantity / Quantity Kind Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class QuantityOrQuantityKind(Provider):
    '''Quantity / Quantity Kind Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['quantity'],
                _ITEMS['kind of quantity'],
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['quantity'],
            _ITEMS['kind of quantity'],
        ],
        sources = ['mardi'],
        not_found = False
    )

ResearchField

Bases: Provider

Research Field Provider (MaRDI Portal / Wikidata), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class ResearchField(Provider):
    '''Research Field Provider (MaRDI Portal / Wikidata),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (used for user-entry lookups when applicable).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['academic discipline']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (used for user-entry lookups when applicable).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (used for user-entry lookups when applicable).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['academic discipline']
        ],
        sources = ['mardi'],
        not_found = False
    )

ResearchProblem

Bases: Provider

Research Problem Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class ResearchProblem(Provider):
    '''Research Problem Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['research problem']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['research problem']
        ],
        sources = ['mardi'],
        not_found = False
    )

Software

Bases: Provider

Software Provider (MaRDI Portal), No User Creation, Refresh Upon Selection

Source code in MaRDMO/search/providers.py

class Software(Provider):
    '''Software Provider (MaRDI Portal),
       No User Creation, Refresh Upon Selection
    '''

    search = True

    def get_options(self, project, search=None, user=None, site=None):
        '''Query external knowledge-graph source(s) and return matching options.

        Args:
            project: RDMO project instance (unused).
            search:  Search string entered by the user; returns empty list when
                     fewer than 3 characters.
            user:    Requesting user (unused).
            site:    Current site (unused).

        Returns:
            List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
        '''
        if not search or len(search) < 3:
            return []

        return query_sources(
            search = search,
            item_class = [
                _ITEMS['software']
            ],
            sources = ['mardi'],
            not_found = False
        )

get_options(project, search=None, user=None, site=None)

Query external knowledge-graph source(s) and return matching options.

Parameters:

Name	Type	Description	Default
project		RDMO project instance (unused).	required
search		Search string entered by the user; returns empty list when fewer than 3 characters.	None
user		Requesting user (unused).	None
site		Current site (unused).	None

Returns:

Type	Description
	List of {"id": …, "text": …} option dicts sorted by relevance.

Source code in MaRDMO/search/providers.py

def get_options(self, project, search=None, user=None, site=None):
    '''Query external knowledge-graph source(s) and return matching options.

    Args:
        project: RDMO project instance (unused).
        search:  Search string entered by the user; returns empty list when
                 fewer than 3 characters.
        user:    Requesting user (unused).
        site:    Current site (unused).

    Returns:
        List of ``{"id": …, "text": …}`` option dicts sorted by relevance.
    '''
    if not search or len(search) < 3:
        return []

    return query_sources(
        search = search,
        item_class = [
            _ITEMS['software']
        ],
        sources = ['mardi'],
        not_found = False
    )

Workers

Background worker for the cross-catalog MaRDI search questionnaire.

Dispatches on the selected search mode and builds a SPARQL query from the user-supplied filter criteria, executes it against the MaRDI Portal, and stores the results for the view layer to render.

Three search modes are supported:

• InterdisciplinaryWorkflow — filters: research objective, academic discipline, mathematical model, algorithm, software, hardware, method, instrument, data set.
• MathematicalModel — filters: model properties, research problem, academic discipline, computational task, formula, quantity.
• Algorithm — filters: algorithmic task, software.

Provides:

• search — entry point called by the view layer; mutates answers in place with "query", "no_results", and "links" keys.

search(answers, options)

Build SPARQL queries from user search criteria, execute them, and store results.

Dispatches on answers["search"]["options"] to one of three search modes: Interdisciplinary Workflow, Mathematical Model, or Algorithm. For each mode, constructs a SPARQL query from the selected filter criteria, executes it against the appropriate endpoint (MaRDI Portal or MathAlgoDB), and writes the escaped query string, result count, and link list back into answers.

Parameters:

Name	Type	Description	Default
answers		Top-level answers dict (mutated in place with "query", "no_results", and "links" keys).	required
options		Global RDMO options dict used for option-value comparisons.	required

Returns:

Type	Description
	The mutated answers dict.

Source code in MaRDMO/search/worker.py

def search(answers, options):
    '''Build SPARQL queries from user search criteria, execute them, and store results.

    Dispatches on ``answers["search"]["options"]`` to one of three search
    modes: Interdisciplinary Workflow, Mathematical Model, or Algorithm.
    For each mode, constructs a SPARQL query from the selected filter criteria,
    executes it against the appropriate endpoint (MaRDI Portal or MathAlgoDB),
    and writes the escaped query string, result count, and link list back into
    *answers*.

    Args:
        answers: Top-level answers dict (mutated in place with ``"query"``,
                 ``"no_results"``, and ``"links"`` keys).
        options: Global RDMO options dict used for option-value comparisons.

    Returns:
        The mutated *answers* dict.
    '''
    if answers['search'].get('options') == options['InterdisciplinaryWorkflow']:

        s = answers['search']
        items = get_items()
        props = get_properties()

        filter_keys = [
            'research-objective', 'academic-discipline', 'mathematical-model',
            'algorithm', 'software', 'hardware', 'method', 'instrument', 'data-set',
        ]
        if not any(s.get(k) for k in filter_keys):
            answers['query'] = 'Workflow search requested but no parameters defined.'
            answers['no_results'] = '0'
            answers['links'] = []
            return answers

        parts = []

        for idx, keyword in enumerate(s.get('research-objective', {}).values()):
            if keyword:
                parts.append(
                    f"  # research objective: {keyword}\n"
                    + WF_RESEARCH_OBJ_SPARQL.format(
                        idx=idx, keyword=keyword.lower(), **items, **props
                    )
                )

        for idx, item in enumerate(s.get('academic-discipline', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # academic discipline: {item['Name']}\n"
                + WF_DISCIPLINE_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('mathematical-model', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # mathematical model: {item['Name']}\n"
                + WF_MODEL_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('algorithm', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # algorithm: {item['Name']}\n"
                + WF_ALGORITHM_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('software', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # software: {item['Name']}\n"
                + WF_SOFTWARE_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('hardware', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # hardware: {item['Name']}\n"
                + WF_HARDWARE_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('method', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # method: {item['Name']}\n"
                + WF_METHOD_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('instrument', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # instrument: {item['Name']}\n"
                + WF_INSTRUMENT_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('data-set', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # data set: {item['Name']}\n"
                + WF_DATASET_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        query = "\n".join(
            line
            for line in QUERY_BASE_WORKFLOW_SEARCH.format(
                "\n".join(parts),
                **items,
                **props,
            ).splitlines()
            if line.strip()
        )

        answers['query'] = html.escape(query).replace('\n', '<br>')

        results = query_sparql(query, get_url('mardi', 'sparql'))
        answers['no_results'] = str(len(results))

        links = []
        for result in results:
            links.append([
                result["label"]["value"],
                f"{get_item_url('mardi')}{result['qid']['value']}",
            ])
        answers['links'] = links

    elif answers['search'].get('options') == options['MathematicalModel']:

        s = answers['search']
        items = get_items()
        props = get_properties()

        filter_keys = [
            'mathematical-model-properties', 'research-problem',
            'academic-discipline', 'computational-task', 'formula', 'quantity',
        ]
        if not any(s.get(k) for k in filter_keys):
            answers['query'] = 'Model search requested but no parameters defined.'
            answers['no_results'] = '0'
            answers['links'] = []
            return answers

        parts = []

        for option_uri in s.get('mathematical-model-properties', {}).values():
            uri_tail = option_uri.rsplit('/', 1)[-1]
            item_key = MM_PROPERTY_TO_ITEM.get(uri_tail)
            if item_key:
                label = uri_tail.replace('-', ' ')
                parts.append(
                    f"  # model property: {label}\n"
                    + MM_PROPERTY_SPARQL.format(
                        qid=items[item_key], **items, **props
                    )
                )

        for idx, item in enumerate(s.get('research-problem', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # research problem: {item['Name']}\n"
                + MM_PROBLEM_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('academic-discipline', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # academic discipline: {item['Name']}\n"
                + MM_DISCIPLINE_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('computational-task', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # computational task: {item['Name']}\n"
                + MM_TASK_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('formula', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # formula: {item['Name']}\n"
                + MM_FORMULA_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('quantity', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # quantity: {item['Name']}\n"
                + MM_QUANTITY_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        query = "\n".join(
            line
            for line in QUERY_BASE_MODEL_SEARCH.format(
                "\n".join(parts),
                **items,
                **props,
            ).splitlines()
            if line.strip()
        )

        answers['query'] = html.escape(query).replace('\n', '<br>')

        results = query_sparql(query, get_url('mardi', 'sparql'))
        answers['no_results'] = str(len(results))

        links = []
        for result in results:
            links.append([
                result["label"]["value"],
                f"{get_item_url('mardi')}{result['qid']['value']}",
            ])
        answers['links'] = links

    elif answers['search'].get('options') == options['Algorithm']:

        s = answers['search']
        items = get_items()
        props = get_properties()

        filter_keys = ['algorithmic-task', 'software']
        if not any(s.get(k) for k in filter_keys):
            answers['query'] = (
                'Algorithm search requested but no parameters defined.'
            )
            answers['no_results'] = '0'
            answers['links'] = []
            return answers

        parts = []

        for idx, item in enumerate(s.get('algorithmic-task', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # algorithmic task: {item['Name']}\n"
                + ALG_TASK_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        for idx, item in enumerate(s.get('software', {}).values()):
            qid = item['ID'].split(':')[1]
            parts.append(
                f"  # software: {item['Name']}\n"
                + ALG_SOFTWARE_SPARQL.format(idx=idx, qid=qid, **items, **props)
            )

        query = "\n".join(
            line
            for line in QUERY_BASE_ALGORITHM_SEARCH.format(
                "\n".join(parts),
                **items,
                **props,
            ).splitlines()
            if line.strip()
        )

        answers['query'] = html.escape(query).replace('\n', '<br>')

        results = query_sparql(query, get_url('mardi', 'sparql'))
        answers['no_results'] = str(len(results))

        links = []
        for result in results:
            links.append([
                result["label"]["value"],
                f"{get_item_url('mardi')}{result['qid']['value']}",
            ])
        answers['links'] = links

    return answers