{"id":19705717,"url":"https://github.com/llnl/uedge","last_synced_at":"2025-09-14T16:33:52.882Z","repository":{"id":44164070,"uuid":"152654774","full_name":"LLNL/UEDGE","owner":"LLNL","description":"2D fluid simulation of plasma and neutrals in magnetic fusion devices","archived":false,"fork":false,"pushed_at":"2025-08-18T23:29:22.000Z","size":483848,"stargazers_count":40,"open_issues_count":19,"forks_count":21,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-08-19T01:16:43.304Z","etag":null,"topics":["math-physics","simulation"],"latest_commit_sha":null,"homepage":"","language":"Fortran","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LLNL.png","metadata":{"files":{"readme":"README-Docker","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":null,"zenodo":null}},"created_at":"2018-10-11T20:55:40.000Z","updated_at":"2025-06-30T20:59:29.000Z","dependencies_parsed_at":"2023-10-11T02:02:50.267Z","dependency_job_id":"96ff9b90-cb28-45f0-80dc-0c55042c1cfd","html_url":"https://github.com/LLNL/UEDGE","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/LLNL/UEDGE","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2FUEDGE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2FUEDGE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2FUEDGE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2FUEDGE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LLNL","download_url":"https://codeload.github.com/LLNL/UEDGE/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLNL%2FUEDGE/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275134049,"owners_count":25411447,"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","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["math-physics","simulation"],"created_at":"2024-11-11T21:29:50.488Z","updated_at":"2025-09-14T16:33:52.795Z","avatar_url":"https://github.com/LLNL.png","language":"Fortran","funding_links":[],"categories":[],"sub_categories":[],"readme":"\nThis README will address using a Docker container to build and run the Basis\nversion of Uedge. The Basis Uedge version is deprecated and is provided for \nlegacy applications only and provided/supported only for local Program \ndevelopers use. New users should use the Python Uedge module. For the remainder\n of this readme the name Uedge will only refer to the Basis version.\n\nBasis is a high-level programming language. It's similar to Python in that it \nallows user developed applications to be run interactively. It was developed at\nLLNL, and as was already indicated, is deprecated and no long supported. \n\nDocker is a virtualization platform for running applications inside containers.\nIt doesn't require the user create a full virtual machine so is lighter weight.\nTo get started you need to install Docker from https://www.docker.com. You may \nuse the free install option to run the Docker container image we've created for\nUedge. Once you have Docker installed you should verify that it works by running\nthe hello-world container with \"docker run -it --rm hello-world\". \n\nThe Uedge container contains the full build environment required to build and \nrun some simple tests. The Uedge container is fusionbillm/basisuedge. There are\nmany ways it may be run and you should refer to the Docker documentation for any\nthing not covered here. What follows is the expected uses of this container with\nrunstrings and actions described:\n\ndocker run -it --rm fusionbillm/basisuedge\n      This will pull the latest master branch of Uedge, build, and run the\n      some simple tests. Returns to host with 0=success or 1=failure.\ndocker run -it --rm fusionbillm/basisuedge checkout develop\n      This passes the argument after the container name to git after the pull.\n      In this case a \"git pull\" followed by a \"git checkout develop\". Then\n      the usual build and tests are run. Returns to host with 0=success or\n      1=failure.\ndocker run -it --rm --entrypoint /bin/bash fusionbillm/basisuedge\n      This just runs the container and you should receive a bash shell prompt.\n      The ~/UEDGE directory is a git clone with the master branch checked out.\n      A \"git pull\" should be done there to update the clone. There is a shell\n      script there, ~/basisuedge.sh, you can run or just examine. It is what\n      executes the build and test actions. Running it will leave you at the\n      bash shell prompt inside the container.\n\n\nGraphics\n========\n\nUedge is compiled to use the X11 protocol to produce graphics from the NCAR \ngraphics library. Since Docker is not a full VM, or running a Desktop, the \ngraphics are output to the host display. The protocol is X11 regardless of the \nhost, the trick is to tunnel the protocol and authenticate with the display X11\nserver. The command syntax is depends on the host type. \n\nMac:\ndocker run -it --rm -e DISPLAY=host.docker.internal:0 --entrypoint /bin/bash fusionbillm/basisuedge\n\nLinux:\ndocker run -it --rm -e DISPLAY=$DISPLAY --volume=\"$HOME/.Xauthority:/home/user/.Xauthority:rw\" -v /tmp/.X11-unix:/tmp/.X11-unix --network=host --entrypoint /bin/bash fusionbillm/basisuedge\n\nWindows:\nThis needs to be determined. It's assumed that an X11 environment would need to\nbe run in the Windows host.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllnl%2Fuedge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fllnl%2Fuedge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllnl%2Fuedge/lists"}