u1+^H}Y0
zcichP<`uwhiZ=lBVk*OtRA9isVS;WblQ(_sW?j8`*loH=S@7i
zh9azq=p^fJ2A5ppT7yF~6fL0&an-z+L4=f9sUi;EQd9K2;d-)Ai-P@wkWJ&)jeJn_
zb6Pgy
zdMe31yM{!cR38gSyBX{^>YKQx1m#gP1>;u1yPSSH6BBVdko)g2sx}IwhUmgsJ{n*n
z%P6V))V(P4J-1E{nl1P
z*eWDUJu%%yuBKkgCG$I!`pN>SJdSmcw!wPYcQ4-_=;KKbHc^u{xP+%sT9ZS@MIBn^
zW*1|%s{zTK5HBG2=yKzW!NuVu5L5-{>&xtkXCqpej
zzAjHz`*q$%iq=pO!N_@|uU%`Csq2Y8Z?|(G_R`D~x4w&u)M81m=nBDZq)2%0Pg}HgVDv}k?s6tQ
zk@ydSG~n?7jI!Ac6p`tEwX&@$+ZF8vBV@t4@7t&G@!7%mD^6BX|4|1jvZ}uXRb9GZ
z9mW!|_xkpFxU6|@D=*BO{Lt7f>ctzn;FRB*k{=&Hh9|hl)9`E<*ME_d{wBbcfxW#P
z7DxX2WIi{6qU>)YxJcT)wox>H8L|c{v1wNuv(dfte2E}7aOO(Q1=UQ471uk|1l{6X!
zlmNJl)x$rVMwB6EFAcz5kb_91!MjFKriR;)pNRAo-g&ae8#JLky(?j2%
z^sZ%fd?S3EZ&HbV3T0Uk-mNwjwA`h=Ta(?HNKWcEW13iXxVpyOs*qqIgHjlavDlPN
zhU
z;WxSW>G*|!@9|tj9X2J+*Lm3P3!?iie$h_Q4{OG^OD?BAoP6P_rrFJkH9-Ye7FIs>
zH@Nb=Ax?IRoFWqxO~ta97dHTWqSgmM4>|?WG11RXxaK9gZk4fkEH)fG2VjP2->nq8
zG#P@A@^ohH#0n&+mQp(waouomq(PTQPwvW0dob3BfT(k0vBSI9<2X2G1o`E*f-k8O
zX8tlr4wL_I7NM1IFG+lQmQ`C&eNMF6osh@5@Z5rPOxcVH$sCv$tL}eb^yW{nv;c#o
zvA1%>_UG}PKX}A*2pBIkEI^y|5FcpA;w3mN>DUt^WysXhQBBWJdUi3nfBDwEetkW?
zumFKJF)tFWxe;Y`Z$i1~$1N`ZSIKlV|9)_#fmM^%L;0m6
z(9=2VZ$#(yQO2pMk_!Q1<`#o*%QaS#;(GX{?T$3a;XZ>p2|9=KXl%{F0Y#~lG}vm>
zPJ5}t@}c3&eILH$a0UDdki%YxE<}UyfM?*lg1qdq$V>5zz_^b*{bS8*+Db{5KL|m$
z1KUiSfK_>XXZqoTReq?+ZaW;Sm>(i2NXys`&ktrRM7=Elki5e0+ph_OPN9z>d}#@&
z@BW)cAu);flU$jvH4P~f?xc}6*A0vHc8Xpe?P7S;iG1uC5
z5gf`tier1rxr|DqCQMGEVAV(uIZ71an=M|kA(mt3g{H-|p@U^@;gLT0Yv9Pm;jmOu
z5vR6BY3L-SG$X9uzWhqY#p}`Zg0;naq6~@(z8RANWT(OCYk7HPW;68DhUFrKKLk-r
zN1*O=YD2HLC@3fLKP=jGs(>G?nWdN(b0i#C`aQ4{nDMDSw(8Q~lYU{)*w*fs>4$jP
zAhBF)94rcBlxy7lDUP3^Jx
zYg)#eqjg%2gvfSPGN}XC)}hj;L0`U>RsE>k=nLtUkfB`hxyBC{yORd^n{gH%F6qPL
zw!jJ~L;qucyryq^-|I!>ox-WopFN$6V{&{OQuNE#&vnN1kshxYW0thSheeXn>6TRp
z)LglV^V8D!;s2mkKlH_h<%a&iW
+
## Contributing Guide
diff --git a/docs/tutorials/demo.ipynb b/docs/tutorials/demo.ipynb
index 5869d7c9..260d5737 100644
--- a/docs/tutorials/demo.ipynb
+++ b/docs/tutorials/demo.ipynb
@@ -42,7 +42,7 @@
},
{
"cell_type": "code",
- "execution_count": 5,
+ "execution_count": 1,
"id": "10f6c9ed-fe58-4e03-b29b-c6c447061f84",
"metadata": {},
"outputs": [
@@ -52,7 +52,7 @@
"'0.3.0'"
]
},
- "execution_count": 5,
+ "execution_count": 1,
"metadata": {},
"output_type": "execute_result"
}
@@ -64,12 +64,13 @@
},
{
"cell_type": "code",
- "execution_count": 6,
+ "execution_count": 2,
"id": "2acb1926-3442-446a-8a35-fcbba8868d4d",
"metadata": {},
"outputs": [],
"source": [
- "auth = earthdata.Auth()"
+ "from earthdata import Auth, Store, DataCollections, DataGranules\n",
+ "auth = Auth()"
]
},
{
@@ -98,7 +99,7 @@
},
{
"cell_type": "code",
- "execution_count": 7,
+ "execution_count": 3,
"id": "caab3b4b-80cc-4790-9417-1dd12503aa55",
"metadata": {},
"outputs": [
@@ -120,7 +121,7 @@
},
{
"cell_type": "code",
- "execution_count": 8,
+ "execution_count": 4,
"id": "a0a5f73d-b4b9-4dad-ac72-12c7ae6278d1",
"metadata": {},
"outputs": [
@@ -151,60 +152,10 @@
},
{
"cell_type": "code",
- "execution_count": 9,
+ "execution_count": null,
"id": "8d5bf4c9-571b-4c93-af94-e66bd51cb584",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Collections found: 338\n"
- ]
- },
- {
- "data": {
- "text/plain": [
- "[{\n",
- " \"meta\": {\n",
- " \"concept-id\": \"C1908348134-LPDAAC_ECS\",\n",
- " \"granule-count\": 0,\n",
- " \"provider-id\": \"LPDAAC_ECS\"\n",
- " },\n",
- " \"umm\": {\n",
- " \"ShortName\": \"GEDI02_A\",\n",
- " \"Version\": \"002\"\n",
- " }\n",
- " },\n",
- " {\n",
- " \"meta\": {\n",
- " \"concept-id\": \"C1431413941-NSIDC_ECS\",\n",
- " \"granule-count\": 61,\n",
- " \"provider-id\": \"NSIDC_ECS\"\n",
- " },\n",
- " \"umm\": {\n",
- " \"ShortName\": \"RDEFT4\",\n",
- " \"Version\": \"1\"\n",
- " }\n",
- " },\n",
- " {\n",
- " \"meta\": {\n",
- " \"concept-id\": \"C1299783579-LPDAAC_ECS\",\n",
- " \"granule-count\": 0,\n",
- " \"provider-id\": \"LPDAAC_ECS\"\n",
- " },\n",
- " \"umm\": {\n",
- " \"ShortName\": \"AST14DEM\",\n",
- " \"Version\": \"003\"\n",
- " }\n",
- " }]"
- ]
- },
- "execution_count": 9,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# The first step is to create a DataCollections query \n",
"Query = DataCollections()\n",
@@ -232,21 +183,10 @@
},
{
"cell_type": "code",
- "execution_count": 10,
+ "execution_count": null,
"id": "8cb5154c-f131-44ad-a68f-cf0fa21ce18f",
"metadata": {},
- "outputs": [
- {
- "data": {
- "text/plain": [
- "'GEDI02_A'"
- ]
- },
- "execution_count": 10,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"collections[0][\"umm\"][\"ShortName\"]"
]
@@ -275,37 +215,10 @@
},
{
"cell_type": "code",
- "execution_count": 11,
+ "execution_count": null,
"id": "48cdcd74-dfe3-4b83-93f4-7378a0d981df",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Collections found: 502\n"
- ]
- },
- {
- "data": {
- "text/plain": [
- "{\n",
- " \"meta\": {\n",
- " \"concept-id\": \"C1674798938-PODAAC\",\n",
- " \"granule-count\": 49150,\n",
- " \"provider-id\": \"PODAAC\"\n",
- " },\n",
- " \"umm\": {\n",
- " \"ShortName\": \"ASCATB-L2-25km\"\n",
- " }\n",
- "}"
- ]
- },
- "execution_count": 11,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# We can now search for collections using a pythonic API client for CMR.\n",
"Query = DataCollections().daac(\"PODAAC\")\n",
@@ -318,37 +231,10 @@
},
{
"cell_type": "code",
- "execution_count": 12,
+ "execution_count": null,
"id": "63792353-ab3e-4f0b-963d-7750e4b89113",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Collections found: 322\n"
- ]
- },
- {
- "data": {
- "text/plain": [
- "{\n",
- " \"meta\": {\n",
- " \"concept-id\": \"C1940473819-POCLOUD\",\n",
- " \"granule-count\": 2376387,\n",
- " \"provider-id\": \"POCLOUD\"\n",
- " },\n",
- " \"umm\": {\n",
- " \"ShortName\": \"MODIS_A-JPL-L2P-v2019.0\"\n",
- " }\n",
- "}"
- ]
- },
- "execution_count": 12,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# What if we want cloud collections\n",
"Query = DataCollections().daac(\"PODAAC\").cloud_hosted(True)\n",
@@ -361,30 +247,10 @@
},
{
"cell_type": "code",
- "execution_count": 14,
+ "execution_count": null,
"id": "c4c5a34a-e808-4cc9-b34d-353d091a8242",
"metadata": {},
- "outputs": [
- {
- "data": {
- "text/plain": [
- "['C1940473819-POCLOUD',\n",
- " 'C2075141559-POCLOUD',\n",
- " 'C2075141638-POCLOUD',\n",
- " 'C1940475563-POCLOUD',\n",
- " 'C2036878688-POCLOUD',\n",
- " 'C1996880725-POCLOUD',\n",
- " 'C1996880450-POCLOUD',\n",
- " 'C2036877595-POCLOUD',\n",
- " 'C2075141605-POCLOUD',\n",
- " 'C1996881146-POCLOUD']"
- ]
- },
- "execution_count": 14,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# Printing the concept-id for the first 10 collections\n",
"[collection.concept_id() for collection in collections]"
@@ -408,45 +274,10 @@
},
{
"cell_type": "code",
- "execution_count": 15,
+ "execution_count": null,
"id": "9364d737-5a79-4089-853f-76d2ad1c85a7",
"metadata": {},
- "outputs": [
- {
- "data": {
- "text/plain": [
- "[Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- " Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': -127.0482205607256, 'StartLatitude': 27.0, 'StartDirection': 'A', 'EndLatitude': 59.5, 'EndDirection': 'A'}}}\n",
- " Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-10-14T00:18:55.637Z', 'EndingDateTime': '2018-10-14T00:19:19.913Z'}}\n",
- " Size(MB): 3.7921009064\n",
- " Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.10.14/ATL06_20181014001049_02350102_005_01.h5'],\n",
- " Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- " Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': 50.741590031724314, 'StartLatitude': 59.5, 'StartDirection': 'D', 'EndLatitude': 27.0, 'EndDirection': 'D'}}}\n",
- " Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-11-09T11:28:36.538Z', 'EndingDateTime': '2018-11-09T11:29:14.738Z'}}\n",
- " Size(MB): 5.0780105591\n",
- " Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.11.09/ATL06_20181109112837_06390106_005_01.h5'],\n",
- " Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- " Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': -126.78857810482624, 'StartLatitude': 27.0, 'StartDirection': 'A', 'EndLatitude': 59.5, 'EndDirection': 'A'}}}\n",
- " Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-11-11T22:55:08.251Z', 'EndingDateTime': '2018-11-11T22:55:37.758Z'}}\n",
- " Size(MB): 4.1429281235\n",
- " Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.11.11/ATL06_20181111224708_06770102_005_01.h5'],\n",
- " Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- " Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': -127.56718592349382, 'StartLatitude': 27.0, 'StartDirection': 'A', 'EndLatitude': 59.5, 'EndDirection': 'A'}}}\n",
- " Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-11-15T22:46:36.934Z', 'EndingDateTime': '2018-11-15T22:47:15.558Z'}}\n",
- " Size(MB): 11.893447876\n",
- " Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.11.15/ATL06_20181115223845_07380102_005_01.h5'],\n",
- " Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- " Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': 51.00122639850689, 'StartLatitude': 59.5, 'StartDirection': 'D', 'EndLatitude': 27.0, 'EndDirection': 'D'}}}\n",
- " Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-12-08T10:04:25.906Z', 'EndingDateTime': '2018-12-08T10:05:02.142Z'}}\n",
- " Size(MB): 3.580540657\n",
- " Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.12.08/ATL06_20181208100423_10810106_005_01.h5']]"
- ]
- },
- "execution_count": 15,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# We build our query\n",
"from pprint import pprint\n",
@@ -469,266 +300,10 @@
},
{
"cell_type": "code",
- "execution_count": 16,
+ "execution_count": null,
"id": "66cd5f5c-a854-4a72-a831-33b8bd7ce9d2",
"metadata": {},
- "outputs": [
- {
- "data": {
- "text/html": [
- "\n",
- " \n",
- " \n",
- "
\n",
- " \n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- "
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.04/ATL06_20181014001049_02350102_005_01_BRW.default.default1.jpg\")
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.04/ATL06_20181014001049_02350102_005_01_BRW.default.default2.jpg\")
\n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- " "
- ],
- "text/plain": [
- "Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- "Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': -127.0482205607256, 'StartLatitude': 27.0, 'StartDirection': 'A', 'EndLatitude': 59.5, 'EndDirection': 'A'}}}\n",
- "Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-10-14T00:18:55.637Z', 'EndingDateTime': '2018-10-14T00:19:19.913Z'}}\n",
- "Size(MB): 3.7921009064\n",
- "Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.10.14/ATL06_20181014001049_02350102_005_01.h5']"
- ]
- },
- "metadata": {},
- "output_type": "display_data"
- },
- {
- "data": {
- "text/html": [
- "\n",
- " \n",
- " \n",
- "
\n",
- " \n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- "
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181109112837_06390106_005_01_BRW.default.default1.jpg\")
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181109112837_06390106_005_01_BRW.default.default2.jpg\")
\n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- " "
- ],
- "text/plain": [
- "Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- "Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': 50.741590031724314, 'StartLatitude': 59.5, 'StartDirection': 'D', 'EndLatitude': 27.0, 'EndDirection': 'D'}}}\n",
- "Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-11-09T11:28:36.538Z', 'EndingDateTime': '2018-11-09T11:29:14.738Z'}}\n",
- "Size(MB): 5.0780105591\n",
- "Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.11.09/ATL06_20181109112837_06390106_005_01.h5']"
- ]
- },
- "metadata": {},
- "output_type": "display_data"
- },
- {
- "data": {
- "text/html": [
- "\n",
- " \n",
- " \n",
- "
\n",
- " \n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- "
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181111224708_06770102_005_01_BRW.default.default1.jpg\")
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181111224708_06770102_005_01_BRW.default.default2.jpg\")
\n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- " "
- ],
- "text/plain": [
- "Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- "Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': -126.78857810482624, 'StartLatitude': 27.0, 'StartDirection': 'A', 'EndLatitude': 59.5, 'EndDirection': 'A'}}}\n",
- "Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-11-11T22:55:08.251Z', 'EndingDateTime': '2018-11-11T22:55:37.758Z'}}\n",
- "Size(MB): 4.1429281235\n",
- "Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.11.11/ATL06_20181111224708_06770102_005_01.h5']"
- ]
- },
- "metadata": {},
- "output_type": "display_data"
- },
- {
- "data": {
- "text/html": [
- "\n",
- " \n",
- " \n",
- "
\n",
- " \n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- "
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181115223845_07380102_005_01_BRW.default.default1.jpg\")
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181115223845_07380102_005_01_BRW.default.default2.jpg\")
\n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- " "
- ],
- "text/plain": [
- "Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- "Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': -127.56718592349382, 'StartLatitude': 27.0, 'StartDirection': 'A', 'EndLatitude': 59.5, 'EndDirection': 'A'}}}\n",
- "Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-11-15T22:46:36.934Z', 'EndingDateTime': '2018-11-15T22:47:15.558Z'}}\n",
- "Size(MB): 11.893447876\n",
- "Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.11.15/ATL06_20181115223845_07380102_005_01.h5']"
- ]
- },
- "metadata": {},
- "output_type": "display_data"
- },
- {
- "data": {
- "text/html": [
- "\n",
- " \n",
- " \n",
- "
\n",
- " \n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- "
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181208100423_10810106_005_01_BRW.default.default1.jpg\")
![\"Data](\"https://n5eil01u.ecs.nsidc.org/DP0/BRWS/Browse.001/2021.11.05/ATL06_20181208100423_10810106_005_01_BRW.default.default2.jpg\")
\n",
- "
\n",
- "
\n",
- "
\n",
- "
\n",
- " "
- ],
- "text/plain": [
- "Collection: {'EntryTitle': 'ATLAS/ICESat-2 L3A Land Ice Height V005'}\n",
- "Spatial coverage: {'HorizontalSpatialDomain': {'Orbit': {'AscendingCrossing': 51.00122639850689, 'StartLatitude': 59.5, 'StartDirection': 'D', 'EndLatitude': 27.0, 'EndDirection': 'D'}}}\n",
- "Temporal coverage: {'RangeDateTime': {'BeginningDateTime': '2018-12-08T10:04:25.906Z', 'EndingDateTime': '2018-12-08T10:05:02.142Z'}}\n",
- "Size(MB): 3.580540657\n",
- "Data: ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2018.12.08/ATL06_20181208100423_10810106_005_01.h5']"
- ]
- },
- "metadata": {},
- "output_type": "display_data"
- },
- {
- "data": {
- "text/plain": [
- "[None, None, None, None, None]"
- ]
- },
- "execution_count": 16,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# printing 2 granules using display\n",
"[display(granule) for granule in granules]"
@@ -747,18 +322,10 @@
},
{
"cell_type": "code",
- "execution_count": 17,
+ "execution_count": null,
"id": "00aa39ec-e2fb-49d1-bc54-8d8a2f0655aa",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Granules found: 4\n"
- ]
- }
- ],
+ "outputs": [],
"source": [
"Query = DataGranules().short_name(\"ATL06\").temporal(\"2020-03-01\", \"2020-03-30\").bounding_box(-134.7,58.9,-133.9,59.2).version(\"005\")\n",
"# Always inspects the hits before retrieven the granule metadata, just because it's very verbose.\n",
@@ -767,32 +334,14 @@
},
{
"cell_type": "code",
- "execution_count": 18,
+ "execution_count": null,
"id": "8c493585-0d48-41bb-8815-6c83ad20ae80",
"metadata": {},
- "outputs": [
- {
- "data": {
- "text/plain": [
- "[{'links': ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2020.03.06/ATL06_20200306122320_10810606_005_01.h5'],\n",
- " 'size (MB):': 2.7875404358},\n",
- " {'links': ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2020.03.08/ATL06_20200308234154_11190602_005_01.h5'],\n",
- " 'size (MB):': 4.3645324707},\n",
- " {'links': ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2020.03.10/ATL06_20200310121504_11420606_005_01.h5'],\n",
- " 'size (MB):': 2.6717844009},\n",
- " {'links': ['https://n5eil01u.ecs.nsidc.org/DP7/ATLAS/ATL06.005/2020.03.12/ATL06_20200312233336_11800602_005_01.h5'],\n",
- " 'size (MB):': 14.1388778687}]"
- ]
- },
- "execution_count": 18,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"# Now we can print some info about these granules using the built-in methods\n",
"granules = Query.get(5)\n",
- "data_links = [{'links': g.data_links(), 'size (MB):': g.size()} for g in granules]\n",
+ "data_links = [{'links': g.data_links(access=\"on_prem\"), 'size (MB):': g.size()} for g in granules]\n",
"data_links"
]
},
@@ -814,7 +363,7 @@
},
{
"cell_type": "code",
- "execution_count": 21,
+ "execution_count": null,
"id": "b796fa53-60ac-4197-922d-1f6ee5dec00b",
"metadata": {},
"outputs": [],
@@ -832,28 +381,10 @@
},
{
"cell_type": "code",
- "execution_count": 22,
+ "execution_count": null,
"id": "910e4b90-f0e0-42e5-a4e2-d5444089161f",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Granule hits: 2509\n"
- ]
- },
- {
- "data": {
- "text/plain": [
- "False"
- ]
- },
- "execution_count": 22,
- "metadata": {},
- "output_type": "execute_result"
- }
- ],
+ "outputs": [],
"source": [
"Query = DataGranules().concept_id(\"C1972955240-PODAAC\").bounding_box(-134.7,54.9,-100.9,69.2)\n",
"print(f\"Granule hits: {Query.hits()}\")\n",
@@ -878,23 +409,7 @@
"execution_count": null,
"id": "434466a3-602b-4dff-a260-f7db6901514a",
"metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- " Getting 4 granules, approx download size: 0.14 GB\n"
- ]
- },
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "QUEUEING TASKS | : 100%|█████████████████████████████████████████████████████████████████████████████████| 8/8 [00:00<00:00, 267.87it/s]\n",
- "PROCESSING TASKS | : 88%|██████████████████████████████████████████████████████████████████████ | 7/8 [00:27<00:03, 3.97s/it]"
- ]
- }
- ],
+ "outputs": [],
"source": [
"%%time\n",
"files = store.get(granules[0:4], \"./data/C1972955240-PODAAC/\")"
@@ -1090,7 +605,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
- "version": "3.9.7"
+ "version": "3.9.12"
}
},
"nbformat": 4,
diff --git a/docs/user-reference/collections/collections-query.md b/docs/user-reference/collections/collections-query.md
index c2493f7a..7d6cd42b 100644
--- a/docs/user-reference/collections/collections-query.md
+++ b/docs/user-reference/collections/collections-query.md
@@ -1,4 +1,6 @@
-# Documentation for `Collections`
+# Documentation for `DataCollections`
+
+### DataCollections is the class `earthdata` uses to query CMR at the **dataset** level.
::: earthdata.search.DataCollections
selection:
diff --git a/docs/user-reference/collections/collections.md b/docs/user-reference/collections/collections.md
index e63a2728..0dbbf456 100644
--- a/docs/user-reference/collections/collections.md
+++ b/docs/user-reference/collections/collections.md
@@ -1,3 +1,9 @@
-# `Collections`
+# Documentation for `Collection Results`
+::: earthdata.search.DataCollection
+ selection:
+ inherited_members: true
+ rendering:
+ show_root_heading: true
+ show_source: false
diff --git a/docs/user-reference/glossary/cloud-glossary.md b/docs/user-reference/glossary/cloud-glossary.md
new file mode 100644
index 00000000..e69de29b
diff --git a/docs/user-reference/glossary/nasa-glossary.md b/docs/user-reference/glossary/nasa-glossary.md
new file mode 100644
index 00000000..9df12b9b
--- /dev/null
+++ b/docs/user-reference/glossary/nasa-glossary.md
@@ -0,0 +1,3 @@
+# NASA EARTHDATA GLOSSARY
+
+[GLOSSARY](https://earthdata.nasa.gov/learn/user-resources/glossary)
diff --git a/docs/user-reference/granules/granules-query.md b/docs/user-reference/granules/granules-query.md
index 9762bc10..a7bd943d 100644
--- a/docs/user-reference/granules/granules-query.md
+++ b/docs/user-reference/granules/granules-query.md
@@ -1,5 +1,8 @@
# Documentation for `Granules`
+
+### DataGranules is the class `earthdata` uses to query CMR at the **granule** level.
+
::: earthdata.search.DataGranules
selection:
inherited_members: true
diff --git a/docs/user-reference/granules/granules.md b/docs/user-reference/granules/granules.md
index 96fffda6..832f3175 100644
--- a/docs/user-reference/granules/granules.md
+++ b/docs/user-reference/granules/granules.md
@@ -1,3 +1,11 @@
-# `Granules`
+# Documentation for `Granule Results`
+
+::: earthdata.search.DataGranule
+ selection:
+ inherited_members: true
+ rendering:
+ show_root_heading: true
+ show_source: false
+
diff --git a/mkdocs.yml b/mkdocs.yml
index 085f8f64..8eb3b974 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,22 +1,24 @@
site_name: earthdata
-site_description: Client library for NASA APIs
-site_url: https://github.com/betolink/earthdata
+site_description: Client library for NASA Earthdata APIs
+site_url: https://github.com/nsidc/earthdata
theme:
- name: 'material'
- palette:
- - scheme: default
- primary: teal
- toggle:
- icon: material/toggle-switch-off-outline
- name: Switch to dark mode
- - scheme: slate
- toggle:
- icon: material/toggle-switch
- name: Switch to light mode
+ name: 'material'
+ logo: earth.png
+ favicon: earth.png
+ palette:
+ - scheme: default
+ primary: teal
+ toggle:
+ icon: material/toggle-switch-off-outline
+ name: Switch to dark mode
+ - scheme: slate
+ toggle:
+ icon: material/toggle-switch
+ name: Switch to light mode
repo_name: betolink/earthdata
-repo_url: https://github.com/betolink/earthdata
+repo_url: https://github.com/nsidc/earthdata
edit_uri: ''
plugins:
@@ -26,17 +28,21 @@ plugins:
execute: False
nav:
- - Overview: 'index.md'
- - Tutorials:
- - 'Basic usage': 'tutorials/demo.ipynb'
- - 'Accessing restricted datasets': 'tutorials/restricted-datasets.ipynb'
- - 'Accessing on-prem datasets': 'tutorials/onprem.md'
- - 'Accessing cloud-based datasets': 'tutorials/cloud.md'
- - User Reference:
- - Collections:
+ - OVERVIEW: 'index.md'
+ - TUTORIALS:
+ - 'Basic usage': 'tutorials/demo.ipynb'
+ - HOW-TO:
+ - 'Search and access restricted datasets': 'tutorials/restricted-datasets.ipynb'
+ - 'Search and access on-prem datasets': 'tutorials/onprem.md'
+ - 'Search and cloud-based datasets': 'tutorials/cloud.md'
+ - USER REFERENCE:
+ - Glossary:
+ - 'NASA Glossary': 'user-reference/glossary/nasa-glossary.md'
+ - 'Cloud Computing Terminology': 'user-reference/glossary/cloud-glossary.md'
+ - Collections API:
- 'Collection Queries': 'user-reference/collections/collections-query.md'
- 'Collection Results': 'user-reference/collections/collections.md'
- - Granules:
+ - Granules API:
- 'Granule Queries': 'user-reference/granules/granules-query.md'
- 'Granule Results': 'user-reference/granules/granules.md'
@@ -46,4 +52,3 @@ markdown_extensions:
- pymdownx.inlinehilite
- pymdownx.snippets
- pymdownx.superfences
-
diff --git a/poetry.lock b/poetry.lock
index 4327e785..49f7de63 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -627,6 +627,26 @@ category = "dev"
optional = false
python-versions = "*"
+[[package]]
+name = "ipywidgets"
+version = "7.7.0"
+description = "IPython HTML widgets for Jupyter"
+category = "dev"
+optional = false
+python-versions = "*"
+
+[package.dependencies]
+ipykernel = ">=4.5.1"
+ipython = {version = ">=4.0.0", markers = "python_version >= \"3.3\""}
+ipython-genutils = ">=0.2.0,<0.3.0"
+jupyterlab-widgets = {version = ">=1.0.0", markers = "python_version >= \"3.6\""}
+nbformat = ">=4.2.0"
+traitlets = ">=4.3.1"
+widgetsnbextension = ">=3.6.0,<3.7.0"
+
+[package.extras]
+test = ["pytest (>=3.6.0)", "pytest-cov", "mock"]
+
[[package]]
name = "isort"
version = "5.10.1"
@@ -823,6 +843,14 @@ requests = "*"
openapi = ["openapi-core (>=0.14.2)", "ruamel.yaml"]
test = ["openapi-core (>=0.14.2)", "ruamel.yaml", "codecov", "ipykernel", "jupyter-server", "openapi-spec-validator (<0.5)", "pytest-console-scripts", "pytest-cov", "pytest (>=5.3.2)", "strict-rfc3339", "wheel"]
+[[package]]
+name = "jupyterlab-widgets"
+version = "1.1.0"
+description = "A JupyterLab extension."
+category = "dev"
+optional = false
+python-versions = ">=3.6"
+
[[package]]
name = "jupytext"
version = "1.13.8"
@@ -1985,6 +2013,17 @@ docs = ["Sphinx (>=3.4)", "sphinx-rtd-theme (>=0.5)"]
optional = ["python-socks", "wsaccel"]
test = ["websockets"]
+[[package]]
+name = "widgetsnbextension"
+version = "3.6.0"
+description = "IPython HTML widgets for Jupyter"
+category = "dev"
+optional = false
+python-versions = "*"
+
+[package.dependencies]
+notebook = ">=4.4.1"
+
[[package]]
name = "wrapt"
version = "1.14.0"
@@ -2028,7 +2067,7 @@ testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-
[metadata]
lock-version = "1.1"
python-versions = ">=3.8,<4.0"
-content-hash = "05e750d567a24f619eab893d4ca282ef2c2c7e949ec02e9058090a33183dedc5"
+content-hash = "e1fc69d2ef369392141260f34a12a93c51bbec1106e55e405128fca9070d593a"
[metadata.files]
aiobotocore = [
@@ -2498,6 +2537,10 @@ ipython-genutils = [
{file = "ipython_genutils-0.2.0-py2.py3-none-any.whl", hash = "sha256:72dd37233799e619666c9f639a9da83c34013a73e8bbc79a7a6348d93c61fab8"},
{file = "ipython_genutils-0.2.0.tar.gz", hash = "sha256:eb2e116e75ecef9d4d228fdc66af54269afa26ab4463042e33785b887c628ba8"},
]
+ipywidgets = [
+ {file = "ipywidgets-7.7.0-py2.py3-none-any.whl", hash = "sha256:e58ff58bc94d481e91ecb6e13a5cb96a87b6b8ade135e055603d0ca24593df38"},
+ {file = "ipywidgets-7.7.0.tar.gz", hash = "sha256:ab4a5596855a88b83761921c768707d65e5847068139bc1729ddfe834703542a"},
+]
isort = [
{file = "isort-5.10.1-py3-none-any.whl", hash = "sha256:6f62d78e2f89b4500b080fe3a81690850cd254227f27f75c3a0c491a1f351ba7"},
{file = "isort-5.10.1.tar.gz", hash = "sha256:e8443a5e7a020e9d7f97f1d7d9cd17c88bcb3bc7e218bf9cf5095fe550be2951"},
@@ -2546,6 +2589,10 @@ jupyterlab-server = [
{file = "jupyterlab_server-2.13.0-py3-none-any.whl", hash = "sha256:fc9e86d4e7c4b139de59b0a96b53071e670bee1ed106a3389daecd68f1221aeb"},
{file = "jupyterlab_server-2.13.0.tar.gz", hash = "sha256:2040298a133458aa22f287a877d6bb91ff973f6298d562264f9f7b75e92a5ace"},
]
+jupyterlab-widgets = [
+ {file = "jupyterlab_widgets-1.1.0-py3-none-any.whl", hash = "sha256:c2a9bd3789f120f64d73268c066ed3b000c56bc1dda217be5cdc43e7b4ebad3f"},
+ {file = "jupyterlab_widgets-1.1.0.tar.gz", hash = "sha256:d5f41bc1713795385f718d44dcba47e1e1473c6289f28a95aa6b2c0782ee372a"},
+]
jupytext = [
{file = "jupytext-1.13.8-py3-none-any.whl", hash = "sha256:625d2d2012763cc87d3f0dd60383516cec442c11894f53ad0c5ee5aa2a52caa2"},
{file = "jupytext-1.13.8.tar.gz", hash = "sha256:60148537de5aa08bb9cbe8797500a49360b7a8eb6667736ae5b80e3ec7ba084d"},
@@ -3241,6 +3288,10 @@ websocket-client = [
{file = "websocket-client-1.3.2.tar.gz", hash = "sha256:50b21db0058f7a953d67cc0445be4b948d7fc196ecbeb8083d68d94628e4abf6"},
{file = "websocket_client-1.3.2-py3-none-any.whl", hash = "sha256:722b171be00f2b90e1d4fb2f2b53146a536ca38db1da8ff49c972a4e1365d0ef"},
]
+widgetsnbextension = [
+ {file = "widgetsnbextension-3.6.0-py2.py3-none-any.whl", hash = "sha256:4fd321cad39fdcf8a8e248a657202d42917ada8e8ed5dd3f60f073e0d54ceabd"},
+ {file = "widgetsnbextension-3.6.0.tar.gz", hash = "sha256:e84a7a9fcb9baf3d57106e184a7389a8f8eb935bf741a5eb9d60aa18cc029a80"},
+]
wrapt = [
{file = "wrapt-1.14.0-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:5a9a1889cc01ed2ed5f34574c90745fab1dd06ec2eee663e8ebeefe363e8efd7"},
{file = "wrapt-1.14.0-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:9a3ff5fb015f6feb78340143584d9f8a0b91b6293d6b5cf4295b3e95d179b88c"},
diff --git a/pyproject.toml b/pyproject.toml
index ca585487..6f93682a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -36,6 +36,8 @@ pygments = "=2.11.1"
responses = ">=0.14"
types-requests = ">=0.1"
types-setuptools = ">=0.1"
+ipywidgets = "^7.7.0"
+widgetsnbextension = "^3.6.0"
[build-system]
requires = ["poetry>=0.12"]
From bc5e6f6b9669f73db98f97c5c1c2cbbe938f67fe Mon Sep 17 00:00:00 2001
From: "betolink:w"
Date: Tue, 26 Apr 2022 09:27:42 -0600
Subject: [PATCH 3/5] removed ipywidgets from binder to se if it helps with
rust?
---
binder/environment.yml | 1 -
1 file changed, 1 deletion(-)
diff --git a/binder/environment.yml b/binder/environment.yml
index f6211e28..4f737670 100644
--- a/binder/environment.yml
+++ b/binder/environment.yml
@@ -17,7 +17,6 @@ dependencies:
- earthdata
# documentation
- jupyterlab>=3
-- ipywidgets
- mkdocs>=1.2
- mkdocs-material>=7.1, <9.0
- markdown-include>=0.6
From c136ab4986e028cde994720e0f073346170f523f Mon Sep 17 00:00:00 2001
From: "betolink:w"
Date: Tue, 26 Apr 2022 10:02:38 -0600
Subject: [PATCH 4/5] update docs
---
docs/index.md | 6 ++++++
docs/tutorials/demo.ipynb | 1 +
mkdocs.yml | 3 +++
3 files changed, 10 insertions(+)
diff --git a/docs/index.md b/docs/index.md
index 1c946b90..f67cb915 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,3 +1,9 @@
+---
+hide:
+ - toc
+---
+
+
# earthdata 🌍
diff --git a/docs/tutorials/demo.ipynb b/docs/tutorials/demo.ipynb
index 260d5737..f78998f3 100644
--- a/docs/tutorials/demo.ipynb
+++ b/docs/tutorials/demo.ipynb
@@ -7,6 +7,7 @@
"tags": []
},
"source": [
+ "\n",
"## Overview\n",
"\n",
"\n",
diff --git a/mkdocs.yml b/mkdocs.yml
index 8eb3b974..0434d9b9 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -47,6 +47,9 @@ nav:
- 'Granule Results': 'user-reference/granules/granules.md'
markdown_extensions:
+ - meta
+ - toc:
+ toc_depth: 1
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.inlinehilite
From 0186b194b3df78231c80feab653586eb5331fd04 Mon Sep 17 00:00:00 2001
From: "betolink:w"
Date: Tue, 26 Apr 2022 11:57:32 -0600
Subject: [PATCH 5/5] update poetry lock
---
poetry.lock | 8 +++-----
1 file changed, 3 insertions(+), 5 deletions(-)
diff --git a/poetry.lock b/poetry.lock
index 37bfec8f..49f7de63 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1464,7 +1464,6 @@ optional = false
python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
[[package]]
-
name = "pycparser"
version = "2.21"
description = "C parser in Python"
@@ -1490,7 +1489,7 @@ python-versions = ">=3.5"
[[package]]
name = "pymdown-extensions"
-version = "9.3"
+version = "9.2"
description = "Extension pack for Python Markdown."
category = "dev"
optional = false
@@ -2067,7 +2066,6 @@ testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-
[metadata]
lock-version = "1.1"
-
python-versions = ">=3.8,<4.0"
content-hash = "e1fc69d2ef369392141260f34a12a93c51bbec1106e55e405128fca9070d593a"
@@ -2943,8 +2941,8 @@ pygments = [
{file = "Pygments-2.11.1.tar.gz", hash = "sha256:59b895e326f0fb0d733fd28c6839bd18ad0687ba20efc26d4277fd1d30b971f4"},
]
pymdown-extensions = [
- {file = "pymdown-extensions-9.3.tar.gz", hash = "sha256:a80553b243d3ed2d6c27723bcd64ca9887e560e6f4808baa96f36e93061eaf90"},
- {file = "pymdown_extensions-9.3-py3-none-any.whl", hash = "sha256:b37461a181c1c8103cfe1660081726a0361a8294cbfda88e5b02cefe976f0546"},
+ {file = "pymdown-extensions-9.2.tar.gz", hash = "sha256:ed8f69a18bc158f00cbf03abc536b88b6e541b7e699156501e767c48f81d8850"},
+ {file = "pymdown_extensions-9.2-py3-none-any.whl", hash = "sha256:f2fa7d9317c672a419868c893c20a28fb7ed7fc60d4ec4774c35e01398ab330c"},
]
pyparsing = [
{file = "pyparsing-3.0.8-py3-none-any.whl", hash = "sha256:ef7b523f6356f763771559412c0d7134753f037822dad1b16945b7b846f7ad06"},