{"action":"created","comment":{"url":"https://api.github.com/repos/obspy/obspy/pulls/comments/34326767","id":34326767,"diff_hunk":"@@ -2,43 +2,123 @@\n Retrieving Data from Data Centers\n =================================\n \n-----------------\n-ArcLink Protocol\n-----------------\n-\n-In the following example uses the :mod:`obspy.arclink` module in order to\n-retrieve waveforms data as well as poles and zeros from a remote server\n-via the `ArcLink <http://www.seiscomp3.org/wiki/doc/applications/arclink>`_\n-protocol. The retrieved poles and zeros are then used to correct for the\n-instrument response and to simulate a 1Hz instrument with damping 0.707.\n+This section is intended as a small guide to help you choose the best way to\n+download data for a given purpose using ObsPy. Keep in mind that data centers\n+and web services are constantly changing so this recommendation might not be\n+valid anymore at the time you read this. For actual code examples, please see\n+the documentation of the various modules.\n \n .. note::\n-    The default client needs to open port 18002 to the host webdc.eu via TCP/IP\n-    in order to download the requested data. Please make sure that no firewall\n-    is blocking access to this server/port combination.\n+\n+    The most common use case is likely to download waveforms and event/station\n+    meta information. In almost all cases you will want to use the\n+    :mod:`obspy.fdsn` module for this. It supports the largest amount of data\n+    centers and uses the most modern data formats. There are still a number of\n+    reasons to choose a different module but please make sure you have one.\n+\n+---------------------\n+The FDSN Web Services\n+---------------------\n+\n++----------------------+--------------------------------+\n+| Available Data Types | Format                         |\n++======================+================================+\n+| Waveforms            | MiniSEED and optionally others |\n++----------------------+--------------------------------+\n+| Station Information  | StationXML and Text            |\n++----------------------+--------------------------------+\n+| Event Information    | QuakeML and Text               |\n++----------------------+--------------------------------+\n \n .. note::\n-    The ``user`` keyword in the following example is used for identification\n-    with the ArcLink server as well as for usage statistics within the data\n-    center, so please provide a meaningful user id such as your email address.\n \n-.. plot:: tutorial/code_snippets/retrieving_data_from_datacenters_1.py\n-   :include-source:\n+    Not all data providers offer all three data types. Many offer only one or two.\n+\n+If you want to requests waveforms, or station/event meta information **you will\n+most likely want to use the** :mod:`obspy.fdsn` **module**. It is able to\n+request data from any data center implementing the `FDSN web services\n+<http://www.fdsn.org/webservices/>`_. Data from a large number of centers like","path":"misc/docs/source/tutorial/code_snippets/retrieving_data_from_datacenters.rst","position":56,"original_position":56,"commit_id":"104afc565a05fcd01f66213b54166f159ffa2342","original_commit_id":"104afc565a05fcd01f66213b54166f159ffa2342","user":{"login":"QuLogic","id":302469,"avatar_url":"https://avatars.githubusercontent.com/u/302469?v=3","gravatar_id":"","url":"https://api.github.com/users/QuLogic","html_url":"https://github.com/QuLogic","followers_url":"https://api.github.com/users/QuLogic/followers","following_url":"https://api.github.com/users/QuLogic/following{/other_user}","gists_url":"https://api.github.com/users/QuLogic/gists{/gist_id}","starred_url":"https://api.github.com/users/QuLogic/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/QuLogic/subscriptions","organizations_url":"https://api.github.com/users/QuLogic/orgs","repos_url":"https://api.github.com/users/QuLogic/repos","events_url":"https://api.github.com/users/QuLogic/events{/privacy}","received_events_url":"https://api.github.com/users/QuLogic/received_events","type":"User","site_admin":false},"body":"s/like/such as/\r\ns/large/great/ or s/large/high/ but the sentence still seems of either way.","created_at":"2015-07-10T04:20:32Z","updated_at":"2015-07-10T04:20:32Z","html_url":"https://github.com/obspy/obspy/pull/1091#discussion_r34326767","pull_request_url":"https://api.github.com/repos/obspy/obspy/pulls/1091","_links":{"self":{"href":"https://api.github.com/repos/obspy/obspy/pulls/comments/34326767"},"html":{"href":"https://github.com/obspy/obspy/pull/1091#discussion_r34326767"},"pull_request":{"href":"https://api.github.com/repos/obspy/obspy/pulls/1091"}}},"pull_request":{"url":"https://api.github.com/repos/obspy/obspy/pulls/1091","id":39578341,"html_url":"https://github.com/obspy/obspy/pull/1091","diff_url":"https://github.com/obspy/obspy/pull/1091.diff","patch_url":"https://github.com/obspy/obspy/pull/1091.patch","issue_url":"https://api.github.com/repos/obspy/obspy/issues/1091","number":1091,"state":"open","locked":false,"title":"Reworking Data Download Tutorial","user":{"login":"krischer","id":800487,"avatar_url":"https://avatars.githubusercontent.com/u/800487?v=3","gravatar_id":"","url":"https://api.github.com/users/krischer","html_url":"https://github.com/krischer","followers_url":"https://api.github.com/users/krischer/followers","following_url":"https://api.github.com/users/krischer/following{/other_user}","gists_url":"https://api.github.com/users/krischer/gists{/gist_id}","starred_url":"https://api.github.com/users/krischer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krischer/subscriptions","organizations_url":"https://api.github.com/users/krischer/orgs","repos_url":"https://api.github.com/users/krischer/repos","events_url":"https://api.github.com/users/krischer/events{/privacy}","received_events_url":"https://api.github.com/users/krischer/received_events","type":"User","site_admin":false},"body":"In response to a confusion about data downloading on the mailing list (http://lists.swapbytes.de/archives/obspy-users/2015-July/001743.html) I reworked the data download tutorial to give up to date recommendations.\r\n\r\nPlease have a look as this is fairly opinionated. A rendered version can be found [here](http://www.geophysik.uni-muenchen.de/~krischer/_build/tutorial/code_snippets/retrieving_data_from_datacenters.html).\r\n\r\nAdditionally this PR removes the bundled `sphinx.ext.autosummary` as it is bundled with sphinx > 0.6. This more or less makes our docs compatible with Sphinx 1.3.\r\n\r\n**Don't merge yet as there still are some small issues with the autosummary extension!**","created_at":"2015-07-09T12:39:55Z","updated_at":"2015-07-10T04:20:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":"12105156d247daf6c3af3930f162a548efad2354","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/obspy/obspy/pulls/1091/commits","review_comments_url":"https://api.github.com/repos/obspy/obspy/pulls/1091/comments","review_comment_url":"https://api.github.com/repos/obspy/obspy/pulls/comments{/number}","comments_url":"https://api.github.com/repos/obspy/obspy/issues/1091/comments","statuses_url":"https://api.github.com/repos/obspy/obspy/statuses/104afc565a05fcd01f66213b54166f159ffa2342","head":{"label":"krischer:data_retrieval","ref":"data_retrieval","sha":"104afc565a05fcd01f66213b54166f159ffa2342","user":{"login":"krischer","id":800487,"avatar_url":"https://avatars.githubusercontent.com/u/800487?v=3","gravatar_id":"","url":"https://api.github.com/users/krischer","html_url":"https://github.com/krischer","followers_url":"https://api.github.com/users/krischer/followers","following_url":"https://api.github.com/users/krischer/following{/other_user}","gists_url":"https://api.github.com/users/krischer/gists{/gist_id}","starred_url":"https://api.github.com/users/krischer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krischer/subscriptions","organizations_url":"https://api.github.com/users/krischer/orgs","repos_url":"https://api.github.com/users/krischer/repos","events_url":"https://api.github.com/users/krischer/events{/privacy}","received_events_url":"https://api.github.com/users/krischer/received_events","type":"User","site_admin":false},"repo":{"id":5830460,"name":"obspy","full_name":"krischer/obspy","owner":{"login":"krischer","id":800487,"avatar_url":"https://avatars.githubusercontent.com/u/800487?v=3","gravatar_id":"","url":"https://api.github.com/users/krischer","html_url":"https://github.com/krischer","followers_url":"https://api.github.com/users/krischer/followers","following_url":"https://api.github.com/users/krischer/following{/other_user}","gists_url":"https://api.github.com/users/krischer/gists{/gist_id}","starred_url":"https://api.github.com/users/krischer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krischer/subscriptions","organizations_url":"https://api.github.com/users/krischer/orgs","repos_url":"https://api.github.com/users/krischer/repos","events_url":"https://api.github.com/users/krischer/events{/privacy}","received_events_url":"https://api.github.com/users/krischer/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/krischer/obspy","description":"ObsPy: A Python Toolbox for seismology/seismological observatories.","fork":true,"url":"https://api.github.com/repos/krischer/obspy","forks_url":"https://api.github.com/repos/krischer/obspy/forks","keys_url":"https://api.github.com/repos/krischer/obspy/keys{/key_id}","collaborators_url":"https://api.github.com/repos/krischer/obspy/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/krischer/obspy/teams","hooks_url":"https://api.github.com/repos/krischer/obspy/hooks","issue_events_url":"https://api.github.com/repos/krischer/obspy/issues/events{/number}","events_url":"https://api.github.com/repos/krischer/obspy/events","assignees_url":"https://api.github.com/repos/krischer/obspy/assignees{/user}","branches_url":"https://api.github.com/repos/krischer/obspy/branches{/branch}","tags_url":"https://api.github.com/repos/krischer/obspy/tags","blobs_url":"https://api.github.com/repos/krischer/obspy/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/krischer/obspy/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/krischer/obspy/git/refs{/sha}","trees_url":"https://api.github.com/repos/krischer/obspy/git/trees{/sha}","statuses_url":"https://api.github.com/repos/krischer/obspy/statuses/{sha}","languages_url":"https://api.github.com/repos/krischer/obspy/languages","stargazers_url":"https://api.github.com/repos/krischer/obspy/stargazers","contributors_url":"https://api.github.com/repos/krischer/obspy/contributors","subscribers_url":"https://api.github.com/repos/krischer/obspy/subscribers","subscription_url":"https://api.github.com/repos/krischer/obspy/subscription","commits_url":"https://api.github.com/repos/krischer/obspy/commits{/sha}","git_commits_url":"https://api.github.com/repos/krischer/obspy/git/commits{/sha}","comments_url":"https://api.github.com/repos/krischer/obspy/comments{/number}","issue_comment_url":"https://api.github.com/repos/krischer/obspy/issues/comments{/number}","contents_url":"https://api.github.com/repos/krischer/obspy/contents/{+path}","compare_url":"https://api.github.com/repos/krischer/obspy/compare/{base}...{head}","merges_url":"https://api.github.com/repos/krischer/obspy/merges","archive_url":"https://api.github.com/repos/krischer/obspy/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/krischer/obspy/downloads","issues_url":"https://api.github.com/repos/krischer/obspy/issues{/number}","pulls_url":"https://api.github.com/repos/krischer/obspy/pulls{/number}","milestones_url":"https://api.github.com/repos/krischer/obspy/milestones{/number}","notifications_url":"https://api.github.com/repos/krischer/obspy/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/krischer/obspy/labels{/name}","releases_url":"https://api.github.com/repos/krischer/obspy/releases{/id}","created_at":"2012-09-16T15:34:42Z","updated_at":"2014-11-20T12:15:18Z","pushed_at":"2015-07-09T13:54:07Z","git_url":"git://github.com/krischer/obspy.git","ssh_url":"git@github.com:krischer/obspy.git","clone_url":"https://github.com/krischer/obspy.git","svn_url":"https://github.com/krischer/obspy","homepage":"https://github.com/obspy/obspy/wiki","size":63780,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"open_issues_count":0,"forks":2,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"obspy:releases","ref":"releases","sha":"e6c767971f4ebfc2d3ff090c6f7f1a99752323e6","user":{"login":"obspy","id":1701221,"avatar_url":"https://avatars.githubusercontent.com/u/1701221?v=3","gravatar_id":"","url":"https://api.github.com/users/obspy","html_url":"https://github.com/obspy","followers_url":"https://api.github.com/users/obspy/followers","following_url":"https://api.github.com/users/obspy/following{/other_user}","gists_url":"https://api.github.com/users/obspy/gists{/gist_id}","starred_url":"https://api.github.com/users/obspy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/obspy/subscriptions","organizations_url":"https://api.github.com/users/obspy/orgs","repos_url":"https://api.github.com/users/obspy/repos","events_url":"https://api.github.com/users/obspy/events{/privacy}","received_events_url":"https://api.github.com/users/obspy/received_events","type":"Organization","site_admin":false},"repo":{"id":5731348,"name":"obspy","full_name":"obspy/obspy","owner":{"login":"obspy","id":1701221,"avatar_url":"https://avatars.githubusercontent.com/u/1701221?v=3","gravatar_id":"","url":"https://api.github.com/users/obspy","html_url":"https://github.com/obspy","followers_url":"https://api.github.com/users/obspy/followers","following_url":"https://api.github.com/users/obspy/following{/other_user}","gists_url":"https://api.github.com/users/obspy/gists{/gist_id}","starred_url":"https://api.github.com/users/obspy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/obspy/subscriptions","organizations_url":"https://api.github.com/users/obspy/orgs","repos_url":"https://api.github.com/users/obspy/repos","events_url":"https://api.github.com/users/obspy/events{/privacy}","received_events_url":"https://api.github.com/users/obspy/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/obspy/obspy","description":"ObsPy: A Python Toolbox for seismology/seismological observatories.","fork":false,"url":"https://api.github.com/repos/obspy/obspy","forks_url":"https://api.github.com/repos/obspy/obspy/forks","keys_url":"https://api.github.com/repos/obspy/obspy/keys{/key_id}","collaborators_url":"https://api.github.com/repos/obspy/obspy/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/obspy/obspy/teams","hooks_url":"https://api.github.com/repos/obspy/obspy/hooks","issue_events_url":"https://api.github.com/repos/obspy/obspy/issues/events{/number}","events_url":"https://api.github.com/repos/obspy/obspy/events","assignees_url":"https://api.github.com/repos/obspy/obspy/assignees{/user}","branches_url":"https://api.github.com/repos/obspy/obspy/branches{/branch}","tags_url":"https://api.github.com/repos/obspy/obspy/tags","blobs_url":"https://api.github.com/repos/obspy/obspy/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/obspy/obspy/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/obspy/obspy/git/refs{/sha}","trees_url":"https://api.github.com/repos/obspy/obspy/git/trees{/sha}","statuses_url":"https://api.github.com/repos/obspy/obspy/statuses/{sha}","languages_url":"https://api.github.com/repos/obspy/obspy/languages","stargazers_url":"https://api.github.com/repos/obspy/obspy/stargazers","contributors_url":"https://api.github.com/repos/obspy/obspy/contributors","subscribers_url":"https://api.github.com/repos/obspy/obspy/subscribers","subscription_url":"https://api.github.com/repos/obspy/obspy/subscription","commits_url":"https://api.github.com/repos/obspy/obspy/commits{/sha}","git_commits_url":"https://api.github.com/repos/obspy/obspy/git/commits{/sha}","comments_url":"https://api.github.com/repos/obspy/obspy/comments{/number}","issue_comment_url":"https://api.github.com/repos/obspy/obspy/issues/comments{/number}","contents_url":"https://api.github.com/repos/obspy/obspy/contents/{+path}","compare_url":"https://api.github.com/repos/obspy/obspy/compare/{base}...{head}","merges_url":"https://api.github.com/repos/obspy/obspy/merges","archive_url":"https://api.github.com/repos/obspy/obspy/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/obspy/obspy/downloads","issues_url":"https://api.github.com/repos/obspy/obspy/issues{/number}","pulls_url":"https://api.github.com/repos/obspy/obspy/pulls{/number}","milestones_url":"https://api.github.com/repos/obspy/obspy/milestones{/number}","notifications_url":"https://api.github.com/repos/obspy/obspy/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/obspy/obspy/labels{/name}","releases_url":"https://api.github.com/repos/obspy/obspy/releases{/id}","created_at":"2012-09-08T19:17:46Z","updated_at":"2015-07-07T22:58:32Z","pushed_at":"2015-07-09T16:42:48Z","git_url":"git://github.com/obspy/obspy.git","ssh_url":"git@github.com:obspy/obspy.git","clone_url":"https://github.com/obspy/obspy.git","svn_url":"https://github.com/obspy/obspy","homepage":"http://www.obspy.org","size":83608,"stargazers_count":143,"watchers_count":143,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":103,"mirror_url":null,"open_issues_count":90,"forks":103,"open_issues":90,"watchers":143,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/obspy/obspy/pulls/1091"},"html":{"href":"https://github.com/obspy/obspy/pull/1091"},"issue":{"href":"https://api.github.com/repos/obspy/obspy/issues/1091"},"comments":{"href":"https://api.github.com/repos/obspy/obspy/issues/1091/comments"},"review_comments":{"href":"https://api.github.com/repos/obspy/obspy/pulls/1091/comments"},"review_comment":{"href":"https://api.github.com/repos/obspy/obspy/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/obspy/obspy/pulls/1091/commits"},"statuses":{"href":"https://api.github.com/repos/obspy/obspy/statuses/104afc565a05fcd01f66213b54166f159ffa2342"}}}}