AppStore
Index
Properties
- activeImage
- activeLayer
- activeWorkspace
- alertStore
- animatorStore
- apiService
- astReady
- backendService
- cartaComputeReady
- catalogStore
- contourDataSource
- cursorFrozen
- cursorMirror
- dialogStore
- fileBrowserStore
- fileLoading
- fileSaving
- helpStore
- hipsQueryStore
- hoveredFrame
- imageFittingStore
- imageRatio
- imageViewConfigStore
- isExportingImage
- isLoadingMultipleFiles
- layoutStore
- loadingWorkspace
- logStore
- momentToMatch
- newRelease
- overlayStore
- preferenceStore
- previewFrames
- rasterScalingReference
- regionHistograms
- regionStats
- resumingSession
- scriptingService
- showNewRelease
- snippetStore
- spatialProfiles
- spatialReference
- spectralMatchingType
- spectralProfiles
- spectralReference
- splashScreenVisible
- syncContourToFrame
- syncFrameToContour
- systemTheme
- taskCurrentTime
- taskProgress
- taskStartTime
- telemetryService
- tileService
- toolbarExpanded
- username
- widgetsStore
- zIndexManager
- DEFAULT_STATS_TYPES
Accessors
- activeFrame
- activeFrameFileId
- activeFrameIndex
- activeImageIndex
- appendFileDisabled
- catalogNextFileId
- catalogNum
- contourFrames
- darkTheme
- estimatedTaskRemainingTime
- frameChannels
- frameLockedToContour
- frameMap
- frameNames
- frameNum
- frameOptions
- frameStokes
- frames
- modifierString
- openFileDisabled
- pixelRatio
- selectedRegion
- spatialAndSpectalMatchedFileIds
- vectorOverlayFrames
- Instance
Methods
- addFrame
- addPreviewFrame
- addRegionsInBatch
- appendCatalog
- appendConcatFile
- appendFile
- cancelCubeHistogramRequest
- cancelRequestingMoment
- cancelRequestingPV
- clearRasterScalingReference
- clearSpatialReference
- clearSpectralReference
- closeCurrentFile
- closeFile
- closeImage
- closeOtherFiles
- closeOtherImages
- closeWorkspace
- decreaseImageRatio
- delay
- deleteAllAnnotations
- deleteAllRegions
- deleteAllRegularRegions
- deleteRegion
- deleteSelectedRegion
- deleteWorkspace
- endFileLoading
- endFileSaving
- exportImage
- exportRegions
- fetchParameter
- getAppContainer
- getFileList
- getFrame
- getFrameIndex
- getFrameName
- getImageDataUrl
- handleCatalogFilterStream
- handleContourImageStream
- handleErrorStream
- handleFileProgressStream
- handleFittingProgressStream
- handleMomentProgressStream
- handlePvPreviewStream
- handlePvProgressStream
- handleRegionHistogramStream
- handleRegionStatsStream
- handleScriptingRequest
- handleSpatialProfileStream
- handleSpectralProfileStream
- handleThemeChange
- handleTileStream
- handleVectorTileStream
- hideSplashScreen
- importRegion
- isActiveImage
- loadConcatStokes
- loadDefaultFiles
- loadFile
- loadRemoteFile
- loadWorkspace
- nextImage
- onReconnectAlertClosed
- openConcatFile
- openFile
- prevImage
- recalculateRequirements
- removeAllFrames
- removeCatalog
- removePreviewFrame
- reorderFrame
- requestCubeHistogram
- requestFitting
- requestMoment
- requestPV
- requestPreviewPV
- resetCursorRegionSpectralProfileProgress
- resetImageRatio
- resetRegionSpectralProfileProgress
- restartTaskProgress
- saveFile
- saveWorkspace
- sendCatalogFilter
- setActiveImage
- setActiveImageByFileId
- setActiveImageByIndex
- setAppContainer
- setAstReady
- setAutoTheme
- setCanvasUpdated
- setChannelsByFrame
- setContourDataSource
- setCursorFrozen
- setDarkTheme
- setHoveredFrame
- setImageRatio
- setImageViewDimensions
- setIsCanvasUpdated
- setIsExportingImage
- setLightTheme
- setLoadingMultipleFiles
- setMatchingEnabled
- setRasterScalingMatchingEnabled
- setRasterScalingReference
- setShowNewRelease
- setSpatialMatchingEnabled
- setSpatialReference
- setSpectralMatchingEnabled
- setSpectralMatchingType
- setSpectralReference
- setTheme
- setToolbarExpanded
- setUsername
- showSplashScreen
- startFileLoading
- startFileSaving
- toggleActiveLayer
- toggleCursorFrozen
- toggleCursorMirror
- toggleFrameContourLock
- toggleMomentToMatch
- toggleRasterScalingMatching
- toggleSpatialMatching
- toggleSpectralMatching
- toggleToolbarExpanded
- updateActiveImage
- updateActiveImageByFrame
- updateActiveLayer
- updateCatalogProfile
- updateChannels
- updateLayerPixelRatio
- updateTaskProgress
- waitForImageData
Properties
activeImage
activeLayer
activeWorkspace
readonlyalertStore
readonlyanimatorStore
readonlyapiService
astReady
readonlybackendService
cartaComputeReady
readonlycatalogStore
contourDataSource
cursorFrozen
cursorMirror
readonlydialogStore
readonlyfileBrowserStore
fileLoading
fileSaving
readonlyhelpStore
readonlyhipsQueryStore
Management of HiPS data queries.
hoveredFrame
readonlyimageFittingStore
imageRatio
readonlyimageViewConfigStore
Configuration of the images in the image view widget.
isExportingImage
isLoadingMultipleFiles
readonlylayoutStore
loadingWorkspace
readonlylogStore
momentToMatch
newRelease
readonlyoverlayStore
readonlypreferenceStore
previewFrames
rasterScalingReference
regionHistograms
regionStats
resumingSession
readonlyscriptingService
showNewRelease
readonlysnippetStore
spatialProfiles
spatialReference
spectralMatchingType
spectralProfiles
spectralReference
splashScreenVisible
syncContourToFrame
syncFrameToContour
systemTheme
taskCurrentTime
taskProgress
taskStartTime
readonlytelemetryService
readonlytileService
toolbarExpanded
username
readonlywidgetsStore
publiczIndexManager
publicstaticreadonlyDEFAULT_STATS_TYPES
Accessors
activeFrame
The active frame. If the active image is a loaded image or a PV preview, returns the corresponding frame. If the active image is a color blended image, returns the base frame.
Returns FrameStore
activeFrameFileId
Returns number
activeFrameIndex
Returns number
activeImageIndex
The index of the active image in the image list.
Returns number
appendFileDisabled
Returns boolean
catalogNextFileId
Returns number
catalogNum
Returns number
contourFrames
Returns Map<FrameStore, FrameStore[]>
darkTheme
Returns boolean
estimatedTaskRemainingTime
Returns number
frameChannels
Returns number[]
frameLockedToContour
Returns boolean
frameMap
Returns Map<number, FrameStore>
frameNames
Returns OptionProps[]
frameNum
Returns number
frameOptions
Returns FrameOption[]
frameStokes
Returns number[]
frames
All the loaded images in the image list.
Returns FrameStore[]
modifierString
Returns ctrl + | cmd + | alt +
openFileDisabled
Returns boolean
pixelRatio
This is devicePixelRatio * imageRatio, which is used to make image rendering consistent across different devices.
Returns number
selectedRegion
Returns RegionStore
spatialAndSpectalMatchedFileIds
Returns number[]
vectorOverlayFrames
Returns Map<FrameStore, FrameStore[]>
staticInstance
Returns AppStore
Methods
addFrame
Adds a frame to the frame array based on the provided parameters.
Parameters
ack: IOpenFileAck
The ack message received after opening a file.
directory: string
The path to the parent directory of the file.
lelExpr: boolean
Whether the file is opened with an image arithmetic (CASA lattice expression) string.
hdu: string
The Header Data Unit (HDU) identifier of the file.
generated: boolean = false
Whether the frame is a generated in-memory image. Used for the telemetry message.
setAsActive: boolean = true
Whether the frame should be set as the active frame.
updateStartingDirectory: boolean = true
Whether to update the starting directory in the file browser. Required for carta-python.
Returns boolean
Whether the frame was successfully added.
addPreviewFrame
Parameters
ack: any
directory: string
hdu: string
Returns FrameStore
addRegionsInBatch
Parameters
frame: FrameStore
regions: [string, IRegionInfo][]
regionStyleMap: Map<string, IRegionStyle>
startIndex: number
count: number
Returns void
appendCatalog
Parameters
directory: string
file: string
previewDataSize: number
type: CatalogFileType
Returns Generator<Promise<IOpenCatalogFileAck>, number, unknown>
appendConcatFile
Parameters
stokesFiles: IStokesFile[]
directory: string
hdu: string
Returns Promise<any>
appendFile
Appends a file at the given path to the list of existing open files.
Parameters
path: string
The path to the parent directory of the file to open, or of the file itself.
optionalfilename: string
The filename of the file to open.
optionalhdu: string
The Header Data Unit (HDU) to open. If left blank, the first image HDU will be opened.
imageArithmetic: boolean = false
Whether to treat the filename as an image arithmetic (CASA lattice expression) string.
setAsActive: boolean = true
Whether to set the appended file as the active frame.
updateStartingDirectory: boolean = true
Whether to update the starting directory in the file browser. Required for carta-python.
Returns Generator<Generator<Promise<IOpenFileAck>, FrameStore, unknown>, any, unknown>
A promise that resolves to the FrameStore of the opened file.
cancelCubeHistogramRequest
Parameters
fileId: number = -1
Returns void
cancelRequestingMoment
Parameters
fileId: number = -1
Returns void
cancelRequestingPV
Parameters
fileId: number = -1
optionalpreviewId: number
Returns void
clearRasterScalingReference
Returns void
clearSpatialReference
Returns void
clearSpectralReference
Returns void
closeCurrentFile
Closes the currently active image if the active image is not a PV preview.
Parameters
confirmClose: boolean = false
Flag indicating whether to display a confirmation dialog before closing.
Returns void
closeFile
Closes a loaded image.
Parameters
frame: FrameStore
The loaded image.
confirmClose: boolean = true
Flag indicating whether to display a confirmation dialog before closing.
Returns Generator<Promise<boolean>, void, unknown>
closeImage
Closes a loaded image or a color blended image.
Parameters
image: ImageViewItem
The image item to close.
confirmClose: boolean = true
Flag indicating whether to display a confirmation dialog before closing.
Returns void
closeOtherFiles
Closes all the loaded image except the provided one.
Parameters
frame: FrameStore
A loaded image.
confirmClose: boolean = true
Flag indicating whether to display a confirmation dialog before closing.
Returns void
closeOtherImages
Closes all the images except the provided loaded image.
Parameters
frame: FrameStore
A loaded image.
Returns void
closeWorkspace
Returns void
decreaseImageRatio
Returns void
delay
Parameters
time: number
Returns Promise<unknown>
deleteAllAnnotations
Deletes all annotations.
Returns void
deleteAllRegions
Deletes all regions including annotations.
Returns void
deleteAllRegularRegions
Deletes all regular regions.
Returns void
deleteRegion
Parameters
region: RegionStore
Returns void
deleteSelectedRegion
Returns void
deleteWorkspace
Parameters
name: string
Returns Promise<void>
endFileLoading
Returns void
endFileSaving
Returns void
exportImage
Parameters
imageRatio: number
Returns void
exportRegions
Exports specified regions and saves a region file to the provided directory.
Parameters
directory: string
The directory where the region file will be saved.
file: string
The filename of the region file.
coordType: CoordinateType
The coordinate system used in the exported region file.
fileType: any
The type of the exported region file.
exportRegions: number[]
The indices of the regions to be exported.
overwrite: boolean = false
Whether to allow overwriting existing files.
optionaltargetFrame: FrameStore
The target frame containing the regions. If not provided, the active frame is used.
Returns Generator<Promise<IExportRegionAck>, void, unknown>
fetchParameter
Parameters
val: any
Returns any
publicgetAppContainer
Returns HTMLElement
getFileList
Parameters
directory: string
Returns Promise<IFileListResponse>
getFrame
Parameters
fileId: number
Returns FrameStore
getFrameIndex
Parameters
fileId: number
Returns number
getFrameName
Parameters
fileId: number
Returns string
getImageDataUrl
Parameters
backgroundColor: string
Returns string
handleCatalogFilterStream
Parameters
catalogFilter: CatalogFilterResponse
Returns void
handleContourImageStream
Parameters
contourImageData: ContourImageData
Returns void
handleErrorStream
Parameters
errorData: ErrorData
Returns void
handleFileProgressStream
Parameters
fileProgress: ListProgress
Returns void
handleFittingProgressStream
Parameters
fittingProgress: FittingProgress
Returns void
handleMomentProgressStream
Parameters
momentProgress: MomentProgress
Returns void
handlePvPreviewStream
Parameters
pvPreviewData: PvPreviewData
Returns void
handlePvProgressStream
Parameters
pvProgress: PvProgress
Returns void
handleRegionHistogramStream
Parameters
regionHistogramData: RegionHistogramData
Returns void
handleRegionStatsStream
Parameters
regionStatsData: RegionStatsData
Returns void
handleScriptingRequest
Parameters
request: IScriptingRequest
Returns void
handleSpatialProfileStream
Parameters
spatialProfileData: ISpatialProfileData
Returns void
handleSpectralProfileStream
Parameters
spectralProfileData: SpectralProfileData
Returns void
handleThemeChange
Parameters
darkMode: boolean
Returns void
handleTileStream
Parameters
tileStreamDetails: TileStreamDetails
Returns void
handleVectorTileStream
Parameters
vectorTileData: IVectorOverlayTileData
Returns void
hideSplashScreen
Returns void
importRegion
Imports a region file to the active frame or a specified frame. Supported file types are CRTF and DS9.
Parameters
directory: string
The directory containing the region file.
file: string
The filename of the region file.
type: any
The type of the region file (
CRTF
orDS9_REG
).optionaltargetFrame: FrameStore
The frame to which the regions should be imported. If not provided, the active frame is used. If the frame is spatially matched, the reference frame is used.
Returns Generator<Promise<IImportRegionAck>, void, unknown>
isActiveImage
Checks if the given image is the active image.
Parameters
image: ImageItem
The image to check.
Returns boolean
Whether the given image is the active image.
loadConcatStokes
Parameters
stokesFiles: IStokesFile[]
directory: string
hdu: string
Returns Promise<any>
loadDefaultFiles
Returns Generator<Generator<Promise<IOpenFileAck>, FrameStore, unknown> | Generator<Generator<Generator<Promise<IOpenFileAck>, FrameStore, unknown>, any, unknown> | Promise<Workspace>, boolean, Workspace & FrameStore>, void, unknown>
loadFile
Loads a file at the given path and adds it as a frame to the application.
Parameters
path: string
The path to the parent directory of the file to load, or of the file itself.
filename: string
The filename of the file to load.
hdu: string
The Header Data Unit (HDU) to load. If left blank, the first image HDU will be loaded.
imageArithmetic: boolean
Whether to treat the file as an image arithmetic (CASA lattice expression) string.
setAsActive: boolean = true
Whether the loaded frame should be set as the active frame.
updateStartingDirectory: boolean = true
Whether to update the starting directory in the file browser. Required for carta-python.
Returns Generator<Promise<IOpenFileAck>, FrameStore, unknown>
The added frame.
loadRemoteFile
Loads a file by HiPS data queries and adds it as a frame.
Parameters
remoteRequest: IRemoteFileRequest
Parameters for the query.
Returns Generator<Promise<IRemoteFileResponse>, FrameStore, any>
The added frame.
publicloadWorkspace
Parameters
name: string
isKey: boolean = false
Returns Generator<Generator<Generator<Promise<IOpenFileAck>, FrameStore, unknown>, any, unknown> | Promise<Workspace>, boolean, Workspace & FrameStore>
nextImage
Shifts the active image to the next image. If the active image is a PV preview, the shift doesn't occur.
Returns void
onReconnectAlertClosed
Returns Promise<void>
openConcatFile
Parameters
stokesFiles: IStokesFile[]
directory: string
hdu: string
Returns Promise<any>
openFile
Closes all existing files and opens a file at the given path.
Parameters
path: string
The path to the parent directory of the file to open, or of the file itself.
optionalfilename: string
The filename of the file to open.
optionalhdu: string
The Header Data Unit (HDU) to open. If left blank, the first image HDU will be opened.
optionalimageArithmetic: boolean
Whether to treat the filename as an image arithmetic (CASA lattice expression) string.
updateStartingDirectory: boolean = true
Whether to update the starting directory in the file browser. Required for carta-python.
Returns Generator<Generator<Promise<IOpenFileAck>, FrameStore, unknown>, any, unknown>
A promise that resolves to the FrameStore of the opened file.
prevImage
Shifts the active image to the previous image. If the active image is a PV preview, the shift doesn't occur.
Returns void
recalculateRequirements
Returns void
removeAllFrames
Closes all the images in the image view widget.
Returns void
removeCatalog
Parameters
fileId: number
catalogWidgetId: string
optionalcatalogComponentId: string
Returns void
removePreviewFrame
Closes a PV preview.
Parameters
previewId: number
The file id of the image cube from which the PV preview was created.
Returns void
reorderFrame
Reorders images in the image list.
Parameters
oldIndex: number
The first index of the images to move.
newIndex: number
The index to move the image to.
length: number
The length of the images to move.
Returns void
requestCubeHistogram
Parameters
fileId: number = -1
Returns void
requestFitting
Parameters
message: IFittingRequest
Returns Generator<Promise<IFittingResponse>, void, unknown>
requestMoment
Parameters
message: IMomentRequest
frame: FrameStore
Returns Generator<Promise<IMomentResponse>, void, unknown>
requestPV
Parameters
message: IPvRequest
frame: FrameStore
keepExisting: boolean
Returns Generator<Promise<IPvResponse>, void, unknown>
requestPreviewPV
Parameters
message: IPvRequest
frame: FrameStore
id: string
Returns Generator<Promise<IPvResponse>, void, unknown>
publicresetCursorRegionSpectralProfileProgress
Parameters
fileId: number
Returns void
resetImageRatio
Returns void
publicresetRegionSpectralProfileProgress
Parameters
regionId: number
Returns void
restartTaskProgress
Returns void
saveFile
Parameters
directory: string
filename: string
fileType: FileType
optionalregionId: number
optionalchannels: number[]
optionalstokes: number[]
optionalshouldDropDegenerateAxes: boolean
optionalrestFreq: number
overwrite: boolean = false
Returns Generator<Promise<ISaveFileAck>, any, unknown>
publicsaveWorkspace
Parameters
name: string
Returns Generator<Promise<Workspace> | Promise<string | false>, boolean, unknown>
sendCatalogFilter
Parameters
catalogFilter: ICatalogFilterRequest
Returns void
setActiveImage
Sets the active image.
Parameters
activeImage: ImageItem
The image to set as the active image.
Returns void
setActiveImageByFileId
Sets the active image with a loaded image.
Parameters
fileId: number
The file id of the loaded image.
Returns void
setActiveImageByIndex
Sets the active image based on the image list index.
Parameters
index: number
The image list index.
Returns void
publicsetAppContainer
Parameters
container: HTMLElement
Returns void
setAstReady
Parameters
val: boolean
Returns void
setAutoTheme
Returns void
setCanvasUpdated
Returns void
setChannelsByFrame
Parameters
frame: FrameStore
Returns void
setContourDataSource
Parameters
frame: FrameStore
Returns void
setCursorFrozen
Parameters
val: boolean
Returns void
setDarkTheme
Returns void
setHoveredFrame
Parameters
frame: FrameStore
Returns void
setImageRatio
Parameters
val: number
Returns void
setImageViewDimensions
Parameters
w: number
h: number
Returns void
setIsCanvasUpdated
Parameters
val: boolean
Returns void
setIsExportingImage
Parameters
val: boolean
Returns void
setLightTheme
Returns void
setLoadingMultipleFiles
Parameters
isLoadingMultipleFiles: boolean
Returns void
setMatchingEnabled
Parameters
spatial: boolean
spectral: boolean
Returns void
setRasterScalingMatchingEnabled
Parameters
frame: FrameStore
val: boolean
Returns void
setRasterScalingReference
Parameters
frame: FrameStore
Returns void
setShowNewRelease
Parameters
val: boolean
Returns void
setSpatialMatchingEnabled
Sets the spatial matching for a frame.
Parameters
frame: FrameStore
The frame for which to set spatial matching.
val: boolean
Whether to enable or disable spatial matching.
Returns Generator<Promise<boolean>, void, unknown>
setSpatialReference
Sets the spatial reference frame.
Parameters
frame: FrameStore
The frame to set as the spatial reference.
showColorBlendingAlert: boolean = true
Whether to show an alert when layers will be removed from color blended images.
Returns Generator<Promise<boolean>, void, unknown>
setSpectralMatchingEnabled
Parameters
frame: FrameStore
val: boolean
Returns void
setSpectralMatchingType
Parameters
spectralMatchingType: SpectralType
Returns void
setSpectralReference
Parameters
frame: FrameStore
Returns void
setTheme
Parameters
theme: string
Returns void
setToolbarExpanded
Parameters
val: boolean
Returns void
setUsername
Parameters
username: string
Returns void
showSplashScreen
Returns void
startFileLoading
Returns void
startFileSaving
Returns void
toggleActiveLayer
Returns void
toggleCursorFrozen
Returns void
toggleCursorMirror
Returns void
toggleFrameContourLock
Returns void
toggleMomentToMatch
Returns void
toggleRasterScalingMatching
Parameters
frame: FrameStore
Returns void
toggleSpatialMatching
Parameters
frame: FrameStore
Returns void
toggleSpectralMatching
Parameters
frame: FrameStore
Returns void
toggleToolbarExpanded
Returns void
updateActiveImage
Sets the active image. Ignores when animating.
Parameters
image: ImageItem
The image to set as the active image.
Returns void
updateActiveImageByFrame
Sets the active image with a loaded image or a PV preview. Ignores when animating.
Parameters
frame: FrameStore
The loaded image or the PV preview.
Returns void
updateActiveLayer
Parameters
layer: ImageViewLayer
Returns void
updateCatalogProfile
Parameters
fileId: number
frame: FrameStore
Returns string
updateChannels
Parameters
updates: ChannelUpdate[]
Returns void
updateLayerPixelRatio
Parameters
layerRef: any
Returns void
updateTaskProgress
Parameters
progress: number
Returns void
waitForImageData
Returns Promise<void>
The active image, which can be a loaded image, a color blended image, or a PV preivew.