From ea3cad88e67dd7b6c311a95c9dec0e9abb886686 Mon Sep 17 00:00:00 2001 From: Lorraine Hwang Date: Fri, 16 Feb 2024 08:21:59 -0800 Subject: [PATCH 1/2] Update painting_in_the_world.md Extensive editing for clarity. Please review carefully. Feel free to edit. --- .../concepts/painting_in_the_world.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/doc/sphinx/user_manual/concepts/painting_in_the_world.md b/doc/sphinx/user_manual/concepts/painting_in_the_world.md index 6cf5782df..f6db8f6b0 100644 --- a/doc/sphinx/user_manual/concepts/painting_in_the_world.md +++ b/doc/sphinx/user_manual/concepts/painting_in_the_world.md @@ -4,14 +4,16 @@ Painting in the world In the last section we introduced the concept of a feature. In this section we are going to discuss how features are placed inside the world and how they can interact with each other. -The first thing to understand about how GWB features are primarily defined by the user as 2D features on a map. That means that the user provides 2D coordinates of where the feature is located. Only after that, the user provides information to actually make the feature a 3D object. The second thing to understand is that features are provided in a list. The GWB goes through that list from top to bottom and adds each feature to the world in order. If there is any overlap, the user can decide what to do (how to blend the old and new value), but by default each feature overwrites the old value with the new value. You can think of it like paining, where each features add a layer of paint and the painter can decide to completely paint over an area, or create an interesting blend! +GWB features are primarily defined by the user as 2D features on a map. The user first provides 2D coordinates of where the feature is located. After prescribing its location, the user then provides information to make the feature a 3D object. + +GWB features are specified as a list. The GWB goes through this list sequentially from top to bottom and adds each feature to the world in this order. If there is any overlap, the user can decide what to do (how to blend the old and new value), but by default each feature overwrites the old value with the new value. You can think of it like painting, where each feature adds a layer of paint and the painter can decide to completely paint over an area or create an interesting blend! Starting with a topographic map ------------------------------- -In the previous section, we referred to that a user should be able to take a map of a region and start to make a model. That is exactly what we are going to do here. +In thi section we will take a map of a region and start to make a model. -Below you can see three pictures. In the leftmost one we are starting with a map of a region we are interested in making a model of. For this example we have made a simplified map of the eastern Caribbean plate. For simplicity's sake, we are only going to focus on a small part, as indicated by the thick black line in the middle figure. Next we are going to define important points on that map, as indicated by P1 to P7. The way we define these points is through looking at the different tectonic units in the area. P1, P2, P7, P5 and P6 define the area to the left of the trench, which represents the Caribbean plate, and is indicated by the green area in the right most figure. P2, P3, P4, P5 and P7 define the area to the right of the trench, which represents the Atlantic part of the South American plate, and is indicated by the blue color in the right most figure. Finally, P2, P7 and P5, indicate the trench and is indicated by the purple color in the right most figure. +Below you can see three figures. In the leftmost one we start with a map of the region of interest - in this case a simplified map of the eastern Caribbean plate. For simplicity's sake, we will focus on a small part as indicated by the black box in the middle figure. Next, we define important points P1 to P7 on the box. These points are defined by the different tectonic units in the area. In the figure to the right, P1, P2, P7, P5 and P6 define the area to the left of the trench (green) which represents the Caribbean plate. P2, P3, P4, P5 and P7 define the area to the right of the trench (blue) which represents the Atlantic part of the South American plate. Finally, P2, P7 and P5 describe a line for the trench (magenta). ::::{grid} 3 @@ -24,7 +26,7 @@ Below you can see three pictures. In the leftmost one we are starting with a map ::: :::{grid-item-card} -**Now we select a region and define points** +**Selecting a region and define points** ![Starting with a geologic map](../../_static/images/user_manual/map_to_top_view_v2_plain_text_frame_sds.svg) ::: @@ -41,7 +43,7 @@ Below you can see three pictures. In the leftmost one we are starting with a map Using the topographic map to make a 3D model -------------------------------------------- -Now that we have colored in our map, it is time to talk about how this map helps us making a 3D setup. To do that we are going to use the figures below. The right side of each figure shows a map view as shown in the previous subsection. The right part of the figure show a 3D rendering of the setup. We are going to call the colors we are adding compositions. You can think of this different types of rock. +Now that we have colored in our map, let's make a 3D setup. This is illustrated in the series of figures below. The left side of each figure shows the map view as shown in the previous subsection. The right part of each figure shows a 3D rendering of the setup. We are going to call the colors we are adding compositions. You can think of this as different types of rock. :::{card} @@ -51,7 +53,7 @@ Now that we have colored in our map, it is time to talk about how this map helps ::: -To show how we stack features, we are first we are going to add a composition for the mantle. That is we are going to use a feature called a `mantle layer`. We give the feature the coordinates P1, P2, P4 and P6, and tell it to start a the surface and have a thickness which is enough to fill the whole model. In the figure below we have given the area which is now defined as the mantle composition a red color. +To show how we stack features, let's first add a composition for the mantle by using a feature called a `mantle layer`. We give the feature the coordinates P1, P3, P4 and P6 to start the surface which will be given a thickness to fill the whole model. In the figure below, this area now defined as the mantle composition is shown in red. :::{card} @@ -60,7 +62,7 @@ To show how we stack features, we are first we are going to add a composition fo ![Starting with a box without compositions](../../_static/images/user_manual/gwb_box_building_plain_text_frame_mtl.svg) ::: -Next we are going to add the overriding Caribbean plate. We know that it is make of oceanic lithosphere, so we are going to use a feature called `oceanic plate`. Like before we provide it with the coordinates (P1, P2, P7, P5 and P6) and we give it a thickness of 90km. As you can see, a part of the area which was red before is now *painted over* by a green color, which represent a different composition. +Next, let's add the overriding Caribbean plate. We know that it is oceanic lithosphere so we are going to use a feature called `oceanic plate`. Like before, we provide it with the map view coordinates (P1, P2, P7, P5 and P6) and give it a thickness of 90km. In the figure below, a part of the area which was red before is now *painted over* in green representing a different composition. :::{card} @@ -80,7 +82,7 @@ We do the same thing for the Atlantic part of the South American plate and color ![adding an oceanic plate](../../_static/images/user_manual/gwb_box_building_plain_text_frame_mtl_orp_sdp.svg) ::: -Now we get to the trench. The important thing about the trench is that is has subducting lithosphere, so we are going to use a feature called `subducting plate`. We provide the location of the trench to the subducting plate (P2, P7 and P5). Next we need to provide some other information like the angle of the plate with the surface and thickness. In practice the slab can have different segments with different angles and thicknesses, but for now we are just going to use a single slab segment with a constant angle and thickness. Like before, we are going to color in the area and overwrite the existing colors in those places. This provides everything we need to make a 3D model! +Lastly, let's add the subducting lithosphere using a feature called `subducting plate`. First, we must provide the location of the trench to the subducting plate (P2, P7 and P5). Next, we must provide the angle of the plate with respect to the surface and its thickness. In practice the slab can have different segments with different angles and thicknesses but for simplicity here, we are restricting ourselves to a single slab segment with a constant angle and thickness. Like before, we are going to color in the area (magenta) and overwrite the existing colors. Congratulations, you have made your first 3D model! :::{card} From 7ddbbe38ea8ca7e5ee453ce5ef22c0854aecb592 Mon Sep 17 00:00:00 2001 From: Lorraine Hwang Date: Fri, 16 Feb 2024 08:53:30 -0800 Subject: [PATCH 2/2] Update doc/sphinx/user_manual/concepts/painting_in_the_world.md Co-authored-by: Menno Fraters --- doc/sphinx/user_manual/concepts/painting_in_the_world.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/sphinx/user_manual/concepts/painting_in_the_world.md b/doc/sphinx/user_manual/concepts/painting_in_the_world.md index f6db8f6b0..e139930ce 100644 --- a/doc/sphinx/user_manual/concepts/painting_in_the_world.md +++ b/doc/sphinx/user_manual/concepts/painting_in_the_world.md @@ -11,7 +11,7 @@ GWB features are specified as a list. The GWB goes through this list sequentiall Starting with a topographic map ------------------------------- -In thi section we will take a map of a region and start to make a model. +In this section we will take a map of a region and start to make a model. Below you can see three figures. In the leftmost one we start with a map of the region of interest - in this case a simplified map of the eastern Caribbean plate. For simplicity's sake, we will focus on a small part as indicated by the black box in the middle figure. Next, we define important points P1 to P7 on the box. These points are defined by the different tectonic units in the area. In the figure to the right, P1, P2, P7, P5 and P6 define the area to the left of the trench (green) which represents the Caribbean plate. P2, P3, P4, P5 and P7 define the area to the right of the trench (blue) which represents the Atlantic part of the South American plate. Finally, P2, P7 and P5 describe a line for the trench (magenta).