@abi-software/flatmapvuer 1.4.0 → 1.4.1-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abi-software/flatmapvuer",
-  "version": "1.4.0",
+  "version": "1.4.1-beta.1",
   "license": "Apache-2.0",
   "files": [
     "dist/*",
@@ -43,8 +43,8 @@
     "./src/*": "./src/*"
   },
   "dependencies": {
-    "@abi-software/flatmap-viewer": "2.9.5",
-    "@abi-software/map-utilities": "1.1.0",
+    "@abi-software/flatmap-viewer": "3.1.4",
+    "@abi-software/map-utilities": "^1.1.0-beta.2",
     "@abi-software/sparc-annotation": "0.3.1",
     "@abi-software/svg-sprite": "1.0.0",
     "@element-plus/icons-vue": "^2.3.1",
@@ -59,7 +59,7 @@
     "@cypress/webpack-dev-server": "^3.6.1",
     "@vitejs/plugin-vue": "^4.6.2",
     "@vuese/markdown-render": "^2.11.3",
-    "@vuese/parser": "^2.10.3",
+    "@vuese/parser": "^2.9.1",
     "auto-changelog": "^2.4.0",
     "babel-eslint": "^10.1.0",
     "chokidar": "^3.6.0",
@@ -92,5 +92,8 @@
   "browserslist": [
     "> 1%",
     "last 2 versions"
-  ]
+  ],
+  "optionalDependencies": {
+    "@rollup/rollup-linux-x64-gnu": "^4.21.1"
+  }
 }

package/src/App.vue

@@ -77,6 +77,7 @@
       :displayMinimap="true"
       :enableOpenMapUI="true"
       :flatmapAPI="flatmapAPI"
+      :sparcAPI="sparcAPI"
       :disableUI="disableUI"
       @open-pubmed-url="onOpenPubmedUrl"
       @pathway-selection-changed="onPathwaySelectionChanged"
@@ -109,6 +110,9 @@ import './icons/mapicon-species-style.css'
 import MultiFlatmapVuer from './components/MultiFlatmapVuer.vue'
 import { HelpModeDialog } from '@abi-software/map-utilities'
 import '@abi-software/map-utilities/dist/style.css'
