Programmatically load file either drag-and-drop or via URL into Firefly Viewer
dnd_firefly is a command-line tool that allows you to programmatically upload local files to the Firefly Viewer (IRSA Viewer tool) by simulating a drag-and-drop action or loading from a URL.
This tool is particularly useful for automating data uploads and integrating with scripts or workflows that interact with the Firefly Viewer. This tools complements the existing URL API by enabling support for the Upload feature in scenarios where direct access is not yet available.
Firefly is an open-source web-based UI library for astronomical data archive access and visualization developed at Caltech. The development was started in the context of archive-specific applications at the NASA/IPAC Infrared Science Archive (IRSA), and was then generalized to serve data from many different archives at IRSA (and beyond). It was open sourced in 2015, hosted at GitHub.
See details in the GitHub repository and how to install locally.
dnd_firefly tool makes use of IRSA Viewer and is compatible since release 2023.3 (Drag-n-drop introduced - FIREFLY-1310.
- Automate File Uploads: Upload files to the Firefly Viewer without manual intervention.
- Simulate Drag-and-Drop: Programmatically simulate the drag-and-drop action to upload local files or from URL.
- Easy Integration: Integrate seamlessly with existing data processing pipelines or scripts.
You can install dnd_firefly directly from PyPI using pip:
pip install dnd_fireflyPyPi: https://pypi.org/project/dnd-firefly/
Note: dnd_firefly requires Python 3.11 or higher.
- Python 3.11+
- Google Chrome Browser: Ensure that the latest version of Chrome is installed on your system.
The tool uses Selenium WebDriver to automate a Chrome browser session. It opens the Firefly Viewer and simulates the drag-and-drop action to upload your specified file or load from URL.
Selenium Manager: Starting from Selenium 4.6.0, Selenium includes Selenium Manager, which automatically manages the browser driver required for automation. If you have Chrome installed, Selenium will handle the rest.
The dnd_firefly tool accepts one argument: the path to the local file or URL you want to upload to the Firefly Viewer.
For local files:
dnd_firefly /path/to/your/file.tblReplace /path/to/your/file.tbl with the actual path to your local file.
For URL:
dnd_firefly <http|https>://.../file.tblReplace <http|https>://.../file.tbl with the URL.
To upload a file named WISE-allwise_p3as_psd-Cone_100asec.tbl located in your Downloads folder, run:
dnd_firefly ~/Downloads/WISE-allwise_p3as_psd-Cone_100asec.tblExample of VOTable with 2 tables via URL:
dnd_firefly https://raw.githubusercontent.com/ejoliet/playground/refs/heads/master/data/table_IRS_Enh-Spectra-1.vot- Selenium Exceptions: If you encounter errors related to Selenium WebDriver, ensure that you have the latest version of Chrome installed and that your Selenium version is up to date.
- Internet Access: Selenium Manager requires internet access to download the appropriate WebDriver. If you're in an environment with restricted internet access, you may need to manually set up the WebDriver. Refer to the Selenium documentation for more details.
- File Path / URL Issues: Ensure that the file path or URL you provide is correct and that the file exists.
If you need to use a different browser or have specific requirements, you can manually set up the WebDriver.
-
Download ChromeDriver:
- Visit the ChromeDriver Downloads page.
- Download the version that matches your installed Chrome browser version.
-
Install ChromeDriver:
- Place the
chromedriverexecutable in a directory that's in your system'sPATH, or specify its location in the code.
- Place the
Note: Manual setup is only necessary if Selenium Manager is unable to manage the WebDriver automatically.
Contributions are welcome! Please visit the GitHub repository to report issues or submit pull requests.