polyhedral-gravity 3.3rc1__cp312-cp312-macosx_11_0_arm64.whl → 3.3.1rc1__cp312-cp312-macosx_11_0_arm64.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {polyhedral_gravity-3.3rc1.dist-info → polyhedral_gravity-3.3.1rc1.dist-info}/METADATA +26 -25
- polyhedral_gravity-3.3.1rc1.dist-info/RECORD +6 -0
- {polyhedral_gravity-3.3rc1.dist-info → polyhedral_gravity-3.3.1rc1.dist-info}/WHEEL +1 -1
- polyhedral_gravity.cpython-312-darwin.so +0 -0
- polyhedral_gravity-3.3rc1.dist-info/RECORD +0 -6
- {polyhedral_gravity-3.3rc1.dist-info → polyhedral_gravity-3.3.1rc1.dist-info/licenses}/LICENSE +0 -0
- {polyhedral_gravity-3.3rc1.dist-info → polyhedral_gravity-3.3.1rc1.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,6 @@
|
|
1
|
-
Metadata-Version: 2.
|
1
|
+
Metadata-Version: 2.4
|
2
2
|
Name: polyhedral_gravity
|
3
|
-
Version: 3.
|
3
|
+
Version: 3.3.1rc1
|
4
4
|
Summary: Package to compute full gravity tensor of a given constant density polyhedron for arbitrary points according to the geodetic convention
|
5
5
|
Author: Jonas Schuhmacher
|
6
6
|
Author-email: jonas.schuhmacher@tum.de
|
@@ -19,7 +19,7 @@ Classifier: Operating System :: MacOS
|
|
19
19
|
Classifier: Operating System :: POSIX :: Linux
|
20
20
|
Classifier: Intended Audience :: Science/Research
|
21
21
|
Classifier: Topic :: Scientific/Engineering :: Physics
|
22
|
-
Requires-Python: >=3.
|
22
|
+
Requires-Python: >=3.9
|
23
23
|
Description-Content-Type: text/markdown
|
24
24
|
License-File: LICENSE
|
25
25
|
Dynamic: author
|
@@ -28,6 +28,7 @@ Dynamic: classifier
|
|
28
28
|
Dynamic: description
|
29
29
|
Dynamic: description-content-type
|
30
30
|
Dynamic: license
|
31
|
+
Dynamic: license-file
|
31
32
|
Dynamic: project-url
|
32
33
|
Dynamic: requires-python
|
33
34
|
Dynamic: summary
|
@@ -104,20 +105,20 @@ The evaluation of the polyhedral gravity model requires the following parameters
|
|
104
105
|
| Polyhedral Mesh (either as vertices & faces or as polyhedral source files) |
|
105
106
|
| Constant Density $\rho$ |
|
106
107
|
|
107
|
-
The mesh and the
|
108
|
-
Have a look the documentation to view the [supported mesh files](https://esa.github.io/polyhedral-gravity-model/quickstart/supported_input.html).
|
108
|
+
The mesh and the constant density's unit must match.
|
109
|
+
Have a look at the documentation to view the [supported mesh files](https://esa.github.io/polyhedral-gravity-model/quickstart/supported_input.html).
|
109
110
|
|
110
111
|
### Output
|
111
112
|
|
112
113
|
The calculation outputs the following parameters for every Computation Point *P*.
|
113
114
|
The units of the respective output depend on the units of the input parameters (mesh and density)!
|
114
|
-
Hence, if e.g
|
115
|
+
Hence, if e.g., your mesh is in $km$, the density must match. Further, output units will be different accordingly.
|
115
116
|
|
116
|
-
| Name | Unit (if mesh in $[m]$ and $\rho$ in $[kg/m^3]$) |
|
117
|
-
|
118
|
-
| $V$ | $\frac{m^2}{s^2}$ or $\frac{J}{kg}$ | The potential or also called specific energy
|
119
|
-
| $V_x$, $V_y$, $V_z$ | $\frac{m}{s^2}$ | The gravitational
|
120
|
-
| $V_{xx}$, $V_{yy}$, $V_{zz}$, $V_{xy}$, $V_{xz}$, $V_{yz}$ | $\frac{1}{s^2}$ | The spatial rate of change of the gravitational
|
117
|
+
| Name | Unit (if mesh in $[m]$ and $\rho$ in $[kg/m^3]$) | Comment |
|
118
|
+
|:----------------------------------------------------------:|:------------------------------------------------:|:----------------------------------------------------------------:|
|
119
|
+
| $V$ | $\frac{m^2}{s^2}$ or $\frac{J}{kg}$ | The potential or also called specific energy |
|
120
|
+
| $V_x$, $V_y$, $V_z$ | $\frac{m}{s^2}$ | The gravitational acceleration in the three cartesian directions |
|
121
|
+
| $V_{xx}$, $V_{yy}$, $V_{zz}$, $V_{xy}$, $V_{xz}$, $V_{yz}$ | $\frac{1}{s^2}$ | The spatial rate of change of the gravitational acceleration |
|
121
122
|
|
122
123
|
|
123
124
|
>[!NOTE]
|
@@ -176,7 +177,7 @@ potential, acceleration, tensor = evaluate(
|
|
176
177
|
The more advanced way is to use the `GravityEvaluable` class. It caches the
|
177
178
|
internal data structure and properties which can be reused for multiple
|
178
179
|
evaluations. This is especially useful if you want to compute the gravity
|
179
|
-
for multiple computation points
|
180
|
+
for multiple computation points but don't know the "future points" in advance.
|
180
181
|
|
181
182
|
```python
|
182
183
|
evaluable = GravityEvaluable(polyhedron=cube_polyhedron) # stores intermediate computation steps
|
@@ -197,7 +198,7 @@ This property is - by default - checked when constructing the `Polyhedron`! So,
|
|
197
198
|
is impossible if not **explicitly** disabled to create an invalid `Polyhedron`.
|
198
199
|
You can disable/ enable this setting via the optional `integrity_check` flag and can even
|
199
200
|
automatically repair the ordering via `HEAL`.
|
200
|
-
If you are confident that your mesh is defined correctly (e.g
|
201
|
+
If you are confident that your mesh is defined correctly (e.g., checked once with the integrity check)
|
201
202
|
you can disable this check (via `DISABLE`) to avoid the additional runtime overhead of the check.
|
202
203
|
Also, you can set the metric unit of the mesh and the density.
|
203
204
|
This also influences the output unit. E.g., Density in $kg/m^3$, Mesh in $m$, then the potential is given in $m^2/s^2$.
|
@@ -279,8 +280,8 @@ As a second option, you can also install the python interface with pip from [PyP
|
|
279
280
|
pip install polyhedral-gravity
|
280
281
|
```
|
281
282
|
|
282
|
-
Binaries for the most common platforms are available on PyPI including
|
283
|
-
Windows, Linux and macOS. For macOS and Linux, binaries for
|
283
|
+
Binaries for the most common platforms are available on PyPI, including
|
284
|
+
Windows, Linux, and macOS. For macOS and Linux, binaries for
|
284
285
|
`x86_64` and `aarch64` are provided.
|
285
286
|
In case `pip` uses the source distribution, please make sure that
|
286
287
|
you have a C++17 capable compiler and CMake installed.
|
@@ -288,7 +289,7 @@ you have a C++17 capable compiler and CMake installed.
|
|
288
289
|
### From source
|
289
290
|
|
290
291
|
The project uses the following dependencies,
|
291
|
-
all of them are **automatically** set
|
292
|
+
all of them are **automatically** set up via CMake:
|
292
293
|
|
293
294
|
- GoogleTest (1.15.2 or compatible), only required for testing
|
294
295
|
- spdlog (1.13.0 or compatible), required for logging
|
@@ -298,7 +299,7 @@ all of them are **automatically** set-up via CMake:
|
|
298
299
|
- xsimd (11.1.0 or compatible), required for vectorization of the `atan(..)`
|
299
300
|
- pybind11 (2.12.0 or compatible), required for the Python interface, but not the C++ standalone
|
300
301
|
|
301
|
-
The module will be
|
302
|
+
The module will be built using a C++17 capable compiler,
|
302
303
|
CMake. Just execute the following command in
|
303
304
|
the repository root folder:
|
304
305
|
|
@@ -316,7 +317,7 @@ export POLYHEDRAL_GRAVITY_PARALLELIZATION="TBB"
|
|
316
317
|
pip install .
|
317
318
|
```
|
318
319
|
|
319
|
-
(Optional: For a faster build you can install all dependencies available
|
320
|
+
(Optional: For a faster build, you can install all dependencies available
|
320
321
|
for your system in your local python environment. That way, they
|
321
322
|
won't be fetched from GitHub.)
|
322
323
|
|
@@ -324,7 +325,7 @@ won't be fetched from GitHub.)
|
|
324
325
|
|
325
326
|
### Building the C++ Library & Executable
|
326
327
|
|
327
|
-
The program is
|
328
|
+
The program is built by using CMake. So first make sure that you installed
|
328
329
|
CMake and then follow these steps:
|
329
330
|
|
330
331
|
```bash
|
@@ -345,7 +346,7 @@ The following options are available:
|
|
345
346
|
| BUILD_POLYHEDRAL_GRAVITY_PYTHON_INTERFACE (`ON`) | Build the Python interface |
|
346
347
|
|
347
348
|
During testing POLYHEDRAL_GRAVITY_PARALLELIZATION=`TBB` has been the most performant.
|
348
|
-
It is further not
|
349
|
+
It is further not recommended to change the POLYHEDRAL_GRAVITY_LOGGING_LEVEL to something else than `INFO=2`.
|
349
350
|
|
350
351
|
The recommended CMake settings using the `TBB` backend would look like this:
|
351
352
|
|
@@ -372,7 +373,7 @@ It is required to specify the source-files of the polyhedron's mesh (more info
|
|
372
373
|
about the supported file in the [documentation](https://esa.github.io/polyhedral-gravity-model/quickstart/supported_input.html)), the density
|
373
374
|
of the polyhedron, and the wished computation points where the
|
374
375
|
gravity tensor shall be computed.
|
375
|
-
Further one must specify the name of the .csv output file.
|
376
|
+
Further, one must specify the name of the .csv output file.
|
376
377
|
|
377
378
|
````yaml
|
378
379
|
---
|
@@ -381,7 +382,7 @@ gravityModel:
|
|
381
382
|
polyhedron: # polyhedron source-file(s)
|
382
383
|
- "../example-config/data/tsoulis.node" # .node contains the vertices
|
383
384
|
- "../example-config/data/tsoulis.face" # .face contains the triangular faces
|
384
|
-
density: 2670.0 # constant density, units must match with the mesh (see section below)
|
385
|
+
density: 2670.0 # constant density, units must match with the mesh (see a section below)
|
385
386
|
# Depends on metric_unit: 'km' -> kg/km^3, 'm' -> kg/m^3, 'unitless' -> 'unitless'
|
386
387
|
points: # Location of the computation point(s) P
|
387
388
|
- [ 0, 0, 0 ] # Here it is situated at the origin
|
@@ -400,8 +401,8 @@ computation point *P*.
|
|
400
401
|
|
401
402
|
## Testing
|
402
403
|
|
403
|
-
The project uses GoogleTest for testing.
|
404
|
-
tests just execute the following command in the build directory:
|
404
|
+
The project uses GoogleTest for testing.
|
405
|
+
In order to execute those tests, just execute the following command in the build directory:
|
405
406
|
|
406
407
|
```bash
|
407
408
|
ctest
|
@@ -416,5 +417,5 @@ pytest
|
|
416
417
|
## Contributing
|
417
418
|
|
418
419
|
We are happy to accept contributions to the project in the form of
|
419
|
-
suggestions, bug reports and pull requests. Please have a look at
|
420
|
+
suggestions, bug reports, and pull requests. Please have a look at
|
420
421
|
the [contributing guidelines](CONTRIBUTING.md) for more information.
|
@@ -0,0 +1,6 @@
|
|
1
|
+
polyhedral_gravity.cpython-312-darwin.so,sha256=TDJUoEmFSRN8hrSAfF1IlQ9pr36AVmsfKpEJXxA0Ui4,1486328
|
2
|
+
polyhedral_gravity-3.3.1rc1.dist-info/RECORD,,
|
3
|
+
polyhedral_gravity-3.3.1rc1.dist-info/WHEEL,sha256=CltXN3lQvXbHxKDtiDwW0RNzF8s2WyBuPbOAX_ZeQlA,109
|
4
|
+
polyhedral_gravity-3.3.1rc1.dist-info/top_level.txt,sha256=bIf9hErNs1GV27AnQWoRTE2j0lRmjhrKI1z-_MTR4Nk,19
|
5
|
+
polyhedral_gravity-3.3.1rc1.dist-info/METADATA,sha256=aYYuODe6mqEnhbTANWGzZITK-OZC5vcPOUQL9NQ_Mks,18533
|
6
|
+
polyhedral_gravity-3.3.1rc1.dist-info/licenses/LICENSE,sha256=ZJuIRhVUKcE6znMu3JzQKChvng_3yKh9v3v1MtHspHw,36310
|
Binary file
|
@@ -1,6 +0,0 @@
|
|
1
|
-
polyhedral_gravity.cpython-312-darwin.so,sha256=ksAgElXYnJOPHNsVme04PEu7UHO1lAyKr-ssroU7KdI,1469512
|
2
|
-
polyhedral_gravity-3.3rc1.dist-info/RECORD,,
|
3
|
-
polyhedral_gravity-3.3rc1.dist-info/LICENSE,sha256=ZJuIRhVUKcE6znMu3JzQKChvng_3yKh9v3v1MtHspHw,36310
|
4
|
-
polyhedral_gravity-3.3rc1.dist-info/WHEEL,sha256=VujM3ypTCyUW6hcTDdK2ej0ARVMxlU1Djlh_zWnDgqk,109
|
5
|
-
polyhedral_gravity-3.3rc1.dist-info/top_level.txt,sha256=bIf9hErNs1GV27AnQWoRTE2j0lRmjhrKI1z-_MTR4Nk,19
|
6
|
-
polyhedral_gravity-3.3rc1.dist-info/METADATA,sha256=g5XC7ANVj8ecBBO63AOfdWTZDDXngvPsvFMEZ46Iuvw,18499
|
{polyhedral_gravity-3.3rc1.dist-info → polyhedral_gravity-3.3.1rc1.dist-info/licenses}/LICENSE
RENAMED
File without changes
|
File without changes
|