{"id":18412259,"url":"https://github.com/bashrc2/staramp","last_synced_at":"2025-04-12T23:45:50.711Z","repository":{"id":193111938,"uuid":"688123638","full_name":"bashrc2/staramp","owner":"bashrc2","description":"Amplify stars within night photos","archived":false,"fork":false,"pushed_at":"2023-09-19T10:40:02.000Z","size":9030,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T23:45:47.746Z","etag":null,"topics":["astrophotography","photography"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bashrc2.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-06T17:44:03.000Z","updated_at":"2023-09-06T17:48:04.000Z","dependencies_parsed_at":"2024-11-06T03:41:15.660Z","dependency_job_id":"8b344e24-ffe0-4b4a-8b4d-a4d1d9b6825d","html_url":"https://github.com/bashrc2/staramp","commit_stats":null,"previous_names":["bashrc2/staramp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fstaramp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fstaramp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fstaramp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fstaramp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bashrc2","download_url":"https://codeload.github.com/bashrc2/staramp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647259,"owners_count":21139081,"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":["astrophotography","photography"],"created_at":"2024-11-06T03:40:35.069Z","updated_at":"2025-04-12T23:45:50.681Z","avatar_url":"https://github.com/bashrc2.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"**staramp** detects stars within a night photo and then amplifies only the star pixels by some defined percentage, without altering the background.\n\n\u003cimg src=\"https://gitlab.com/bashrc2/staramp/-/raw/main/images/example.jpg?ref_type=heads\" width=\"70%\"/\u003e\n\n## Installation\n\nOn a Debian based distro:\n\n``` bash\nsudo apt install build-essential\n```\n\nThen build and install:\n\n``` bash\ngit clone https://gitlab.com/bashrc2/staramp\ncd staramp\nmake\nsudo make install\n```\n\n## Usage\n\nAn example of use can be seen within the **test.sh** script.\n\n``` bash\nstaramp --dog 8 --dogthresh 145 --dogamp 80 --miny 0 --maxy 2100 -f images/stars1.png\n```\n\nIt produces a file called **result.png**\n\n**--dog** specifies the radius for the *difference of gaussians* filter. It should be approximately the same as the width of the stars in pixels within your image.\n\n**--dogthresh** applies a threshold to the *difference of gaussians* filter, so that faint pixels which might just be noise can be excluded.\n\n**--dogamp** the amplification percentage.\n\n**--miny** sets the minimum Y axis coordinate to begin processing at. This is typically 0 (the top of the photo).\n\n**--maxy** sets the maximum Y axis coordinate to end processing at. This can be 0 which means process the whole image, or it can be some other value to exclude any scenery at the bottom of the photo.\n\n**-f** defines the night image to be processed. This must be in PNG format.\n\nYou can also exclude areas of the image within specified bounding boxes, by using the **--exclude** option:\n\n``` bash\nstaramp --dog 12 --dogthresh 140 --dogamp 70 --miny 0 --maxy 0 --exclude \"0,1590,1287,2013\" -f images/stars2.png\n```\n\nHere the bounding box to be excluded has top left coordinate **0,1590** and bottom right coordinate **1287,2013**. If you specify additional numbers then you can have multiple exclusion areas. An example might be:\n\n``` bash\n--exclude \"(0,1590,1287,2013),(50,100,300,500)\"\n```\n\nIf excluding bounding boxes is insufficient, because the shape of the scenery is not very linear then you can define a polygon inside which the stars should be amplified. The polygon can have up to 127 vertices and is a series of **x,y** coordinates. For example:\n\n``` bash\nstaramp --dog 12 --dogthresh 140 --dogamp 70 --miny 0 --maxy 0 --inside \"(0,0),(3045,0),(3045,2019),(1278,2019),(936,1587),(0,1572)\" -f images/stars2.png\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashrc2%2Fstaramp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbashrc2%2Fstaramp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashrc2%2Fstaramp/lists"}