pytheas_simulator 1.1.0__py3-none-any.whl

pytheas_simulator-1.1.0.dist-info/METADATA

@@ -0,0 +1,56 @@
+Metadata-Version: 2.5
+Name: pytheas_simulator
+Version: 1.1.0
+Summary: A pytheas package to simulate ancient seafaring.
+Project-URL: Homepage, https://github.com/mtomasini/PytheasSimulator
+Project-URL: Source Code, https://github.com/mtomasini/PytheasSimulator
+Project-URL: Bug Tracker, https://github.com/mtomasini/PytheasSimulator/issues
+Project-URL: Documentation, https://github.com/mtomasini/PytheasSimulator/blob/main/README.md
+Project-URL: Download, https://pypi.org/project/PytheasSimulator/#files
+Author: Matteo Tomasini
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-based modelling,ancient navigation,ancient seafaring,bronze age,computational archaeology,neolithic
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.9
+Requires-Dist: cartopy
+Requires-Dist: dask
+Requires-Dist: ephem>=4.2.1
+Requires-Dist: geopy>=2.3.0
+Requires-Dist: netcdf4
+Requires-Dist: numpy>=1.23.5
+Requires-Dist: opencv-python
+Requires-Dist: pandas>=1.5.3
+Requires-Dist: pip
+Requires-Dist: xarray==2023.1.0
+Requires-Dist: xoak
+Description-Content-Type: text/markdown
+
+# Pytheas - a flexible and agile simulator of ancient seafaring
+
+Current research in the [Maritime Encounters project](https://www.gu.se/en/research/maritime-encounters), at the University of Gothenburg, has been led by using and developing the software [Voyager](https://github.com/mtomasini/voyager). While this software is very complete and thorough, it can be difficult to maintain and develop due to the many components that it uses. I decided to write a version of the code that is more flexible and less complex to use, based on my own experiences in simulating seafaring in ancient times. This software is an improvement on the work by Alvaro Montenegro (Ohio State University) and Victor Wåhlstrand Skärström (University of Gothenburg, now at Chalmers University of Technology). The code is written in Python.
+
+At this stage, I only make available the code [and its documentation](https://mtomasini.github.io/pytheas-simulator/); at a latter stage, I will make available:
+
+- [ ] A demonstration file with attached parameters
+- [ ] A complete vignette containing a description of all functionalities
+- [ ] A script to download data from Copernicus for usage within Pytheas
+- [ ] (Optional) A snakemake file or similar that will help the user picking a few parameters and simulating with Pytheas without having to download data locally.
+
+## Development philosophy
+
+The code for Voyager was documented but had no tests. In the development of this new software, it is my intention to have even better documentation as well as unit testing. This follows from years of working in an academic context where tests are an afterthought and are seldom developed. But when using a software developed over years, by developers who have since quit the workplace, and that has required quick developments to respond to publication deadlines, the lack of testing in particular has proven deleterious, leading to bad mistakes at the production stage.
+
+## Name of the software
+
+I decided to name this new iteration of the Voyager software "Pytheas". As a software engineer, this is a (bad) pun on the fact that the software was developed in Python. But as an archaeologist, Pytheas was an ancient Greek navigator from Massalia (modern Marseille) who in around 330 BCE went on a sailing travel to the far North of Europe, reaching the British Isles and travelling further north to _Ultima Thule_ (which may be, according to Barry Cunliffe[^1], most probably Iceland, but possibly Norway or Shetland). Pytheas' travel has been source of inspiration and marvel for more than 2000 years.
+
+## License
+
+This software is packaged with a MIT License.
+
+[^1]: The Extraordinary Voyage of Pytheas the Greek, Barry Cunliffe (2001), Chapter 6.

pytheas_simulator-1.1.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+pytheas_simulator-1.1.0.dist-info/METADATA,sha256=4SBmy65YFYHfqsWneDIe43SbrhzQK2PJLIURr0tPlU4,4012
+pytheas_simulator-1.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+pytheas_simulator-1.1.0.dist-info/licenses/LICENSE,sha256=JmpNzo3WEZ7YcOGel26fONBCwK-DmpXahvBk7KaItEY,1072
+pytheas_simulator-1.1.0.dist-info/RECORD,,

pytheas_simulator-1.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

pytheas_simulator-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matteo Tomasini
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.