From 5b9a526475f63cf11093713dcd550ec8add0c41e Mon Sep 17 00:00:00 2001 From: drewoldag <47493171+drewoldag@users.noreply.github.com> Date: Tue, 11 Jul 2023 13:05:32 -0700 Subject: [PATCH 1/2] Fixing links in README, adding link to the documentation. --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index f8a0a59..74bfea6 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,16 @@ # pz-rail-hub +[![Read the Docs](https://img.shields.io/readthedocs/qp-flexzboost)](https://lsstdescrail.readthedocs.io/en/latest/index.html) +[![PyPI](https://img.shields.io/pypi/v/hub?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/pz-rail-hub/) +[![codecov](https://codecov.io/gh/LSSTDESC/pz-rail-hub/branch/main/graph/badge.svg)](https://codecov.io/gh/LSSTDESC/rail) + [![Template](https://img.shields.io/badge/Template-LINCC%20Frameworks%20Python%20Project%20Template-brightgreen)](https://lincc-ppt.readthedocs.io/en/latest/) -[![codecov](https://codecov.io/gh/LSSTDESC/pz-rail-hub/branch/main/graph/badge.svg)](https://codecov.io/gh/LSSTDESC/pz-rail-hub) -[![PyPI](https://img.shields.io/pypi/v/hub?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/hub/) -TODO - add more about your project here. ## RAIL: Redshift Assessment Infrastructure Layers This package is part of the larger ecosystem of Photometric Redshifts -in [RAIL](https://github.com/LSSTDESC/RAIL). +in [RAIL](https://github.com/orgs/LSSTDESC/repositories?q=rail&sort=name). ### Citing RAIL From d98c11b62100872c35647888bf305cec25902774 Mon Sep 17 00:00:00 2001 From: drewoldag <47493171+drewoldag@users.noreply.github.com> Date: Tue, 25 Jul 2023 13:09:04 -0700 Subject: [PATCH 2/2] Updating README to incorporate main branch changes. --- README.md | 46 +++++++++++++++++++++------------------------- 1 file changed, 21 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index 74bfea6..32feb45 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,32 @@ -# pz-rail-hub +# pz-rail -[![Read the Docs](https://img.shields.io/readthedocs/qp-flexzboost)](https://lsstdescrail.readthedocs.io/en/latest/index.html) -[![PyPI](https://img.shields.io/pypi/v/hub?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/pz-rail-hub/) -[![codecov](https://codecov.io/gh/LSSTDESC/pz-rail-hub/branch/main/graph/badge.svg)](https://codecov.io/gh/LSSTDESC/rail) +[![PyPI](https://img.shields.io/pypi/v/hub?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/pz-rail/) +[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7017551.svg)](https://doi.org/10.5281/zenodo.7017551) -[![Template](https://img.shields.io/badge/Template-LINCC%20Frameworks%20Python%20Project%20Template-brightgreen)](https://lincc-ppt.readthedocs.io/en/latest/) +[![Template](https://img.shields.io/badge/Template-RAIL%20Python%20Project%20Template-brightgreen)](https://github.com/LSSTDESC/RAIL-project-template) +[![Read the Docs](https://img.shields.io/readthedocs/rail-hub)](https://rail-hub.readthedocs.io/en/stable/index.html) +# RAIL: Redshift Assessment Infrastructure Layers -## RAIL: Redshift Assessment Infrastructure Layers +RAIL is a flexible software library providing tools to produce at-scale photometric redshift data products, including uncertainties and summary statistics, and stress-test them under realistically complex systematics. +A detailed description of RAIL's modular structure is available in the [Overview](https://rail-hub.readthedocs.io/en/stable/source/overview.html) on ReadTheDocs. -This package is part of the larger ecosystem of Photometric Redshifts -in [RAIL](https://github.com/orgs/LSSTDESC/repositories?q=rail&sort=name). +RAIL serves as the infrastructure supporting many extragalactic applications of the Legacy Survey of Space and Time (LSST) on the Vera C. Rubin Observatory, including Rubin-wide commissioning activities. +RAIL was initiated by the Photometric Redshifts (PZ) Working Group (WG) of the LSST Dark Energy Science Collaboration (DESC) as a result of the lessons learned from the [Data Challenge 1 (DC1) experiment](https://academic.oup.com/mnras/article/499/2/1587/5905416) to enable the PZ WG Deliverables in [the LSST-DESC Science Roadmap (see Sec. 5.18)](https://lsstdesc.org/assets/pdf/docs/DESC_SRM_latest.pdf), aiming to guide the selection and implementation of redshift estimators in DESC analysis pipelines. +RAIL is developed and maintained by a diverse team comprising DESC Pipeline Scientists (PSs), international in-kind contributors, LSST Interdisciplinary Collaboration for Computing (LINCC) Frameworks software engineers, and other volunteers, but all are welcome to join the team regardless of LSST data rights. -### Citing RAIL +## Installation -This code, while public on GitHub, has not yet been released by DESC and is -still under active development. Our release of v1.0 will be accompanied by a -journal paper describing the development and validation of RAIL. +Installation instructions are available under [Installation](https://rail-hub.readthedocs.io/en/stable/source/installation.html) on ReadTheDocs. -If you make use of the ideas or software in RAIL, please cite the repository -. You are welcome to re-use the code, which -is open source and available under terms consistent with the MIT license. +## Contributing -External contributors and DESC members wishing to use RAIL for non-DESC projects -should consult with the Photometric Redshifts (PZ) Working Group conveners, -ideally before the work has started, but definitely before any publication or -posting of the work to the arXiv. +The greatest strength of RAIL is its extensibility; those interested in contributing to RAIL should start by consulting the [Contributing guidelines](https://rail-hub.readthedocs.io/en/stable/source/contributing.html) on ReadTheDocs. -### Citing this package - -If you use this package, you should also cite the appropriate papers for each -code used. A list of such codes is included in the -[Citing RAIL](https://lsstdescrail.readthedocs.io/en/stable/source/citing.html) -section of the main RAIL Read The Docs page. +## Citing RAIL +RAIL is open source and may be used according to the terms of its [LICENSE](https://github.com/LSSTDESC/RAIL/blob/main/LICENSE) [(BSD 3-Clause)](https://opensource.org/licenses/BSD-3-Clause). +If you make use of the ideas or software here in any publication, you must cite this repository as "LSST-DESC PZ WG (in prep)" with the [Zenodo DOI](https://doi.org/10.5281/zenodo.7017551). +Please consider also inviting the developers as co-authors on publications resulting from your use of RAIL by [making an issue](https://github.com/LSSTDESC/rail/issues/new/choose). +Additionally, several of the codes accessible through the RAIL ecosystem must be cited if used in a publication. +A convenient list of what to cite may be found under [Citing RAIL](https://rail-hub.readthedocs.io/en/stable/source/citing.html) on ReadTheDocs.