The Wide-field Retrieval of Astrodata Program (WRAP) is a versatile tool designed to simplify the retrieval of photometric and astrometric data from a wide range of ultraviolet, optical, and near-infrared catalogs. Users input Right Ascension (RA) and Declination (DEC) coordinates, along with a search radius for their object of interest. The program then enables users to interactively select their object by simply clicking on it within catalog images. WRAP efficiently compiles and presents all pertinent photometric and astrometric information obtained from the selected catalogs, making it accessible in a convenient CSV file. This streamlines the data retrieval process, enhancing the user's experience
-
Download Git: To get started, you'll need to install Git, which is a version control system. You can download the official Git installer for your operating system from Git's official website.
-
Verification: After installation, you can verify that Git is properly installed by opening a terminal or command prompt and running the following command:
git --version
Note: Making use of an Anaconda (Conda) environment is highly recommended due to potential compatibility issues with older Python and pip packages when using WRAP.
-
Download Anaconda Navigator: To get started, please visit Anaconda's official website and download the version of Anaconda Navigator that matches your operating system.
-
Access Anaconda Environments: After downloading and installing Anaconda Navigator, launch the application. In the Navigator's main window, you will find an "Environments" option on the left. Click on it to access your Conda environments.
-
Create a New Conda Environment: In the "Environments" section, you will see a plus sign labeled "Create." Click on it to create a new Conda environment.
-
Customize Environment Settings: Give your new environment a name of your choice (e.g., "WRAP"). Next, select a Python version that is closest to Python 3.8 (e.g., 3.8.18). Then, click the "Create" button to create the environment.
-
Environment Creation: The environment creation process may take a while, as Conda will install the necessary packages and dependencies for WRAP.
-
Activate Your Conda Environment: Once the environment is successfully created, you can activate it in your terminal. Open your terminal and enter the following command, replacing
*conda name*
with the name you chose for your environment:conda activate *conda name*
โฌ๏ธ PIP Installation โฌ๏ธ
MacOS
- Once the conda environment is activated, go to your directory containing the WRAP contents (e.g., "cd Documents/GitHub/WRAP").
- Enter the "pip_module" directory (e.g., "cd pip_module")
- Run the command:
pip install -r requirements-mac.txt
Windows
- Once the conda environment is activated, go to your directory containing the WRAP contents (e.g., "cd Documents/GitHub/WRAP").
- Enter the "pip_module" directory (e.g., "cd pip_module")
- Run the command:
pip install -r requirements-windows.txt
To open the application, type the following command into your terminal:
- For MacOS:
python3 WRAP.py
- For Windows:
python3 .\WRAP.py
How to Use WRAP
Single Object Search
- Input the Right Ascension (RA) and Declination (DEC) of the object being searched for in degrees.
- Input the search radius in arcseconds around the RA and DEC.
- Specify the desired output file name (without a file type). WRAP will save results to a CSV file by default.
- Select the catalogs to be searched through.
- Click the green "Run Wrap" button.
- Your standard web browser will open with WISEView to assist you in finding your object.
- Click on your object when the image appears (if your object is not there, click the red "Object Not Found" button).
- Repeat these steps until every catalog image is shown.
- All data is saved to a CSV file with your specified output name in the "Output" folder. If no output name was provided, it will default to "WRAP_output.csv."
Multi-Object Search
- Click the "Browse" button and select your file with a list of RA ("ra") and DEC ("dec") coordinates in degrees.
- Input the search radius in arcseconds around the RA and DEC.
- Choose the file type used.
- Specify the output file name (without a file type).
- Select the catalogs to be searched through.
- Click the green "Run Wrap" button.
- Your standard web browser will open with WISEView to assist you in finding your object (it will do this for every new object).
- Click on your object when the image appears (if your object is not there, click the red "Object Not Found" button).
- Repeat these steps until every catalog image is shown, and every object has been processed.
- All data is saved to a CSV file with your specified output name in the "Output" folder. If no output name was provided, it will default to "WRAP_output.csv."
-----------------------------------------
- Note 1: Only tested on MacOS >11 and Windows >8; problems may occur for older versions of MacOS and Windows (NOT SUPPORTED ON LINUX).
- Note 2: Windows does not support the astro-datalab package; therefore, Windows does not have the Noirlab Source Catalog option.
- Note 3: The window close button has been disabled; to close WRAP, please click the red "Close WRAP" button at the bottom.
- Note 4: The orientation for all of the catalogs is North pointed up and East pointing left.
- Note 5: 2MASS may have strange imaging cropping; this is a warning that it may happen, so do not be alarmed by it.
Sky-Coverage for the Catalogs Included in WRAP
- Mr. Hunter Brooks
- Email: [email protected]
-
If you intend to publish any of the data gathered by WRAP, please ensure that you correctly acknowledge the sources of the data.
-
In addition to using the correct acknowledgments for each catalog, please cite "Brook et al. (2023), in prep." when using WRAP for any publication.