HTML browsing and curation (indra.assemblers.html.assembler)

Format a set of INDRA Statements into an HTML-formatted report which also supports curation.

class indra.assemblers.html.assembler.HtmlAssembler(statements=None, summary_metadata=None, ev_totals=None, title='INDRA Results', db_rest_url=None)[source]

Generates an HTML-formatted report from INDRA Statements.

The HTML report format includes statements formatted in English (by the EnglishAssembler), text and metadata for the Evidence object associated with each Statement, and a Javascript-based curation interface linked to the INDRA database (access permitting). The interface allows for curation of statements at the evidence level by letting the user specify type of error and (optionally) provide a short description of of the error.

Parameters:
  • statements (Optional[list[indra.statements.Statement]]) – A list of INDRA Statements to be added to the assembler. Statements can also be added using the add_statements method after the assembler has been instantiated.
  • summary_metadata (Optional[dict]) – Dictionary of statement corpus metadata such as that provided by the INDRA REST API. Default is None. Each value should be a concise summary of O(1), not of order the length of the list, such as the evidence totals. The keys should be informative human-readable strings.
  • ev_totals (Optional[dict]) – A dictionary of the total evidence available for each statement indexed by hash. Default: None
  • db_rest_url (Optional[str]) – The URL to a DB REST API to use for links out to further evidence. If given, this URL will be prepended to links that load additional evidence for a given Statement. One way to obtain this value is from the configuration entry indra.config.get_config(‘INDRA_DB_REST_URL’). If None, the URLs are constructed as relative links. Default: None
statements

list[indra.statements.Statement] – A list of INDRA Statements to assemble.

model

str – The HTML report formatted as a single string.

metadata

dict – Dictionary of statement list metadata such as that provided by the INDRA REST API.

ev_totals

dict – A dictionary of the total evidence available for each statement indexed by hash.

db_rest_url

str – The URL to a DB REST API.

add_statements(statements)[source]

Add a list of Statements to the assembler.

Parameters:statements (list[indra.statements.Statement]) – A list of INDRA Statements to be added to the assembler.
append_warning(msg)[source]

Append a warning message to the model to expose issues.

make_model()[source]

Return the assembled HTML content as a string.

Returns:The assembled HTML as a string.
Return type:str
save_model(fname)[source]

Save the assembled HTML into a file.

Parameters:fname (str) – The path to the file to save the HTML into.
indra.assemblers.html.assembler.tag_text(text, tag_info_list)[source]

Apply start/end tags to spans of the given text.

Parameters:
  • text (str) – Text to be tagged
  • tag_info_list (list of tuples) – Each tuple refers to a span of the given text. Fields are (start_ix, end_ix, substring, start_tag, close_tag), where substring, start_tag, and close_tag are strings. If any of the given spans of text overlap, the longest span is used.
Returns:

String where the specified substrings have been surrounded by the given start and close tags.

Return type:

str