{"id":30368508,"url":"https://github.com/dhi/tidepredictor","last_synced_at":"2026-04-18T00:32:10.490Z","repository":{"id":285416558,"uuid":"902246748","full_name":"DHI/tidepredictor","owner":"DHI","description":"Predict tidal elevations and currents","archived":false,"fork":false,"pushed_at":"2026-03-05T10:28:12.000Z","size":5629,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-05T13:58:01.576Z","etag":null,"topics":["marine","python","tides"],"latest_commit_sha":null,"homepage":"https://dhi.github.io/tidepredictor","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DHI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-12T07:40:21.000Z","updated_at":"2026-03-05T10:28:16.000Z","dependencies_parsed_at":"2025-11-30T09:07:17.807Z","dependency_job_id":null,"html_url":"https://github.com/DHI/tidepredictor","commit_stats":null,"previous_names":["dhi/tidepredictor"],"tags_count":3,"template":false,"template_full_name":"DHI/template-python-library","purl":"pkg:github/DHI/tidepredictor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DHI%2Ftidepredictor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DHI%2Ftidepredictor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DHI%2Ftidepredictor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DHI%2Ftidepredictor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DHI","download_url":"https://codeload.github.com/DHI/tidepredictor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DHI%2Ftidepredictor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31951298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["marine","python","tides"],"created_at":"2025-08-20T01:34:32.021Z","updated_at":"2026-04-18T00:32:10.464Z","avatar_url":"https://github.com/DHI.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tidepredictor: Predict tides with Python\n\n![](logo.png)\n\n## Dependencies\n\n* [Utide](https://github.com/wesleybowman/UTide)\n\nPredict the tides for a given location.\n\nContact: [Ole Svenstrup Petersen](mailto:osp@dhigroup.com)\n\n**Usage**:\n\n```console\n$ tidepredictor [OPTIONS]\n```\n\n**Options**:\n\n* `--lon FLOAT`: Longitude  [required]\n* `--lat FLOAT`: Latitude  [required]\n* `-s, --start [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]`: Start date  [required]\n* `-e, --end [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]`: End date  [required]\n* `-i, --interval INTEGER`: Interval in minutes  [default: 30]\n* `-o, --output PATH`: Output file, default is stdout\n* `--format [csv|json]`: Output format  [default: csv]\n* `--type [level|current]`: Type of prediction, level or u,v  [default: level]\n* `--install-completion`: Install completion for the current shell.\n* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.\n* `--help`: Show this message and exit.\n\n## Tidal constituents\n\n\u003cdetails\u003e\n\u003csummary\u003eCode\u003c/summary\u003e\n\n```python\nimport polars as pl\nfrom utide._ut_constants import ut_constants\n\nused_consts = \"Q1 MF P1 K1 MM O1 M2 S2 M4 MN4 MS4 N2 K2\".split()\n\nconsts = (\n    pl.DataFrame(ut_constants[\"const\"])\n    .select(\"name\", pl.col(\"freq\").alias(\"freq_cph\"))\n    .filter(pl.col(\"name\").is_in(used_consts))\n    .with_columns((1 / pl.col(\"freq_cph\")).alias(\"period_h\"))\n    .sort(\"period_h\", descending=True)\n)\n\nwith pl.Config(set_float_precision=4):\n    print(consts.head(10))\n```\n\n\u003c/details\u003e\n\n| name | freq_cph | period_h   |\n|------|----------|------------|\n| MM   | 0.001512 | 661.309268 |\n| MF   | 0.00305  | 327.858984 |\n| Q1   | 0.037219 | 26.868357  |\n| O1   | 0.038731 | 25.819342  |\n| P1   | 0.041553 | 24.06589   |\n| K1   | 0.041781 | 23.93447   |\n| N2   | 0.078999 | 12.658348  |\n| M2   | 0.080511 | 12.420601  |\n| S2   | 0.083333 | 12.0       |\n| K2   | 0.083561 | 11.967235  |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhi%2Ftidepredictor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdhi%2Ftidepredictor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhi%2Ftidepredictor/lists"}