Skip to content

Commit 9a8a96d

Browse files
Rename exploratory samples (#1771)
Co-authored-by: Ian Malcolm <imalcolm@esri.com>
1 parent 1ba6835 commit 9a8a96d

108 files changed

Lines changed: 688 additions & 646 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightLocation/readme.md

Lines changed: 0 additions & 30 deletions
This file was deleted.

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightGeoElement/LineOfSightGeoElement.xaml renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenGeoelements/ShowExploratoryLineOfSightBetweenGeoelements.xaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8" ?>
2-
<ContentPage x:Class="ArcGIS.Samples.LineOfSightGeoElement.LineOfSightGeoElement"
2+
<ContentPage x:Class="ArcGIS.Samples.ShowExploratoryLineOfSightBetweenGeoelements.ShowExploratoryLineOfSightBetweenGeoelements"
33
xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
44
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
55
xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Maui;assembly=Esri.ArcGISRuntime.Maui"

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightGeoElement/LineOfSightGeoElement.xaml.cs renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenGeoelements/ShowExploratoryLineOfSightBetweenGeoelements.xaml.cs

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,16 @@
1616

1717
using Colors = System.Drawing.Color;
1818

19-
namespace ArcGIS.Samples.LineOfSightGeoElement
19+
namespace ArcGIS.Samples.ShowExploratoryLineOfSightBetweenGeoelements
2020
{
2121
[ArcGIS.Samples.Shared.Attributes.Sample(
22-
name: "Line of sight (geoelement)",
22+
name: "Show exploratory line of sight between geoelements",
2323
category: "Analysis",
24-
description: "Show a line of sight between two moving objects.",
25-
instructions: "A line of sight will display between a point on the Empire State Building (observer) and a taxi (target).",
26-
tags: new[] { "3D", "line of sight", "visibility", "visibility analysis" })]
24+
description: "Show an exploratory line of sight between two moving objects.",
25+
instructions: "An exploratory line of sight will display between a point on the Empire State Building (observer) and a taxi (target).",
26+
tags: new[] { "3D", "exploratory line of sight", "visibility", "visibility analysis" })]
2727
[ArcGIS.Samples.Shared.Attributes.OfflineData("3af5cfec0fd24dac8d88aea679027cb9")]
28-
public partial class LineOfSightGeoElement : ContentPage
28+
public partial class ShowExploratoryLineOfSightBetweenGeoelements : ContentPage
2929
{
3030
// URL of the elevation service - provides elevation component of the scene
3131
private readonly Uri _elevationUri = new Uri("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer");
@@ -58,7 +58,7 @@ public partial class LineOfSightGeoElement : ContentPage
5858
private int _frameIndex = 0;
5959
private readonly int _frameMax = 150;
6060

61-
public LineOfSightGeoElement()
61+
public ShowExploratoryLineOfSightBetweenGeoelements()
6262
{
6363
InitializeComponent();
6464

src/WPF/WPF.Viewer/Samples/Analysis/LineOfSightGeoElement/readme.md renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenGeoelements/readme.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,28 @@
1-
# Line of sight (geoelement)
1+
# Show exploratory line of sight between geoelements
22

3-
Show a line of sight between two moving objects.
3+
Show an exploratory line of sight between two moving objects.
44

5-
![Image of line of sight geoelement](LineOfSightGeoElement.jpg)
5+
![Image of Show exploratory line of sight between geoelements](showexploratorylineofsightbetweengeoelements.jpg)
66

77
## Use case
88

9-
A line of sight between `GeoElement`s (i.e. observer and target) will not remain constant whilst one or both are on the move.
9+
An exploratory line of sight between `GeoElement`s (i.e. observer and target) will not remain constant whilst one or both are on the move.
1010

1111
An `ExploratoryGeoElementLineOfSight` is therefore useful in cases where visibility between two `GeoElement`s requires monitoring over a period of time in a partially obstructed field of view
1212
(such as buildings in a city).
1313

14+
Note: This analysis is a form of "exploratory analysis", which means the results are calculated on the current scale of the data, and the results are generated very quickly but not persisted.
15+
1416
## How to use the sample
1517

16-
A line of sight will display between a point on the Empire State Building (observer) and a taxi (target).
17-
The taxi will drive around a block and the line of sight should automatically update.
18+
An exploratory line of sight will display between a point on the Empire State Building (observer) and a taxi (target).
19+
The taxi will drive around a block and the exploratory line of sight should automatically update.
1820
The taxi will be highlighted when it is visible. You can change the observer height with the slider to see how it affects the target's visibility.
1921

2022
## How it works
2123

2224
1. Instantiate an `AnalysisOverlay` and add it to the `SceneView`'s analysis overlays collection.
23-
2. Instantiate an `ExploratoryGeoElementLineOfSight`, passing in observer and target `GeoElement`s (features or graphics). Add the line of sight to the analysis overlay's analyses collection.
25+
2. Instantiate an `ExploratoryGeoElementLineOfSight`, passing in observer and target `GeoElement`s (features or graphics). Add the exploratory line of sight to the analysis overlay's analyses collection.
2426
3. To get the target visibility when it changes, react to the target visibility changing on the `ExploratoryGeoElementLineOfSight` instance.
2527

2628
## Relevant API
@@ -37,4 +39,4 @@ This sample downloads the following items from ArcGIS Online automatically:
3739

3840
## Tags
3941

40-
3D, line of sight, visibility, visibility analysis
42+
3D, exploratory line of sight, visibility, visibility analysis

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightGeoElement/readme.metadata.json renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenGeoelements/readme.metadata.json

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
{
22
"category": "Analysis",
3-
"description": "Show a line of sight between two moving objects.",
4-
"formal_name": "LineOfSightGeoElement",
3+
"description": "Show an exploratory line of sight between two moving objects.",
4+
"formal_name": "ShowExploratoryLineOfSightBetweenGeoelements",
55
"ignore": false,
66
"images": [
7-
"lineofsightgeoelement.jpg"
7+
"showexploratorylineofsightbetweengeoelements.jpg"
88
],
99
"keywords": [
1010
"3D",
11-
"line of sight",
11+
"exploratory line of sight",
1212
"visibility",
1313
"visibility analysis"
1414
],
@@ -24,8 +24,8 @@
2424
"ExploratoryLineOfSight.TargetVisibility"
2525
],
2626
"snippets": [
27-
"LineOfSightGeoElement.xaml.cs",
28-
"LineOfSightGeoElement.xaml"
27+
"ShowExploratoryLineOfSightBetweenGeoelements.xaml.cs",
28+
"ShowExploratoryLineOfSightBetweenGeoelements.xaml"
2929
],
30-
"title": "Line of sight (geoelement)"
30+
"title": "Show exploratory line of sight between geoelements"
3131
}

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightGeoElement/lineofsightgeoelement.jpg renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenGeoelements/showexploratorylineofsightbetweengeoelements.jpg

File renamed without changes.

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightLocation/LineOfSightLocation.xaml renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenPoints/ShowExploratoryLineOfSightBetweenPoints.xaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8" ?>
2-
<ContentPage x:Class="ArcGIS.Samples.LineOfSightLocation.LineOfSightLocation"
2+
<ContentPage x:Class="ArcGIS.Samples.ShowExploratoryLineOfSightBetweenPoints.ShowExploratoryLineOfSightBetweenPoints"
33
xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
44
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
55
xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Maui;assembly=Esri.ArcGISRuntime.Maui">

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightLocation/LineOfSightLocation.xaml.cs renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenPoints/ShowExploratoryLineOfSightBetweenPoints.xaml.cs

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@
1313

1414
using Colors = System.Drawing.Color;
1515

16-
namespace ArcGIS.Samples.LineOfSightLocation
16+
namespace ArcGIS.Samples.ShowExploratoryLineOfSightBetweenPoints
1717
{
1818
[ArcGIS.Samples.Shared.Attributes.Sample(
19-
name: "Line of sight (location)",
19+
name: "Show exploratory line of sight between points",
2020
category: "Analysis",
21-
description: "Perform a line of sight analysis between two points in real time.",
22-
instructions: "Tap to place the starting point for the line. Tap again to place the end point.",
23-
tags: new[] { "3D", "line of sight", "visibility", "visibility analysis" })]
24-
public partial class LineOfSightLocation : ContentPage
21+
description: "Perform an exploratory line of sight analysis between two points in real time.",
22+
instructions: "The sample loads with a preset observer and target location, linked by a colored line. A red segment on the line means the view between observer and target is obstructed, whereas green means the view is unobstructed.",
23+
tags: new[] { "3D", "exploratory line of sight", "visibility", "visibility analysis" })]
24+
public partial class ShowExploratoryLineOfSightBetweenPoints : ContentPage
2525
{
2626
// URL for an image service to use as an elevation source
2727
private string _elevationSourceUrl = @"https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer";
@@ -38,7 +38,7 @@ public partial class LineOfSightLocation : ContentPage
3838
// Offset (meters) to use for the observer/target height (z-value for the points)
3939
private double _zOffset = 2.0;
4040

41-
public LineOfSightLocation()
41+
public ShowExploratoryLineOfSightBetweenPoints()
4242
{
4343
InitializeComponent();
4444

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Show exploratory line of sight between points
2+
3+
Perform an exploratory line of sight analysis between two points in real time.
4+
5+
![Image of show exploratory line of sight between points](showexploratorylineofsightbetweenpoints.jpg)
6+
7+
## Use case
8+
9+
An exploratory line of sight analysis can be used to assess whether a view is obstructed between an observer and a target. Obstructing features could either be natural, like topography, or man-made, like buildings. Consider an events planning company wanting to commemorate a national event by lighting sequential beacons across hill summits or roof tops. To guarantee a successful event, ensuring an unobstructed line of sight between neighboring beacons would allow each beacon to be activated as intended.
10+
11+
Note: This analysis is a form of "exploratory analysis", which means the results are calculated on the current scale of the data, and the results are generated very quickly but not persisted. If persisted analysis performed at the full resolution of the data is required, consider using a `LineOfSightFunction` to perform a line of sight calculation instead.
12+
13+
## How to use the sample
14+
15+
The sample loads with a preset observer and target location, linked by a colored line. A red segment on the line means the view between observer and target is obstructed, whereas green means the view is unobstructed.
16+
17+
Tap to place the starting (observer) point for the line. Tap again to place the end (target) point.
18+
19+
## How it works
20+
21+
1. Create an `AnalysisOverlay` and add it to the scene view.
22+
2. Create an `ExploratoryLocationLineOfSight` with initial observer and target locations and add it to the analysis overlay.
23+
3. Listen for taps on the scene.
24+
4. Update the target and observer positions by updating `ExploratoryLocationLineOfSight.ObserverLocation` and `ExploratoryLocationLineOfSight.TargetLocation`.
25+
26+
## Relevant API
27+
28+
* AnalysisOverlay
29+
* ExploratoryLocationLineOfSight
30+
* SceneView
31+
32+
## Tags
33+
34+
3D, exploratory line of sight, visibility, visibility analysis

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightLocation/readme.metadata.json renamed to src/MAUI/Maui.Samples/Samples/Analysis/ShowExploratoryLineOfSightBetweenPoints/readme.metadata.json

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
{
22
"category": "Analysis",
3-
"description": "Perform a line of sight analysis between two points in real time.",
4-
"formal_name": "LineOfSightLocation",
3+
"description": "Perform an exploratory line of sight analysis between two points in real time.",
4+
"formal_name": "ShowExploratoryLineOfSightBetweenPoints",
55
"ignore": false,
66
"images": [
7-
"lineofsightlocation.jpg"
7+
"showexploratorylineofsightbetweenpoints.jpg"
88
],
99
"keywords": [
1010
"3D",
11-
"line of sight",
11+
"exploratory line of sight",
1212
"visibility",
1313
"visibility analysis"
1414
],
@@ -22,8 +22,8 @@
2222
"SceneView"
2323
],
2424
"snippets": [
25-
"LineOfSightLocation.xaml.cs",
26-
"LineOfSightLocation.xaml"
25+
"ShowExploratoryLineOfSightBetweenPoints.xaml.cs",
26+
"ShowExploratoryLineOfSightBetweenPoints.xaml"
2727
],
28-
"title": "Line of sight (location)"
28+
"title": "Show exploratory line of sight between points"
2929
}

0 commit comments

Comments
 (0)