Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion open-source-ecosystem/creating-your-own-instance/index.qmd
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

broken reference link

Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The modular VEDA platform architecture provides a blueprint on how prominent ope
3. Cloud computing with your own tailored JupyterHub environment
4. Browser-based visualization and storytelling using the Dashboard's cloud-native tools

See [Software Architecture](open-source-ecosystem/architecture.qmd) for more information on how all of these pieces fit together.
See [Software Architecture](../architecture.qmd) for more information on how all of these pieces fit together.

There are many options for how to use the VEDA software ecosystem, depending on your needs and existing set of tools.

Expand Down
2 changes: 1 addition & 1 deletion open-source-ecosystem/repositories.qmd
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

broken link

Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Dashboard UI for viewing and analysing VEDA assets. Also the repository for the
Content for the [VEDA Dashboard for NASA EarthData](https://www.earthdata.nasa.gov/dashboard/) and template for other projects

## VEDA JupyterHub
### [2i2c-org/infrastructure](2i2c-org/infrastructure)
### [NASA-IMPACT/veda-hub-infrastructure(https://github.com/NASA-IMPACT/veda-hub-infrastructure)
Infrastructure for configuring and deploying community JupyterHubs by 2i2c

## VEDA Documentation
Expand Down
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unsure why delta-ui was included, but changed all to veda-ui

Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ Dashboard-specific notes that supplement the full [stac-api collection specifica
| **Field &/or Extension** | **Recommendations** |
| --- | --- |
| **id** | If dataset exists in NASA's Earthdata or presumably from some other data provider like ESA, use that ID. If appropriate, add a suffix for any additional processing that has been performed, e.g. "OMSO2PCA_cog". If dataset is not from NASA's Earthdata, we can use a human readable name with underscores like "facebook_population_density". |
| **dashboard extension** | To support the delta-ui we have added two new fields in a proposed dashboard extension. For now we are just adding the fields but after testing things out, we can formalize the extension with a [hosted json schema](https://github.com/stac-extensions/template). **_Dashboard extension properties are only required for collections that will be viewed in the delta-ui dashboard._** |
| **dashboard extension** | To support the veda-ui we have added two new fields in a proposed dashboard extension. For now we are just adding the fields but after testing things out, we can formalize the extension with a [hosted json schema](https://github.com/stac-extensions/template). **_Dashboard extension properties are only required for collections that will be viewed in the veda-ui dashboard._** |
| **dashboard:is_periodic** | `True/False` This boolean is used when summarizing the collection—if the collection is periodic, the temporal range of the items in the collection and the time density are all the front end needs to generate a time picker. If the items in the collection are not periodic, a complete list of the unique item datetimes is needed. |
| **dashboard:time_density** | `year`, `month`, `day`, `hour`, `minute`, or `null`. These time steps should be treated as enum when the extension is formalized. For collections with a single time snapshot this value is null. |
| **item_assets** | [stac-extension/item_assets](https://github.com/stac-extensions/item-assets/blob/main/README.md) is used to explain the assets that are provided for each item in the collection. We’re not providing thumbnails yet, but this example below includes a thumbnail asset to illustrate how the extension will be used. The population of this property is not automated, the creator of the collection writes the item assets documentation. **_Item assets are only required for collections that will be viewed in the delta-ui dashboard._** |
| **summaries**| The implementation of this [core stac-spec](https://github.com/radiantearth/stac-api-spec/blob/master/stac-spec/collection-spec/collection-spec.md#summaries) field is use-case specific. Our implementation is intended to support the dashboard and will supply datetime and raster statistics for the default map layer asset across the entire collection. **_Currently summaries are manually updated with a delta-ui specific [user defined function in pgstac](https://github.com/NASA-IMPACT/veda-backend/issues/31)._** |
| **item_assets** | [stac-extension/item_assets](https://github.com/stac-extensions/item-assets/blob/main/README.md) is used to explain the assets that are provided for each item in the collection. We’re not providing thumbnails yet, but this example below includes a thumbnail asset to illustrate how the extension will be used. The population of this property is not automated, the creator of the collection writes the item assets documentation. **_Item assets are only required for collections that will be viewed in the veda-ui dashboard._** |
| **summaries**| The implementation of this [core stac-spec](https://github.com/radiantearth/stac-api-spec/blob/master/stac-spec/collection-spec/collection-spec.md#summaries) field is use-case specific. Our implementation is intended to support the dashboard and will supply datetime and raster statistics for the default map layer asset across the entire collection. **_Currently summaries are manually updated with a veda-ui specific [user defined function in pgstac](https://github.com/NASA-IMPACT/veda-backend/issues/31)._** |
| **title and description** | Use these properties to provide specific information about the collection to API users and catalog browsers. These properties correspond to [dataset name and info in the covid-api](https://github.com/NASA-IMPACT/covid-api/blob/develop/covid_api/db/static/datasets/no2-diff.json) but the delta dashboard will use delta-config to set these values in the UI so the information in our stac collections will be for data curators and API users. |
| **collection name style choices** | Prefer lower-case kebab-case collection names. Decision: Should names align with underlying data identifiers or should it be an interpreted name? `omi-trno2-dhrm` and `omi-trno2-dhrm-difference` vs `no2-monthly` and `no2-monthly-diff`; `bmhd-30m-monthly` vs `nightlights-hd-monthly` |
| **license** | [SPDX license id](https://spdx.org/licenses/), license is likely available in CMR but we may need to research other sources of data. Default open license: `CC0-1.0` |
Expand Down Expand Up @@ -43,7 +43,7 @@ Dashboard-specific notes that supplement the full [stac-api collection specifica
}
```

**summaries example for periodic collection**
**summaries example for non-periodic collection**
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The examples were incorrectly labelled.

```
"summaries": {
"datetime": ["2016-01-01T00:00:00Z", "2022-01-01T00:00:00Z"],
Expand All @@ -54,7 +54,7 @@ Dashboard-specific notes that supplement the full [stac-api collection specifica
}
```

**summaries example for non-periodic collection**
**summaries example for periodic collection**
```
"summaries": {
"datetime": [
Expand Down
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

grammatical error

Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ The CMR properties question in the table above (how to refer the STAC Item to it
}
```

**stac-spec [scieintific extension](https://github.com/stac-extensions/scientific)**
**stac-spec [scientific extension](https://github.com/stac-extensions/scientific)**
```
"properties": {
"sci:doi": "10.5067/HLS/HLSS30.002",
Expand Down
2 changes: 1 addition & 1 deletion user-guide/notebooks/index.qmd
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There was no file named veda-jh-access.html so I linked it with "Getting access"

Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The **Quickstarts** examples are further divided into two sections, which you ca

## How to run

Every notebook contains information about how to run it. Some can run on [VEDA Trial Hub](https://binder.openveda.cloud/) and all can run on the [VEDA JupyterHub](https://hub.openveda.cloud/). See [VEDA Analytics JupyterHub Access](https://nasa-impact.github.io/veda-docs/veda-jh-access.html) for information about how to gain access.
Every notebook contains information about how to run it. Some can run on [VEDA Trial Hub](https://binder.openveda.cloud/) and all can run on the [VEDA JupyterHub](https://hub.openveda.cloud/). See [VEDA Analytics JupyterHub Access](/user-guide/scientific-computing/getting-access.qmd) for information about how to gain access.

### Running outside of VEDA JupyterHub

Expand Down
1 change: 1 addition & 0 deletions veda-project/target-use-cases/dashboard.qmd
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Needed a "space" added to make it render properly as a list.

Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ Planned VEDA instances:

### 8. Utilizing an integrated STAC, a VEDA Dashboard can show data from a variety of sources
There are different ways to integrate data, such as:

- Using platform storage, catalog, and data access services
- Catalog externally stored data, serve through platform services (e.g. cloud-optimized GeoTIFF in DAAC S3; TiTiler and TiTiler-Xarray)
- Rely on external storage and catalog, serve through platform services (e.g. TiTiler-CMR)
Expand Down
15 changes: 15 additions & 0 deletions veda-project/why.qmd
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This change is geared toward making the content more readable by providing space between busy objects.

Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,24 @@ subtitle: Proliferating community standards
---

![](images/veda-target-audience.png)
<br>
<br>
<br>

---

![Source: [2022 ESDS Program Highlights](https://www.earthdata.nasa.gov/esds/esds-highlights/2022-esds-highlights)](images/data-archive-growth.png)
<br>
<br>
<br>

---

![](images/community-standard-ecosystem.png)
<br>
<br>
<br>

---

![](images/veda-ecosystem.png)