{"id":21468171,"url":"https://github.com/dankelley/whalestrike","last_synced_at":"2026-01-07T07:09:23.708Z","repository":{"id":219299475,"uuid":"137647203","full_name":"dankelley/whalestrike","owner":"dankelley","description":"Numerical simulation of ship-whale collision","archived":false,"fork":false,"pushed_at":"2024-05-29T20:02:21.000Z","size":10525,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-11T16:38:48.110Z","etag":null,"topics":["collision","r","ships","whales"],"latest_commit_sha":null,"homepage":"https://dankelley.github.io/whalestrike/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dankelley.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json"}},"created_at":"2018-06-17T10:39:26.000Z","updated_at":"2024-06-04T19:38:06.000Z","dependencies_parsed_at":"2024-01-26T16:25:22.604Z","dependency_job_id":"6fe5e547-47c9-4717-8bd7-f3d81b4306bd","html_url":"https://github.com/dankelley/whalestrike","commit_stats":null,"previous_names":["dankelley/whalestrike"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Fwhalestrike","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Fwhalestrike/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Fwhalestrike/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dankelley%2Fwhalestrike/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dankelley","download_url":"https://codeload.github.com/dankelley/whalestrike/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245850257,"owners_count":20682636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["collision","r","ships","whales"],"created_at":"2024-11-23T08:23:49.771Z","updated_at":"2026-01-07T07:09:23.702Z","avatar_url":"https://github.com/dankelley.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The whalestrike package\n\n\u003c!-- badges: start --\u003e\n\n\n[![GitHub last commit](https://img.shields.io/github/last-commit/dankelley/whalestrike)](https://img.shields.io/github/last-commit/dankelley/whalestrike)\n[![R-CMD-check](https://github.com/dankelley/whalestrike/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/dankelley/whalestrike/actions/workflows/R-CMD-check.yaml)\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.06473/status.svg)](https://doi.org/10.21105/joss.06473)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11372537.svg)](https://doi.org/10.5281/zenodo.11372537)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n\n\n\u003c!-- badges: end --\u003e\n\n## Purpose\n\nThis package provides tools for simulating the collisions of ships\nwith whales, using a simplified dynamical structure involving point\nmasses separated by compressible materials. Along with functions for\ncomputations of forces, deformations, accelerations, etc., the package\nprovides a easy-to-use GUI tool that makes it easy to set up some\ncommon simulation scenarios, and to display the results in graphical\nform.\n\nTo learn more about the scientific background, and to see the results\nof some detailed computations placed in the context of a database of\nobserved strikes, see Kelley et al. (2021). For more information on\nthe coding, see Kelley (2024).\n\n## Installation\n\nThe package is not yet available on CRAN, and must be installed from\nsource. This can be done either by downloading the source and building\nit locally, or by the simpler method of typing\n```R\n# install.package(\"remotes\")\nremotes::install_github(\"dankelley/whalestrike\", ref=\"main\")\n```\nin an R session.  (Uncomment the first line, if the `remotes`\npackage is not yet installed on your machine.)\n\n## Usage\n\nMost users will find that the GUI application is a good way to learn about the\npackage.  To start this, type\n\n```R\nlibrary(whalestrike)\napp2()\n```\n\nin an R session.  A window will open in your browser.  On the\nleft-hand side is a region with controllers, many hidden in sub-panels\nthat can be opened by clicking on V-shaped icons.  Before opening\nthose sub-panels, try adjusting the ship speed, to see what happens to\nthe plots, especially the one labelled `Lethality Index`. Think about\nwhether the tendency of variations to the index are in line with your\nintuition. Next, open the `Ship` sub-panel, to explore the result of\naltering the ship mass.  This sub-panel also has controllers\nspecifying the geometry of the impact region, and you ought to explore\nthem, also. Continuing to explore the app's controllers ought to give\nyou a good indication of what the tool provides. To learn more, try\nconsulting the app's documentation, provided (a) as the response to\ntyping `? app2` in the R console, (b) as information in a dialog box\nthat opens when the `Help` button is clicked, and (c) in a [youtube\nvideo](https://youtu.be/kTMl3nXa5A4) and a brief [followup youtube\nvideo](https://youtu.be/f8nHGikb9ug) that illustrates an alteration\nmade after a helpful comment from a review of a Journal of Open-Source\nSoftware manuscript about the package.\n\nUsers who want more control, and who want to deal with the results in\nnumerical as opposed to graphical form, should try clicking the `Code`\nbutton in `app2()`, to see the R code that runs the simulation outside\nthe app.  The next step will be to explore the functions used in that\ncode.  Documentation exists for each of these functions e.g. typing\n```R\nlibrary(whalestrike)\n?strike\n```\nin an R session will provide information on `strike()`, which is a key\nfunction in the package.\n\n## References\n\n\n* Kelley, Dan E., James P. Vlasic, and Sean W. Brillant. \"Assessing\n  the Lethality of Ship Strikes on Whales Using Simple Biophysical\n  Models.\" Marine Mammal Science 37, no. 1 (January 2021): 251–67.\n  https://doi.org/10.1111/mms.12745. ([journal\n  site](https://doi.org/10.1111/mms.12745); [ResearchGate\n  Preprint](https://www.researchgate.net/publication/344748816_Assessing_the_lethality_of_ship_strikes_on_whales_using_simple_biophysical_models))\n\n* Kelley, Dan E. \"Whalestrike: an R package for simulating ship\n  strikes on whales\". Submitted to Journal of Open Source Software,\n  2024-01-29.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdankelley%2Fwhalestrike","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdankelley%2Fwhalestrike","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdankelley%2Fwhalestrike/lists"}