|
Size: 2312
Comment:
|
Size: 12316
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| = DATA GUIDE = | ''''' Preamble (please read)''''' There are a wide range of tools available to access AIA data and images. They were designed to suit users with a wide variety of needs. This page guides a user through the AIA data system based on their needs and interests. First and foremost, a user should understand why a versatile data system is necessary. An AIA full-resolution image has 4096x4096 pixels, and AIA has [#Channels | ten different AIA wave bands, or channels]. A single full-resolution JPEG can be up to 10 MB in size (a single uncompressed science data file can be dozens of MB) and the AIA performs these observations continuously at a rate of approximately 1 image per second. With previous solar missions, it was not unusual for a user to request a few hours of data. In the case of the AIA, this request would amount to over half a terabyte of data. Even one hour of images at a single wavelength is on the order of 10 GB in size. It is clear that a simple data access system is not suitable for the AIA. We have devised a number of tools so that the user can access specific data sets as quickly as possible. ''Please note: This guide does not contain the full range of tools and resources available to AIA data users. The user has a great deal of flexibility, and there is no single "correct" way to identify, obtain, and analyze AIA data. It is hoped that this guide will help the user get started with AIA data, and that users will familiarize themselves with the additional resources over time.'' [[TableOfContents]] == Determining which data you want == === I need to browse through some data before I can decide what data I'd like to request. === You can browse full-disk movies of the Sun in all of the AIA wavelengths on the SDO Browse Data page. These movies are lower resolution (512x512 or 1024x1024) and are much lower cadence (15 minutes). There are also daily 1024x1024 movies for each AIA wavelength. |
| Line 7: | Line 20: |
| === I'd like a more detailed look instead of just a "browse." === | |
| Line 8: | Line 22: |
| == Section I: Determining which data you want == | Helioviewer is a versatile tool that allows the user to view images and movies from multiple data sources, zoom in on specific regions and view zoomed-in movies, and overlay the images in multiple layers to compare features and structure. Helioviewer also has the capability to track a region, meaning that the viewing box moves with the Sun's rotation. The result can be saved as a link and accessed at a later date. |
| Line 10: | Line 24: |
| === Section I.a: I need to browse through some data before I can decide what data I'd like to request. === === Section I.b: I'd like a more detailed look instead of just a "browse." === === Section I.c: I'm looking for a specific feature, event or phenomenon but I haven't determined the date/times of the images I need. === === Section I.d: I know the start time and end time of the event or phenomenon I'd like to study, but I don't know which wavelength(s). === |
A full-resolution AIA image is 4096x4096 pixels, and standard displays are not able to show anything near that size. Helioviewer allows the user to choose between viewing the whole Sun in (much) lower resolution, or viewing a subfield at better or even full resolution. |
| Line 16: | Line 26: |
| == Section II: Accessing the data == === Section II.a: I want images and/or a movie, and I don't need the full science data files. === === Section II.b: I need FITS data files, and I think I know the time range and wavelengths of the images I want. === === Section II.c: I need FITS data files, I know the time range and wavelengths of the images I want, but the available data volume is overwhelming. === ==== Case 1: Using subfields/cutouts Section II.d: I need FITS data files, I know the time range and wavelengths of the images I want, but the available data volume is overwhelming. ==== ==== Case 2: Decreasing the temporal or spatial resolution ==== == Section III: Analyzing the data == === Section III.a: Well, well, well. So what have we here? === === Section III.b: What analysis tools are available? === === Section III.c: What are the limitations of the data? === === Section III.d: I'm ready to publish. Who do I acknowledge? === == Appendix I: IDL and the SolarSoft software tree == === Appendix I.a: What is IDL? === === Appendix I.b: What is SolarSoft? === === Appendix I.c: I have IDL, but I don't have the SolarSoft software tree on my computer. === === Appendix I.d: I have the SolarSoft software tree on my computer, but I'm not sure if I have the appropriate software packages installed. === |
A desktop version, called JHelioviewer, can be downloaded onto your computer. The user is able to create movies and export them in MPEG or Quicktime format. |
| Line 40: | Line 29: |
| === I'm looking for a specific feature, event or phenomenon but I haven't determined the date/times of the images I need. === Most of the features or events a user would need have already been assembled in the Heliophysics Events Knowledgebase. The HEK is a comprehensive catalog of many items, including Active Regions, CMEs, Coronal Dimmings, Coronal Holes, Coronal Jets, Coronal Waves, Emerging Fluxs, Filaments, Filament Eruptions, Filament Activations, Flares, Loops, Oscillations, Sigmoids, SpraySurges, Sunspots, and Plages (complete list here). It also contains data, images and movies that have already been assembled for a given event, as well as comments and annotations entered by other users. Prior to using the HEK, it is highly recommended that you view the brief HEK tutorial to familiarize yourself with all of the features and options. === I know the start time and end time of the event or phenomenon I'd like to study, but I don't know which wavelength(s). === The AIA has seven EUV channels and three UV-Visible channels. These channels correspond to different characteristic temperatures and different regions of the solar atmosphere, ranging from 5000 degrees to over 10 million degrees. To see what each of the wavelengths look like and view a recent movie, go to helioviewer or the SDO Browse Data page. However, browsing the Heliophysics Events Knowledgebase is probably the best way to determine which wavelength(s) are most appropriate for your topic of interest. == Accessing the data == === I want images and/or a movie, and I don't need the full science data files. === Science data files are in the FITS format. Each uncompressed full-res FITS file is dozens of MB in size, whereas a full-res JPEG on the order of 10 MB or less. Therefore, it is to your advantage if jpegs or movies are sufficient. The tools described above in Section I should be able to provide you with any images or movies you need. === I need FITS data files, and I think I know the time range and wavelengths of the images I want. === First and foremost, you must make certain that the data you've identified is manageable in volume. Full-resolution uncompressed FITS files are dozens of MB in size, and the AIA makes approximately one observation per second. A request for all of the 304 Å files for the duration of a typical eruption, for example, can result in a file tens of gigabytes large, which can take upwards of a day to download with a standard DSL or cable internet connection. You may want to use a tool such as the Internet Connection Speedometer to determine your download speed before you decide how large a reasonable data request would be. Another consideration is how much data your computer will be able to store and analyze once the data has been downloaded. === I need FITS data files, I know the time range and wavelengths of the images I want, but the available data volume is overwhelming. Case 1: Using subfields/cutouts === More often than not, this is the situation of an AIA data user. There are four options: reduce cadence, reduce the number of wavelengths, reduce resolution, or request only a subfield of the images rather than the full solar disk. For the vast majority of analysis efforts, the full 4096x4096 image is not needed. Subfield data utilities allow the user to zooming in on only the portion of the image they need, thereby drastically reducing the volume of data. Each Heliophysics Events Knowledgebase event listing links to the Cutout Service, which allows the user to choose a subfield of data and request only that data. This can drastically reduce the volume of data the user will download. The figure at left shows a window of the cutout service. Users identify the region of the Sun they'd like to examine, shown as a pink outline box in the upper left portion of the figure. For this example, the subfield is less than 10% of the size of the total image making the data volume much more tractable. The Cutout Service also has a "tracking" option that automatically moves the observation boundaries to compensate for solar rotation. This is very useful when the user wants to studying a feature (such as an active region) for an extended period. ==== I need FITS data files, I know the time range and wavelengths of the images I want, but the available volume is overwhelming. Case 2: Decreasing the temporal or spatial resolution ==== The Virtual Solar Observatory search tools provide the user with a great deal of flexibility in accessing solar data. There is a search interface on the VSO website, (Joe & Joe, which link do you prefer?) but there is also an IDL interface provided within the SolarSoft library that allows the user to integrate their data search, retrieval, and analysis efforts. The two key SolarSoft functions are vso_search.pro and vso_get.pro. vso_search.pro allows the user to query a vast database of solar data and set requirements regarding timing, data source, data type, resolution, as well as other options. This is an example of a vso_search.pro query: {{{ IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304') Records Returned : JSOC : 50/50 Records Returned : JSOC : 7/7' }}} The search query returned records for 57 AIA 304 Å images that are available. (The SDO JSOC, or Joint Science Operations Center, provides AIA and HMI data.) 50 of the records are full resolution (4096x4096 pixels), and 7 of the records are quarter resolution (1024x1024 pixels). To choose only one or the other, the query can be further refined: {{{ IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304', pixel=4096) Records Returned : JSOC : 50/50 IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304', pixel=1024) Records Returned : JSOC : 7/7 }}} The search returned fewer quarter-resolution images than there are full-res images because the sampling rate of the lower resolution images is approximately 1/6 slower than the nominal AIA image cadence of 12 seconds per image. ''''' Note: ''''' All of the AIA images are available at the full resolution. Quarter-resolution images are created by binning down the 4096x4096 images. The quarter-res images are being made available in order to serve users who would like to work with AIA data but do not require full resolution. If you would like to obtain data at a specific time cadence, you can tell vso_search.pro to filter the query at a lower sampling rate (in this case, 3 minutes): {{{ IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304', pixel=4096, sample=180) Records Returned : JSOC : 4/4 }}} The query returns full-resolution 304 Å image spaced 3 minutes apart, instead of the nominal one image per twelve seconds. There are a great deal more keywords and options available. Please see Appendix II of this document for a more complete (yet still partial) set of options and examples. Once you've identified which files in the query you'd like to obtain, vso_get.pro transfers the data to your local directory: {{{ IDL> getfile = vso_get(searchfile(6),filelist=filelist) VSO_GET: This will download 1 file(s) 1 : http://vso.tuc.noao.edu/cgi-bin/drms_test/drms_export.cgi?series=aia_synoptic2;record=304_11763447-11763447 % RDWRT_BUFF: Please wait. Downloading... % File: /cgi-bin/drms_test/drms_export.cgi?series=aia_synoptic2;record=304_11763447-11763447 % Size: 4210560 bytes % From: vso.tuc.noao.edu % To: /Users/barbara/data % HTTP::COPY: 4210560 bytes of 4210560 total bytes copied in 2.73 seconds % HTTP::COPY: Wrote 4210560 bytes to file /Users/barbara/data/aia_test.synoptic2.304A_2010-07-20T14_10_02.12Z.image_lev1p5.fits Downloading completed }}} The keyword "filelist" provides the local name of the file(s): {{{ IDL> print, filelist(0) /Users/barbara/data/aia_test.synoptic2.304A_2010-07-20T14_10_02.12Z.image_lev1p5.fits }}} == Analyzing the data == === Well, well, well. So what have we here? === === What analysis tools are available? === === Section III.c: What are the limitations of the data? === === Section III.d: I'm ready to publish. Who do I acknowledge? === == Appendix I: IDL and the SolarSoft software tree == === Appendix I.a: What is IDL? === === Appendix I.b: What is SolarSoft? === === Appendix I.c: I have IDL, but I don't have the SolarSoft software tree on my computer. === === Appendix I.d: I have the SolarSoft software tree on my computer, but I'm not sure if I have the appropriate software packages installed. === |
|
| Line 41: | Line 135: |
=== Appendix II.a: Searching the VSO catalog using vso_search.pro === === Appendix II.b: Retrieving data with vso_get.pro === |
=== Appendix II.a: Searching the VSO catalog using vso_search.pro === === Appendix II.b: Retrieving data with vso_get.pro === |
| Line 50: | Line 142: |
| CategoryHomepage | CategoryHomepage |
Preamble (please read)
- There are a wide range of tools available to access AIA data and images. They were designed to suit users with a wide variety of needs. This page guides a user through the AIA data system based on their needs and interests. First and foremost, a user should understand why a versatile data system is necessary. An AIA full-resolution image has 4096x4096 pixels, and AIA has [#Channels | ten different AIA wave bands, or channels]. A single full-resolution JPEG can be up to 10 MB in size (a single uncompressed science data file can be dozens of MB) and the AIA performs these observations continuously at a rate of approximately 1 image per second. With previous solar missions, it was not unusual for a user to request a few hours of data. In the case of the AIA, this request would amount to over half a terabyte of data. Even one hour of images at a single wavelength is on the order of 10 GB in size. It is clear that a simple data access system is not suitable for the AIA. We have devised a number of tools so that the user can access specific data sets as quickly as possible.
Please note: This guide does not contain the full range of tools and resources available to AIA data users. The user has a great deal of flexibility, and there is no single "correct" way to identify, obtain, and analyze AIA data. It is hoped that this guide will help the user get started with AIA data, and that users will familiarize themselves with the additional resources over time.
Determining which data you want
I need to browse through some data before I can decide what data I'd like to request.
- You can browse full-disk movies of the Sun in all of the AIA wavelengths on the SDO Browse Data page. These movies are lower resolution (512x512 or 1024x1024) and are much lower cadence (15 minutes). There are also daily 1024x1024 movies for each AIA wavelength.
I'd like a more detailed look instead of just a "browse."
- Helioviewer is a versatile tool that allows the user to view images and movies from multiple data sources, zoom in on specific regions and view zoomed-in movies, and overlay the images in multiple layers to compare features and structure. Helioviewer also has the capability to track a region, meaning that the viewing box moves with the Sun's rotation. The result can be saved as a link and accessed at a later date. A full-resolution AIA image is 4096x4096 pixels, and standard displays are not able to show anything near that size. Helioviewer allows the user to choose between viewing the whole Sun in (much) lower resolution, or viewing a subfield at better or even full resolution. A desktop version, called JHelioviewer, can be downloaded onto your computer. The user is able to create movies and export them in MPEG or Quicktime format.
I'm looking for a specific feature, event or phenomenon but I haven't determined the date/times of the images I need.
Most of the features or events a user would need have already been assembled in the Heliophysics Events Knowledgebase. The HEK is a comprehensive catalog of many items, including Active Regions, CMEs, Coronal Dimmings, Coronal Holes, Coronal Jets, Coronal Waves, Emerging Fluxs, Filaments, Filament Eruptions, Filament Activations, Flares, Loops, Oscillations, Sigmoids, SpraySurges, Sunspots, and Plages (complete list here). It also contains data, images and movies that have already been assembled for a given event, as well as comments and annotations entered by other users. Prior to using the HEK, it is highly recommended that you view the brief HEK tutorial to familiarize yourself with all of the features and options.
I know the start time and end time of the event or phenomenon I'd like to study, but I don't know which wavelength(s).
- The AIA has seven EUV channels and three UV-Visible channels. These channels correspond to different characteristic temperatures and different regions of the solar atmosphere, ranging from 5000 degrees to over 10 million degrees. To see what each of the wavelengths look like and view a recent movie, go to helioviewer or the SDO Browse Data page. However, browsing the Heliophysics Events Knowledgebase is probably the best way to determine which wavelength(s) are most appropriate for your topic of interest.
Accessing the data
I want images and/or a movie, and I don't need the full science data files.
- Science data files are in the FITS format. Each uncompressed full-res FITS file is dozens of MB in size, whereas a full-res JPEG on the order of 10 MB or less. Therefore, it is to your advantage if jpegs or movies are sufficient. The tools described above in Section I should be able to provide you with any images or movies you need.
I need FITS data files, and I think I know the time range and wavelengths of the images I want.
- First and foremost, you must make certain that the data you've identified is manageable in volume. Full-resolution uncompressed FITS files are dozens of MB in size, and the AIA makes approximately one observation per second. A request for all of the 304 Å files for the duration of a typical eruption, for example, can result in a file tens of gigabytes large, which can take upwards of a day to download with a standard DSL or cable internet connection. You may want to use a tool such as the Internet Connection Speedometer to determine your download speed before you decide how large a reasonable data request would be. Another consideration is how much data your computer will be able to store and analyze once the data has been downloaded.
I need FITS data files, I know the time range and wavelengths of the images I want, but the available data volume is overwhelming. Case 1: Using subfields/cutouts
- More often than not, this is the situation of an AIA data user. There are four options: reduce cadence, reduce the number of wavelengths, reduce resolution, or request only a subfield of the images rather than the full solar disk. For the vast majority of analysis efforts, the full 4096x4096 image is not needed. Subfield data utilities allow the user to zooming in on only the portion of the image they need, thereby drastically reducing the volume of data.
- Each Heliophysics Events Knowledgebase event listing links to the Cutout Service, which allows the user to choose a subfield of data and request only that data. This can drastically reduce the volume of data the user will download. The figure at left shows a window of the cutout service. Users identify the region of the Sun they'd like to examine, shown as a pink outline box in the upper left portion of the figure. For this example, the subfield is less than 10% of the size of the total image making the data volume much more tractable. The Cutout Service also has a "tracking" option that automatically moves the observation boundaries to compensate for solar rotation. This is very useful when the user wants to studying a feature (such as an active region) for an extended period.
I need FITS data files, I know the time range and wavelengths of the images I want, but the available volume is overwhelming. Case 2: Decreasing the temporal or spatial resolution
The Virtual Solar Observatory search tools provide the user with a great deal of flexibility in accessing solar data. There is a search interface on the VSO website, (Joe & Joe, which link do you prefer?) but there is also an IDL interface provided within the SolarSoft library that allows the user to integrate their data search, retrieval, and analysis efforts.
The two key SolarSoft functions are vso_search.pro and vso_get.pro. vso_search.pro allows the user to query a vast database of solar data and set requirements regarding timing, data source, data type, resolution, as well as other options. This is an example of a vso_search.pro query:
IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304')
Records Returned : JSOC : 50/50
Records Returned : JSOC : 7/7'
- The search query returned records for 57 AIA 304 Å images that are available. (The SDO JSOC, or Joint Science Operations Center, provides AIA and HMI data.) 50 of the records are full resolution (4096x4096 pixels), and 7 of the records are quarter resolution (1024x1024 pixels). To choose only one or the other, the query can be further refined:
IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304', pixel=4096)
Records Returned : JSOC : 50/50
IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304', pixel=1024)
Records Returned : JSOC : 7/7- The search returned fewer quarter-resolution images than there are full-res images because the sampling rate of the lower resolution images is approximately 1/6 slower than the nominal AIA image cadence of 12 seconds per image.
Note: All of the AIA images are available at the full resolution. Quarter-resolution images are created by binning down the 4096x4096 images. The quarter-res images are being made available in order to serve users who would like to work with AIA data but do not require full resolution. If you would like to obtain data at a specific time cadence, you can tell vso_search.pro to filter the query at a lower sampling rate (in this case, 3 minutes):
IDL> searchfile = vso_search('2010-jul-20 14:00','2010-jul-20 14:10', instr='aia', wave='304', pixel=4096, sample=180)
Records Returned : JSOC : 4/4- The query returns full-resolution 304 Å image spaced 3 minutes apart, instead of the nominal one image per twelve seconds. There are a great deal more keywords and options available. Please see Appendix II of this document for a more complete (yet still partial) set of options and examples. Once you've identified which files in the query you'd like to obtain, vso_get.pro transfers the data to your local directory:
IDL> getfile = vso_get(searchfile(6),filelist=filelist)
VSO_GET: This will download 1 file(s)
1 : http://vso.tuc.noao.edu/cgi-bin/drms_test/drms_export.cgi?series=aia_synoptic2;record=304_11763447-11763447
% RDWRT_BUFF: Please wait. Downloading...
% File: /cgi-bin/drms_test/drms_export.cgi?series=aia_synoptic2;record=304_11763447-11763447
% Size: 4210560 bytes
% From: vso.tuc.noao.edu
% To: /Users/barbara/data
% HTTP::COPY: 4210560 bytes of 4210560 total bytes copied in 2.73 seconds
% HTTP::COPY: Wrote 4210560 bytes to file /Users/barbara/data/aia_test.synoptic2.304A_2010-07-20T14_10_02.12Z.image_lev1p5.fits
Downloading completed- The keyword "filelist" provides the local name of the file(s):
IDL> print, filelist(0)
/Users/barbara/data/aia_test.synoptic2.304A_2010-07-20T14_10_02.12Z.image_lev1p5.fits
Analyzing the data
Well, well, well. So what have we here?
What analysis tools are available?
Section III.c: What are the limitations of the data?
Section III.d: I'm ready to publish. Who do I acknowledge?
Appendix I: IDL and the SolarSoft software tree
Appendix I.a: What is IDL?
Appendix I.b: What is SolarSoft?
Appendix I.c: I have IDL, but I don't have the SolarSoft software tree on my computer.
Appendix I.d: I have the SolarSoft software tree on my computer, but I'm not sure if I have the appropriate software packages installed.
Appendix II: Identifying and retrieving data using the Virtual Solar Observatory's IDL interface
Appendix II.a: Searching the VSO catalog using vso_search.pro
Appendix II.b: Retrieving data with vso_get.pro
Email: MailTo(you AT SPAMFREE example DOT com)
...
