Manual Instruction

Canonical plane visualization

The interface for the canonical plane visualization service is illustrated below. The central area is the main window, used to display STAM's canonical planes () and the brain region annotations on these planes (). Users can use the left mouse button and scroll wheel in the main window to move, and zoom in to the resolution of the region of interest. When the user hovers the mouse over an annotation for a brain region or nucleus, the annotation switches to a blue highlighted mode (), and the full name of the highlighted brain region or nucleus is displayed in the lower-left corner ().\nThe light gray grid behind the canonical plane and annotations shows the distribution of the STAM coordinate system on the current plane (). As the user moves the mouse, the real-time position of the mouse in the STAM coordinate system is displayed in the lower-left corner of the main window (). Users can also observe the position of the current viewed canonical plane in the entire mouse brain through the navigation window in the upper left corner (), as well as drag the slide inside the navigation window in the upper left corner to jump to other canonical planes of interest.\nUsers can freely switch to other sections using the right-side image gallery (), or switch between different anatomical directions, such as coronal, sagittal, and horizontal planes (). Additionally, users can search for brain regions or nuclei of interest in the input box () or navigate through the anatomical ontology tree (). If the current viewed profile does not include the searched structure, it will jump to the nearest profile in the same direction that contains the structure.\nAt the bottom of the main window is the button panel for the canonical plane visualization service (). The button functions, from left to right, include: zoom out, zoom in, reset view, full screen, switch to three-dimensional visualization service, switch to arbitrary angle cross-section visualization service, display mode switch, and jump to other profiles in the current anatomical direction. To input the numerical designation of a coronal plane into the text input box in the button group, then click the adjacent “Go” button to jump to the corresponding plane. The viewing perspective, i.e., the current zoom level and position, will be preserved when switching between planes.\nFurthermore, we could traverse from canonical plane visualization service to stereotaxic topography visualization service: On the canonical plane visualization service page, users can highlight a brain region or nucleus of interest, then click the 3D button in the button panel at the bottom of the page, or right-click and choose to jump to the stereotaxic topography visualization service page from the pop-up menu. The brain region or nucleus highlighted in the canonical plane visualization page will also display its three-dimensional model in the stereotaxic topography visualization page.

Stereotaxic topography visualization

Operating Instructions The stereotactic topography service interface is shown in the figure. The central area is the main window. The three arrows labeled by ① indicate the semi-transparent outline of the mouse brain, a three-dimensional coordinate system displayed in numerical grid, and the cranial and intracranial datum marks shown as red dots. The primary purpose of this information is to provide users with intuitive and diverse forms of spatial localization information, all of which are displayed by default upon entering the service interface. On the left of the main window is the data panel ②, which contains three tabs. The "Regions" tab includes the anatomical nomenclature tree of STAM, where users can select any number of structures of interest via checkboxes. The "Vessels" tab contains a complete cerebral vascular atlas registered to the STAM, allowing users to select vascular branches of interest. The "Neurons" tab is used to query and filter neuron morphological data with somas or projection targets located in regions of interest. Data selected or filtered in these three tabs will be displayed in the main window. As shown by the three arrows labeled ③, the orange represents the three-dimensional topography of the brain regions of interest selected in the "Regions" tab ④, the blue represents the three-dimensional morphology of the vascular branches of interest selected in the "Vessels" tab, and the green represents the individual neuron morphological data filtered in the "Neurons" tab. In the anatomical nomenclature tree under the "Regions" tab, a blue square icon could be found at the right side of any brain region or nucleus that consists of substructures. As shown in ⑤, when users click on this icon next to the structure of interest, the original blue square changes to an icon composed of three expanded surfaces. At this point, all substructures of the clicked structure will be visualized in an assembled form in the main window, as indicated by the golden three-dimensional models in ⑥. When the Assembling tab be selected, all substructures will expand from their original positions, and the expansion magnitude can be set in the right panel ⑦. When three-dimensional models of brain regions or nuclei have been loaded in the main window, users can move the mouse over any model of interest, causing its color to change to red, as shown by ⑧. At this time, detailed information about the structure, including its full name, abbreviation, and three-dimensional size, will appear in the lower left corner of the main window, as shown by ⑨.