+import { mapStores } from 'pinia';
+import { useSettingsStore } from './stores/settings';
+import { getOrganCuries } from './services/scicrunchQueries'
 
 export default {
   name: 'app',
@@ -145,6 +149,7 @@ export default {
       if (this.consoleOn) console.log(component)
       let taxon = component.mapImp.describes
       let id = component.mapImp.addMarker('UBERON:0000948')
+
       window.flatmapImp = component.mapImp
       component.enablePanZoomEvents(true)
       //component.showPathwaysDrawer(false);
@@ -261,6 +266,10 @@ export default {
           iconClass: 'mapicon-icon_cat',
           displayWarning: true,
         },
+        Vagus: {
+          taxo: 'UBERON:1759',
+          displayWarning: true,
+        },
         Sample: { taxo: 'NCBITaxon:1', displayWarning: true },
         'Functional Connectivity': {
           taxo: 'FunctionalConnectivity',
@@ -281,18 +290,24 @@ export default {
       useHelpModeDialog: true,
       multiflatmapRef: null,
       mapSettings: [],
+      sparcAPI: import.meta.env.VITE_SPARC_API,
       //flatmapAPI: "https://mapcore-demo.org/current/flatmap/v2/"
       //flatmapAPI: "https://mapcore-demo.org/devel/flatmap/v3/"
-      //flatmapAPI: "https://mapcoe-demo.org/current/flatmap/v3/",
-      flatmapAPI: 'https://mapcore-demo.org/devel/flatmap/v4/',
+      flatmapAPI: "https://mapcore-demo.org/current/flatmap/v3/",
+      //flatmapAPI: 'https://mapcore-demo.org/devel/flatmap/v4/',
+      //flatmapAPI: 'https://mapcore-demo.org/curation/flatmap/',
       //flatmapAPI: "https://mapcore-demo.org/fccb/flatmap/"
       //flatmapAPI: "https://mapcore-demo.org/staging/flatmap/v1/"
       // flatmapAPI: "https://mapcore-demo.org/devel/flatmap/v1/",
-      ElIconSetting: shallowRef(ElIconSetting)
+      ElIconSetting: shallowRef(ElIconSetting),
     }
   },
   mounted: function () {
     this.multiflatmapRef = this.$refs.multi;
+    getOrganCuries(this.sparcAPI).then((organCuries) => this.settingsStore.updateOrganCuries(organCuries))
+  },
+  computed: {
+    ...mapStores(useSettingsStore),
   },
   watch: {
     helpMode: function (newVal) {

package/src/components/FlatmapVuer.vue

@@ -245,7 +245,7 @@ Please use `const` to assign meaningful names to them...
           <div
             class="pathway-location"
             :class="{ open: drawerOpen, close: !drawerOpen }"
-            v-show="!disableUI"
+            v-show="!(disableUI || isCentreLine)"
           >
             <div
               class="pathway-container"
@@ -377,7 +377,7 @@ Please use `const` to assign meaningful names to them...
                 key="taxonSelection"
               />
               <selections-group
-                v-if="!isFC && centreLines && centreLines.length > 0"
+                v-if="!(isCentreLine || isFC)  && centreLines && centreLines.length > 0"
                 title="Nerves"
                 labelKey="label"
                 identifierKey="key"
@@ -426,7 +426,7 @@ Please use `const` to assign meaningful names to them...
         ref="backgroundPopover"
         :virtual-ref="backgroundIconRef"
         placement="top-start"
-        width="320"
+        width="330"
         :teleported="false"
         trigger="click"
         popper-class="background-popper h-auto"
@@ -453,13 +453,14 @@ Please use `const` to assign meaningful names to them...
             </el-row>
           </el-row>
           <template v-if="viewingMode === 'Annotation' && userInformation">
+            <el-row class="backgroundSpacer"></el-row>
             <el-row class="backgroundText">Drawn By*</el-row>
             <el-row class="backgroundControl">
               <el-select
                 :teleported="false"
                 v-model="drawnType"
                 placeholder="Select"
-                class="select-box"
+                class="select-box annotationSelector"
                 popper-class="flatmap_dropdown"
                 @change="setDrawnType"
               >
@@ -475,13 +476,14 @@ Please use `const` to assign meaningful names to them...
                 </el-option>
               </el-select>
             </el-row>
+            <el-row class="backgroundSpacer"></el-row>
             <el-row class="backgroundText">Annotated By*</el-row>
             <el-row class="backgroundControl">
               <el-select
                 :teleported="false"
                 v-model="annotatedType"
                 placeholder="Select"
-                class="select-box"
+                class="select-box annotationSelector"
                 popper-class="flatmap_dropdown"
                 @change="setAnnotatedType"
               >
@@ -498,6 +500,41 @@ Please use `const` to assign meaningful names to them...
               </el-select>
             </el-row>
           </template>
+          <el-row class="backgroundSpacer" v-if="viewingMode === 'Exploration' && !isFC"></el-row>
+          <el-row class="backgroundText" v-if="viewingMode === 'Exploration' && !isFC">Markers display</el-row>
+          <el-row class="backgroundControl" v-if="viewingMode === 'Exploration' && !isFC">
+            <el-col :span="14">
+              <el-radio-group
+                v-model="imageRadio"
+                class="flatmap-radio"
+                @change="setImage"
+              >
+                <el-radio :label="false">Standard</el-radio>
+                <el-radio :label="true">Image</el-radio>
+              </el-radio-group>
+            </el-col>
+            <el-col :span="10" v-if="imageRadio">
+              <el-select
+                :teleported="false"
+                v-model="imageType"
+                placeholder="Select"
+                class="select-box imageSelector"
+                popper-class="flatmap_dropdown"
+                @change="setImageType"
+              >
+                <el-option
+                  v-for="item in imageTypes"
+                  :key="item"
+                  :label="item"
+                  :value="item"
+                >
+                  <el-row>
+                    <el-col :span="12">{{ item }}</el-col>
+                  </el-row>
+                </el-option>
+              </el-select>
+            </el-col>
+          </el-row>
           <el-row class="backgroundSpacer" v-if="displayFlightPathOption"></el-row>
           <el-row class="backgroundText" v-if="displayFlightPathOption">Flight path display</el-row>
           <el-row class="backgroundControl" v-if="displayFlightPathOption">
@@ -602,9 +639,10 @@ Please use `const` to assign meaningful names to them...
         ref="tooltip"
         class="tooltip"
         v-show="tooltipDisplay"
+        :tooltipType="tooltipType"
+        :provenanceEntry="provenanceEntry"
         :annotationEntry="annotationEntry"
-        :tooltipEntry="tooltipEntry"
-        :annotationDisplay="viewingMode === 'Annotation'"
+        :imageEntry="imageEntry"
         @annotation="commitAnnotationEvent"
       />
     </div>
@@ -643,10 +681,18 @@ import yellowstar from '../icons/yellowstar'
 import ResizeSensor from 'css-element-queries/src/ResizeSensor'
 import * as flatmap from '@abi-software/flatmap-viewer'
 import { AnnotationService } from '@abi-software/sparc-annotation'
-import { mapState } from 'pinia'
-import { useMainStore } from '@/store/index'
+import { mapState, mapStores } from 'pinia'
+import { useMainStore } from '@/stores/index'
+import { useSettingsStore } from '@/stores/settings'
 import { DrawToolbar, Tooltip, TreeControls } from '@abi-software/map-utilities'
 import '@abi-software/map-utilities/dist/style.css'
+import {
+  getBiolucidaThumbnails,
+  getSegmentationThumbnails,
+  getScaffoldThumbnails,
+  getPlotThumbnails
+} from '../services/scicrunchQueries'
+import imageMixin from '../mixins/imageMixin'
 
 const centroid = (geometry) => {
   let featureGeometry = { lng: 0, lat: 0, }
@@ -735,6 +781,7 @@ const createUnfilledTooltipData = function () {
  */
 export default {
   name: 'FlatmapVuer',
+  mixins:[imageMixin],
   components: {
     Button,
     Col,
@@ -767,6 +814,68 @@ export default {
     return { annotator }
   },
   methods: {
+    /**
+     * @vuese
+     * Function to add image thumbnails to the map.
+     */
+    populateImageThumbnails: async function (type) {
+      if (this.mapImp) {
+        this.closeTooltip()
+        this.mapImp.clearMarkers();
+        const identifiers = this.mapImp.anatomicalIdentifiers
+        const imageThumbnails = this.settingsStore.getImageThumbnails(type, identifiers)
+        this.populateMapWithImages(this.mapImp, imageThumbnails, type)
+      }
+    },
+    /**
+     * @vuese
+     * Function to fetching image thumbnails.
+     */
+    fetchImageThumbnails: async function (type) {
+      let thumbnails = {}
+      const organCuries = this.settingsStore.organCuries
+      if (type === 'Image') {
+        thumbnails = await getBiolucidaThumbnails(this.sparcAPI, organCuries, type)
+      } else if (type === 'Segmentation') {
+        thumbnails = await getSegmentationThumbnails(this.sparcAPI, organCuries, type)
+      } else if (type === 'Scaffold') {
+        thumbnails = await getScaffoldThumbnails(this.sparcAPI, organCuries, type)
+      } else if (type === 'Plot') {
+        thumbnails = await getPlotThumbnails(this.sparcAPI, organCuries, type)
+      }
+      this.settingsStore.updateImageThumbnails(type, thumbnails)
+    },
+    /**
+     * @vuese
+     * Function to switch the type of displayed image.
+     * @arg type
+     */
+    setImageType: async function (type) {
+      this.imageType = type
+      if (this.mapImp) {
+        if (!this.settingsStore.imageTypeCached(type)) {
+          this.loading = true
+          await this.fetchImageThumbnails(type)
+          this.loading = false
+        }
+        this.populateImageThumbnails(type)
+      }
+    },
+    /**
+     * @vuese
+     * Function to switch show or hide images.
+     * @arg flag
+     */
+    setImage: function (flag) {
+      this.imageRadio = flag
+      if (this.mapImp) {
+        if (flag) {
+          this.setImageType(this.imageType)
+        } else {
+          this.mapImp.clearMarkers();
+        }
+      }
+    },
     /**
      * @vuese
      * Function to initialise drawing.
@@ -1669,7 +1778,6 @@ export default {
             }
             if (
               data &&
-              data.type !== 'marker' &&
               eventType === 'click' &&
               !(this.viewingMode === 'Neuron Connection') &&
               // Disable popup when drawing
@@ -1703,6 +1811,12 @@ export default {
      * @arg data
      */
     checkAndCreatePopups: async function (data) {
+      if (data.feature.type === 'marker' && this.imageRadio) {
+        this.tooltipType = 'image'
+        const imageThumbnails = this.settingsStore.getImageThumbnails(this.imageType, [data.resource[0]])
+        this.imageEntry = markRaw(imageThumbnails[data.resource[0]])
+        this.displayTooltip(data.feature.models)
+      } else {
       // Call flatmap database to get the connection data
       if (this.viewingMode === 'Annotation') {
         if (data.feature) {
@@ -1710,6 +1824,7 @@ export default {
             ...data.feature,
             resourceId: this.serverURL,
           }
+          this.tooltipType = 'annotation'
           if (data.feature.featureId && data.feature.models) {
             this.displayTooltip(data.feature.models)
           } else if (data.feature.feature) {
@@ -1743,9 +1858,11 @@ export default {
           results[1] ||
           (data.feature.hyperlinks && data.feature.hyperlinks.length > 0)
         ) {
+          this.tooltipType = 'provenance'
           this.resourceForTooltip = data.resource[0]
           data.resourceForTooltip = this.resourceForTooltip
           this.createTooltipFromNeuronCuration(data)
+          }
         }
       }
     },
@@ -1784,7 +1901,7 @@ export default {
      * @arg data
      */
     createTooltipFromNeuronCuration: async function (data) {
-      this.tooltipEntry = await this.flatmapQueries.createTooltipData(data)
+      this.provenanceEntry = await this.flatmapQueries.createTooltipData(data)
       this.displayTooltip(data.resource[0])
     },
     /**
@@ -1997,9 +2114,12 @@ export default {
         // const featureIds = [feature];
         // this.moveMap(featureIds);
         if (this.featuresAlert) {
-          this.tooltipEntry['featuresAlert'] = this.featuresAlert;
+          this.provenanceEntry['featuresAlert'] = this.featuresAlert;
         }
-        this.$emit('connectivity-info-open', this.tooltipEntry);
+        this.$emit('connectivity-info-open', this.provenanceEntry);
+      }
+      if (this.imageThumbnailSidebar && this.imageEntry.length && this.viewingMode === 'Exploration') {
+        this.$emit('image-thumbnail-open', this.imageEntry)
       }
       // If UI is not disabled,
       // And connectivityInfoSidebar is not set (default) or set to `false`
@@ -2010,8 +2130,10 @@ export default {
           this.viewingMode === 'Annotation' ||
           (
             this.viewingMode === 'Exploration' &&
-            !this.connectivityInfoSidebar &&
-            this.hasTooltipEntry()
+            (
+              (!this.connectivityInfoSidebar && this.hasTooltipEntry()) ||
+              (!this.imageThumbnailSidebar && this.imageEntry.length)
+            )
           )
         )
       ) {
@@ -2030,7 +2152,7 @@ export default {
         origins,
         provenanceTaxonomy,
         provenanceTaxonomyLabel
-      } = this.tooltipEntry;
+      } = this.provenanceEntry;
 
       return Boolean(
         components?.length ||
@@ -2314,13 +2436,18 @@ export default {
     onFlatmapReady: function () {
       // onFlatmapReady is used for functions that need to run immediately after the flatmap is loaded
       this.sensor = markRaw(new ResizeSensor(this.$refs.display, this.mapResize))
-      if (this.mapImp.options && this.mapImp.options.style === 'functional') {
+      console.log(this.mapImp.options)
+      if (this.mapImp.options?.style === 'functional') {
         this.isFC = true
+      } else if (this.mapImp.options?.style === 'centreline') {
+        this.isCentreLine = true
       }
       this.mapImp.setBackgroundOpacity(1)
       this.backgroundChangeCallback(this.currentBackground)
       this.pathways = this.mapImp.pathTypes()
-      this.mapImp.enableCentrelines(false)
+      if (!this.isCentreLine) {
+        this.mapImp.enableCentrelines(false)
+      }
       //Disable layers for now
       //this.layers = this.mapImp.getLayers();
       this.processSystems(this.mapImp.getSystems())
@@ -2329,9 +2456,9 @@ export default {
       this.addResizeButtonToMinimap()
       this.loading = false
       this.computePathControlsMaximumHeight()
-      this.drawerOpen = true
+      this.drawerOpen = !this.isCentreLine      
       this.mapResize()
-      this.handleMapClick();
+      this.handleMapClick()
       /**
        * This is ``onFlatmapReady`` event.
        * @arg ``this`` (Component Vue Instance)
@@ -2348,7 +2475,7 @@ export default {
 
       if (_map) {
         _map.on('click', (e) => {
-          if (this.tooltipEntry.featureId) {
+          if (this.provenanceEntry.featureId) {
             this.$emit('connectivity-info-close');
           }
         });
@@ -2595,12 +2722,12 @@ export default {
      */
     sparcAPI: {
       type: String,
-      default: 'https://api.sparc.science/',
+      default: 'https://api.sparc.science',
     },
     /**
      * Flag to disable UIs on Map
      */
-     disableUI: {
+    disableUI: {
       type: Boolean,
       default: false,
     },
@@ -2611,11 +2738,17 @@ export default {
       type: Boolean,
       default: false,
     },
+    /**
+     * The option to show image thumbnail in sidebar
+     */
+    imageThumbnailSidebar: {
+      type: Boolean,
+      default: false,
+    },
   },
   provide() {
     return {
       flatmapAPI: this.flatmapAPI,
-      sparcAPI: this.sparcAPI,
       $annotator: this.annotator,
       getFeaturesAlert: () => this.featuresAlert,
       userApiKey: this.userToken,
@@ -2634,6 +2767,8 @@ export default {
       serverURL: undefined,
       layers: [],
       pathways: [],
+      imageEntry: markRaw([]),
+      tooltipType: 'provenance',
       sckanDisplay: [
         {
           label: 'Display Path with SCKAN',
@@ -2672,12 +2807,13 @@ export default {
       helpModeActiveIndex: this.helpModeInitialIndex,
       yellowstar: yellowstar,
       isFC: false,
+      isCentreLine: false,
       inHelp: false,
       currentBackground: 'white',
       availableBackground: ['white', 'lightskyblue', 'black'],
       loading: false,
       flatmapMarker: flatmapMarker,
-      tooltipEntry: createUnfilledTooltipData(),
+      provenanceEntry: createUnfilledTooltipData(),
       connectivityTooltipVisible: false,
       drawerOpen: false,
       featuresAlert: undefined,
@@ -2700,6 +2836,9 @@ export default {
       drawnTypes: ['All tools', 'Point', 'LineString', 'Polygon', 'None'],
       annotatedType: 'Anyone',
       annotatedTypes: ['Anyone', 'Me', 'Others'],
+      imageRadio: false,
+      imageType: 'Image',
+      imageTypes: ['Image', 'Segmentation', 'Scaffold', 'Plot'],
       openMapRef: undefined,
       backgroundIconRef: undefined,
       toolbarOptions: [
@@ -2737,11 +2876,12 @@ export default {
           with: true,
           without: true,
         }
-      })
+      }),
     }
   },
   computed: {
     ...mapState(useMainStore, ['userToken']),
+    ...mapStores(useSettingsStore),
     isValidDrawnCreated: function () {
       return Object.keys(this.drawnCreatedEvent).length > 0
     },
@@ -3579,7 +3719,12 @@ export default {
   background-color: var(--white);
   font-weight: 500;
   color: rgb(48, 49, 51);
-  width: 150px!important;
+  &.annotationSelector {
+    width: 150px!important;
+  }
+  &.imageSelector {
+    width: 125px!important;
+  }
 }
 
 :deep(.flatmap_dropdown) {

package/src/components/MultiFlatmapVuer.vue

@@ -81,6 +81,8 @@
       style="height: 100%"
       :flatmapAPI="flatmapAPI"
       :sparcAPI="sparcAPI"
+      :imageThumbnailSidebar="imageThumbnailSidebar"
+      @image-thumbnail-open="onImageThumbnailOpen"
     />
   </div>
 </template>
@@ -264,6 +266,9 @@ export default {
     onConnectivityInfoOpen: function (entryData) {
       this.$emit('connectivity-info-open', entryData);
     },
+    onImageThumbnailOpen: function (payload) {
+      this.$emit('image-thumbnail-open', payload);
+    },
     onSelectionsDataChanged: function (data) {
       this.$emit('pathway-selection-changed', data);
     },
@@ -700,7 +705,7 @@ export default {
      */
     sparcAPI: {
       type: String,
-      default: 'https://api.sparc.science/',
+      default: 'https://api.sparc.science',
     },
     /**
      * Flag to disable UIs on Map
@@ -716,6 +721,13 @@ export default {
       type: Boolean,
       default: false,
     },
+    /**
+     * The option to show image thumbnail in sidebar
+     */
+    imageThumbnailSidebar: {
+      type: Boolean,
+      default: false,
+    },
   },
   data: function () {
     return {

package/src/icons/imageThumbnail1.js

@@ -0,0 +1 @@
+export default '<img style="height: auto;width: 50px;margin-right: 80px;" src="data:image/png;base64,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" />'