annotate omero_roi_import.xml @ 5:55e3d33cf4bd draft default tip

planemo upload for repository https://github.com/Helmholtz-UFZ/galaxy-tools/tree/main/tools/omero commit 636cbb62d59819caca5bc9eab0a8ec31be5bdd46

<tool id="omero_roi_import" name="OMERO ROI Import" version="@TOOL_VERSION@+galaxy@VERSION_SUFFIX@" profile="@PROFILE@" license="MIT">
    <description> with ezomero </description>
    <macros>
        <import>macros.xml</import>
        <token name="@VERSION_SUFFIX@">4</token>
    </macros>
    <xrefs>
        <xref type="bio.tools">omero</xref>
    </xrefs>
    <expand macro="ezomero_requirements"/>
    <command detect_errors="exit_code"><![CDATA[
        python '$__tool_directory__/omero_roi_upload.py'
        --input_file '$input'
        --image_id $id
        --credential-file '$credentials'
        @HOST_PORT@
        --log_file '$log'
    ]]></command>
    <configfiles>
        <expand macro="credentials"/>
    </configfiles>
    <inputs>
        <expand macro="host_port"/>
        <param argument="input" type="data" format="tabular" optional="false" label="Tab File with ROIs" help="Select ROIs Tabular file"/>
        <param argument="id" type="integer" value="" optional="false" min = "1" label="Image ID where annotate the ROIs"/>
    </inputs>
    <outputs>
        <data name="log" format="txt"/>
    </outputs>
    <tests>
        <test>
            <param name="omero_host" value="host.docker.internal"/>
            <param name="omero_port" value="6064"/>
            <param name="id" value="1"/>
            <param name="input" value="input_roi.tsv"/>
            <param name="test_username" value="root"/>
            <param name="test_password" value="omero"/>
            <output name="log" value="output_table_roi.txt" ftype="txt">
                <assert_contents>
                    <has_text text="ROI ID: 7 for row 7"/>
                </assert_contents>
            </output>
        </test>
        <test>
            <param name="omero_host" value="host.docker.internal"/>
            <param name="omero_port" value="6064"/>
            <param name="id" value="1"/>
            <param name="input" value="input_roi_minimal.tsv"/>
            <param name="test_username" value="root"/>
            <param name="test_password" value="omero"/>
            <output name="log" value="output_table_roi_minimal.txt" ftype="txt">
                <assert_contents>
                    <has_text text="ROI ID: 8 for row 1"/>
                </assert_contents>
            </output>
        </test>
    </tests>
    <help>

Description
-----------

Tool to upload Regions of Interest (ROIs) to an OMERO server based on shape data provided
in a tabular format (TSV file). The tool reads the shape information from the TSV file, creates the
corresponding ROIs in OMERO, and links them to a specified image.

**Column Headers** (not all columns are required for all shapes):

        - shape, x, y, x_rad, y_rad, width, height, label, fontSize, x1, y1, x2, y2, points, fill_color, stroke_color, stroke_width, z, c, t, roi_name, roi_description

- *Shape Type*:

    The **shape** column indicates the type of shape being defined, such as Ellipse, Label, Line, Point, Polygon, Polyline, or Rectangle.

- *Position and Dimensions*:

    The columns **x**, **y**, **x_rad**, **y_rad**, **width**, and **height** specify the position and dimensions of the shapes, where applicable. For example, Ellipse uses x, y, x_rad, and y_rad, while Rectangle uses x, y, width, and height.

- *Label*:

    Any ROI can be labelled using the column **label**, this label will appear on the OMERO web interface.

- *Text Labels*:

    The **label** and **fontSize** columns are used for the Label shape, specifying the text content and font size.

- *Line Coordinates*:

    The columns **x1**, **y1**, **x2**, and **y2** are used for defining the start and end points of a Line.

- *Point Coordinates*:

    The **points** column is used for defining multiple points in shapes like Polygon and Polyline. The points are listed as coordinate pairs, like '(300,300),(350,350),(300,400)'

- *Colors*:

    The **fill_color** and **stroke_color** columns define the fill and stroke colors of the shapes in RGBA format, like '(0,255,255,128)'.

- *Stroke Width*:

    The **stroke_width** column specifies the width of the stroke or border around the shapes.

- *Z, C, T Coordinates*:

    The **z**, **c**, and **t** columns indicate the Z-plane, channel, and time point to which the shape is associated in the image stack.

- *ROI Identification*:

    The **roi_name** and **roi_description** columns provide a name and description for each ROI, allowing for easy identification and documentation within OMERO however they do not appear on the OMERO web interface.

@SECURITY_DISCLAIMER@
    </help>
    <citations>
        <citation type="doi">10.1038/nmeth.1896</citation>
    </citations>
</tool>