In order to accommodate the preferences of different users, the data panel on the left provides two anatomical nomenclature systems: Allen Reference Atlas (ARA) ontology and Brain maps 4.0 ontology(). The former one is the default ontology of STAM. Users can also switch to Brain maps 4.0 ontology, the structures of which could also be searched, selected and visualized.\nFurthermore, if users would like to modify the default display options provided by STAM, they can switch to the \"View setting\" tab on the right, which contains four toggle options (). The \"Left hemisphere\" switch determines whether the left hemisphere is displayed in the main window, and it is off by default. When this option is set to \"On,\" any anatomical structure will be displayed in both hemispheres simultaneously, as shown by (). The \"Coordinate\" switch determines whether coordinate values are displayed in the main window, and it is on by default. When set to \"Off,\" only the grid is displayed in the main window, as shown by (). The \"Datum Marks\" switch determines whether datum marks are displayed in the main window, and it is on by default. When set to \"Off,\" the 20 datum marks marked by red spheres will no longer be displayed in the main window. The \"Cranial\" switch determines whether the three-dimensional contour of the skull is displayed in the main window, and it is off by default. When set to \"On,\" a light yellow skull model appears in the main window, which includes only the partial area located directly above the mouse brain, not the complete skull, as shown by ().\nLastly, the coordinate system is shared across all STAM services, including the stereotaxic topography visualization service. By default, this coordinate system uses the Bregma point as the origin. Users can also switch the coordinate origin to any of the other 19 cranial or intracranial datum marks provided by STAM, and the coordinates of the objects visualized in the main window will be recalculated based on the new origin.

Arbitrary plane visualization

The interface for the Arbitrary plane visualization is illustrated as followed. The left side features the navigation window, while the right side is the main window. The main window displays the arbitrary angle slice of STAM () and the brain region annotations on that slice (). Users can pan in the main window by holding down the left mouse button, zoom in using Ctrl + scroll wheel, or switch to different neighboring slices along the current angle by using the scroll wheel. On the right side of the main window is the list of brain regions and nuclei (). When the user moves the mouse over the name of a structure of interest, the annotation for that structure in the main window is highlighted in light gray (). Users can also move the mouse over the annotation of a structure of interest in the main window, and the name of that structure in the list of brain regions and nuclei on the right will automatically be highlighted. At this time, the name of the structure will also be displayed in the lower-left corner of the main window (). Below the structure name is the scale bar of the slice image in the main window at the current resolution (). In the navigation window on the left side, the central area displays the three-dimensional model of the right half of the mouse brain (). The black plane corresponds to the position and angle of the slice in the main window (). The red, green, and blue circles around the model are used to change the pitching, rotation, and rolling angles of the cross-section (). Users can also input values in the lower-left corner of the navigation window to set the slice angle (). The red, green, and blue arrows in the navigation window are used to determine the position of the slice along the given arbitrary angle in the three-dimensional space ().

Automatic slice registration

Operating Instructions The interface for the brain slice automatic registration service is shown in the figure below. Locate the "Upload Slice" button group ① on the right side, and click the "Upload tiff" button to upload the 2D brain slice image in tif/tiff format for registration from your local device. The uploaded image must be a mouse brain slice sampled at a resolution of 10 micrometers; slices with a resolution of 1 micrometer cannot be processed due to their large size. Once the upload is completed, select the type of the uploaded image in the "Choose the type of uploaded slice" radio button ②. Currently, only PI, DAPI, and Label images are supported. Next, click the "Start" button in the "Calculate the corresponding plane from the atlas" button group ③ and wait for the result from the server. During the calculation process, the "Start" button will be disabled, so please be patient.

Once the calculation is complete, the "Start" button will become available again. At this point, a preview image of the calculation result will appear below the "Start" button ④, which can be enlarged by left-clicking. The "Save" button ⑤ to the right of the "Start" button will also become clickable. By clicking this "Save" button, users can download the calculation result to their local device. Additionally, users can click the "View result" button ⑥ below the preview image to display the calculation result in the main window, as shown in ⑦.

Data sharing

Operating Instructions The data sharing service interface is shown in the figure below. The right panel contains a "Select the range" button ①:

After clicking “Select the range” button, an orange-lined box ② will appear in the main window, representing the spatial range of the data to be downloaded. The top-left and bottom-right corners of the box display two sets of coordinates, indicating the range of the selected box in the current coordinate system. As shown by ③, users can control the box's translation along the X (M-L), Y (D-V), and Z (A-P) axes by left-clicking and dragging the red, green, and blue arrows, respectively. When an arrow is selected, it will be highlighted as bright yellow. Additionally, as indicated by ④, users can switch from translation mode to scaling mode by pressing the "A" key on the keyboard. In this mode, the arrows will change to squares, as shown by ⑤, and dragging these squares will resize the box. Once the spatial range for the data to be downloaded is determined, users can click the "preview selected data" button ⑥. This will visualize the images within the selected range in the main window using volume rendering, as shown by ⑦.

