| 1 | = Infrequently Asked Questions = |
| 2 | |
| 3 | == (and known bugs/problems) == |
| 4 | |
| 5 | You may also want to take a look at the [wiki:VsoFAQ Frequently Asked Questions] list. |
| 6 | |
| 7 | |
| 8 | == Questions == |
| 9 | |
| 10 | |
| 11 | === How do I file a problem report or suggestion for improvement? === |
| 12 | |
| 13 | |
| 14 | |
| 15 | We suggest you use |
| 16 | our general feedback form |
| 17 | '''[http://virtualsolar.org/feedback/ http://virtualsolar.org/feedback/]''', |
| 18 | or email your reports/comments/suggestions to: |
| 19 | ''VSO-AT-spd.aas.org''. You can also fill out our |
| 20 | '''[http://vso.stanford.edu/vso_feedback.html user survey]''' so we can |
| 21 | prioritize based on the needs of the user community. |
| 22 | |
| 23 | You should also check that you are using the most recent version |
| 24 | of VSO. The most recent link will always be available from the VSO homepage |
| 25 | at '''http://virtualsolar.org/'''. |
| 26 | |
| 27 | === I have a digital data archive and I would like to make the data available through VSO. What do I have to do? === |
| 28 | |
| 29 | Please contact one of the VSO scientists (Rick Bogart, Joe Gurman, Frank Hill, |
| 30 | Piet Martens) and let us know of your interest. Extension of data service |
| 31 | providers is the highest priority for VSO. We have an adoptor's kit, and |
| 32 | assistance available to help tie your archive into VSO. |
| 33 | |
| 34 | The majority of the work from the provider is in attempting to describe |
| 35 | your holdings in terms of the VSO Data Model, so that the VSO has |
| 36 | accurate information about the type of information that your organization |
| 37 | providers. |
| 38 | |
| 39 | === Are there limits to the number of query results returned? If so, what are they? === |
| 40 | |
| 41 | Yes. Each data provider may have limits to prevent their systems |
| 42 | from returning exceptionally large results. Because of the way in which |
| 43 | VSO breaks queries down into simpler queries for the individual data |
| 44 | providers to process, it is difficult to say just how many records an |
| 45 | individual data provider will return. |
| 46 | |
| 47 | === How do I know if the number of query results was truncated by the data server? === |
| 48 | |
| 49 | The results page lists two numbers -- the number of records returned, and the |
| 50 | number of records found. If the two are not equal, it means that one the |
| 51 | data providers has reached its internal limit, and not returned all of its |
| 52 | records that matched the query. If the number of records found is not displayed, |
| 53 | it suggests that the data provider had reached its limit, but did not determine |
| 54 | how many additional records there were. [This should only occur if the cost in |
| 55 | performing an exhaustive search would be prohibitive]. |
| 56 | |
| 57 | We are trying to find a good balance between obtaining the desired results, |
| 58 | while preventing there from being an undue burden on individual data archives, |
| 59 | and the mechanisms for handling this scenario may be changed in the future. |
| 60 | |
| 61 | === When I request data, do they have to go through the VSO? How long does it take to get the data? === |
| 62 | |
| 63 | No data go through VSO. VSO only handles the process of locating, and ordering |
| 64 | the data. The actual data delivery is handled by the user and the individual |
| 65 | data providers, although it is possible that some user interfaces may add |
| 66 | additional value by automatically following URLs to download information. |
| 67 | For more information about the transfer of data, see the |
| 68 | '''[http://vso1.nascom.nasa.gov/API/VSO_API.html#negotiation API documentation on Transfer Negotiation]'''. Additional information is available |
| 69 | for the '''[http://vso.nascom.nasa.gov/cgi-bin/show_details.pl?keyword=PROVIDER data providers]''', but |
| 70 | is currently in the process of being updated. |
| 71 | |
| 72 | === When I submit a query, at the end of the list of results it says Session ID: followed by a long incomprehensible hexadecimal string. What does it mean? === |
| 73 | |
| 74 | You may be using an older version of VSO. Please make sure you are |
| 75 | connecting to the most recent |
| 76 | '''[http://vso.nascom.nasa.gov/cgi-bin/search VSO Search Interface]'''. We are experimenting with mechanisms for recording |
| 77 | search parameters and/or results (at the option of the user), so that |
| 78 | any particular |
| 79 | useful query can automatically be regenerated if desired, or referred to |
| 80 | in publication of results. |
| 81 | |
| 82 | |
| 83 | |
| 84 | === All queries seem to go through and require the (''some organization'') VSO site. What is virtual about the Virtual Solar Observatory? === |
| 85 | |
| 86 | There originally was a single prototype implementation at Stanford. That has |
| 87 | since been replaced with a system that is distributed across Stanford, NASA, |
| 88 | and NSO, not including the functionality at each of the individual data |
| 89 | providers. |
| 90 | |
| 91 | What is virtual about VSO is that there is no one master archive or |
| 92 | database of all of the holdings. There is a point of entry that users |
| 93 | or applications can interact with, to access data that is spread across multiple |
| 94 | systems. This concept is commonly refered to as 'Data Virtualization'. Additionally, |
| 95 | there is virtualization on another scale, as there is no one single server -- |
| 96 | Although there is a reference system, at |
| 97 | '''http://virtualsolar.org/''', its |
| 98 | purpose is to provide a unified starting point to people new to the VSO, |
| 99 | and is not involved with the actual processing of the VSO, which currently |
| 100 | has multiplexors at SDAC, Stanford, and NSO. |
| 101 | |
| 102 | === The information in the server data registries does not always match what is actually searchable. Are the displayed data registries different from those used by the user interface? === |
| 103 | |
| 104 | Please '''[wiki:ContactUs send us details]''' |
| 105 | about what you have found that doesn't seem to be in agreement, or |
| 106 | what query you used, that you had expected data to be returned for. |
| 107 | |
| 108 | === What do all the funny colors on the results pages mean? === |
| 109 | |
| 110 | For ease of navigating among large numbers of return results, every |
| 111 | fifth entry from each data provider is highlighted in yellow, every |
| 112 | tenth in green, and every hundredth in blue. No special significance |
| 113 | attaches to these entries. |
| 114 | |
| 115 | |
| 116 | == Problems == |
| 117 | |
| 118 | === When I query data from the (Montana State University|Mauna Loa) archive, I get lists in which apparently identical data sets are reproduced from two to seven times. When I download these data sets, they are indeed identical. === |
| 119 | |
| 120 | Observations in the MSU Yohkoh SXT archive are catalogued individually but packaged |
| 121 | together in orbit files. If several observations in the same file match |
| 122 | the search criterion they will each return a record, but the records will |
| 123 | all point to the same distribution file. Downloading any one will of course |
| 124 | get you all the data in the orbit file. |
| 125 | |
| 126 | Observations in the MLSO archive are stored in both JPEG and FITS formats. |
| 127 | Although the observations occur in the listings twice, they point to |
| 128 | different data products. It is possible that this may change in the future, |
| 129 | depending on user feedback. #13 |
| 130 | |
| 131 | === I don't see any data from the McMath FTS Spectrometer, though it shows up in the NSO list of instruments. === |
| 132 | |
| 133 | The VSO has helped us to shed light on the fact that some metadata |
| 134 | are not correct. In this particular case, most of the datasets listed |
| 135 | from the Kitt Peak 512-Channel Magnetograph |
| 136 | and from the Evans Spectroheliograph have end times earlier than the start |
| 137 | times. Occasionally there are multiple entries that are apparently identical |
| 138 | (e.g. KPVT Magnetograph 1993.04.10). |
| 139 | |
| 140 | === I don't see any data for the last day of my time range request from the GOLF instrument, even though I know it is there; it shows up if I extend the range of time by even one minute. === |
| 141 | |
| 142 | Please make sure you are using the most recent version of VSO. Early versions |
| 143 | of VSO required the observation to be completely contained within the search |
| 144 | range. The current implementation performs range matching by searching for |
| 145 | non-vanishing intersection. |
| 146 | |
| 147 | |
| 148 | === When I query the Stanford Heleioseismology Archive for ground-based data I sometimes see records whose start and end times are both outside my requested time interval. === |
| 149 | |
| 150 | Range matches (in this case, time range), is done by finding a non-vanishing |
| 151 | intersection. If you would prefer a different type of range matching, please |
| 152 | '''[wiki:ContactUs let us know]''', so we can |
| 153 | prioritize new functionality. |
| 154 | |
| 155 | The Stanford datasets are generally for sets of images spanning a long |
| 156 | time interval, typically a day for ground-based instruments. Although |
| 157 | the datasets have registered start and end times corresponding to the |
| 158 | first and last images of the day, they are in fact searched by an index |
| 159 | number corresponding to the day number, starting at local midnight. |
| 160 | In order to assure that no relevant records are missed from sites whose |
| 161 | observations can span two UT days, the Stanford server returns matches |
| 162 | for both day numbers. |