By dragging the "Set the downsampling rate" slider, users can select the sampling rate for the data to be downloaded. The specific sampling rate value can be seen in the black-backgrounded tip above the slider. As shown by ⑧, the currently selected download data is downsampled by a factor of 8, resulting in an uncompressed data size of 27.67 MB, as indicated by ⑨. If the data size does not exceed 1 GB, clicking the "Downloading" button ⑩ will directly download the data. If the data size exceeds this limit, clicking the "Downloading" button will invoke the user's email client (such as Outlook) and automatically fill in the email body with the selected download range and sampling rate information. By clicking the send button, users can submit a data download request to the STAM website.

Atlas mapping

Operating Instructions As shown in the figure, users can click the "Upload" button ① in the right panel to upload 3D image data or neuronal morphology data that has been previously registered to either the CCF or STAM. The image format must be TIFF, and the neuronal morphology data format must be SWC, with a spatial resolution of 10 micrometers. After the uploading is completed, there would be an empty image on the left side of the "Upload" button. Select the direction of conversion (either from STAM to CCF or vice versa) in the "Select the direction of conversion" radio button ③. Then, click the "Start" button ④ to start the calculation on the STAM server. At this point, the "Start" button enters the waiting status ⑤.

After waiting for about 10 minutes, the STAM server finishes the calculation and returns the results. At this point, both the "Save" button and the "View result" button become clickable ⑥. Clicking the "Save" button allows you to download the results to your local device; clicking the "View result" button lets you preview the calculation results in the main window ⑦.

Virtual surgery

Operating Instructions The virtual surgery service is shown in the figure below. At this point, the main window is in Virtual surgery mode ①, and only the Virtual surgery and View setting tabs are available on the right side of the page. The former is used for guiding virtual surgery, while the latter is used to set the display options of the main window. Note that switching to the View setting tab midway through virtual surgery will restart the entire virtual surgery process. Therefore, it's important to finalize all options in the View setting tab before entering the Virtual surgery tab. Firstly, select the brain region for injection. Upon entering Virtual surgery mode, the mouse pointer changes to a virtual injection needle model, as shown by ②, and the “Regions” tab on the left data panel transforms into the “Structure for injecting” tab. Here, users need to choose a brain region for injection. Once selected, the "Select target" button ④ highlighted in the figure becomes clickable.

Next, select the injection target on the chosen brain region. At this point, the user has already selected a brain region for injection on the left data panel ⑤, and its 3D model ⑥ is visualized in the main window. Continuing to click the "Select target" button, a green dot ⑦ follows the mouse cursor on the surface of the brain region's 3D model. The position of this dot is projected onto the coordinate grid of the 3D space and marked with a green crosshair ⑧. The coordinates of this point in all three directions can also be viewed in the bottom-left corner ⑨. Once the user identifies a suitable target location, they can left-click to mark it. At this point, the status on the right panel changes from ⑩ to ⑪, adding a radio button. If the user is unsatisfied with the marked location, they can click the "Clear target" button on the panel to re-mark the injection target.

Next, select the surgery planning type. STAM offers two options: manual planning and automatic planning, corresponding to the "Manually" and "Auto" options in the radio button that appears as ⑪. If the user clicks "Manually" to enter manual planning type, the marked injection target turns into a blue dot ⑫. A red dashed line ⑬ originates from the injection target and extends towards the current mouse position. The intersection of this dashed line with the outline of STAM ⑭ (i.e., the injection site) is marked in green. Once the user identifies a suitable injection path, they can left-click to mark it. The marked path will appear as a solid blue line ⑮ in the main window, with the injection site marked as a blue cone ⑯. The names of brain regions and nuclei that the path passes through will be arranged along the solid line according to their spatial positions. In the right panel, information about the angle between the injection path and three standard anatomical directions, the injection target, and the injection site is displayed ⑰. If the user wishes to restart the entire virtual surgery process, they can click the "Reset" button ⑱ on the right panel.

If the user clicks "Auto" ⑲ to enter automatic type, the "Structure for injecting" tab on the left data panel changes to "Regions to avoid". All checkboxes besides the structures become disabled. By clicking on the names of brain regions or nuclei to avoid, the selected text will highlight in bright red ⑳. Simultaneously, the 3D contours ㉑ of these structures will be visualized in the main window. Next, clicking the "Intellectual planning" button ㉒ on the right panel initiates the process. After a few seconds, STAM returns a path ㉓ originating from the injection target, avoiding all user-selected brain regions and nuclei. Similar to the manual planning, this path is marked as a solid blue line, with the injection site marked as a blue cone. The names of all brain regions and nuclei that the path passes through will be arranged along the path according to their spatial locations. Information about the injection angle between the injection path and three standard anatomical directions, the injection target, and the injection site will also appear on the right panel ㉔. Note that STAM's automatic planning involves a degree of randomness. If the planned path in a particular instance does not meet user’s expectation, the user can click the "Intellectual planning" button again until achieving a satisfactory result.