Newer
Older
[](https://csst-proto.readthedocs.io/en/latest/?badge=latest)
- [https://csst-tb.bao.ac.cn/code/csst-l1/csst_proto](https://csst-tb.bao.ac.cn/code/csst-l1/csst_proto).
A sphinx-based documentation is available at
- [https://csst-proto.readthedocs.io/en/latest/](https://csst-proto.readthedocs.io/en/latest/)
## dependency
- numpy~=1.20.3
- joblib~=1.1.0
- astropy~=5.1
`csst_proto` can be installed with the following shell command
```bash
git clone https://csst-tb.bao.ac.cn/code/csst-l1/csst_proto.git
pip install -r requirements.txt
python setup.py install
```
or a single-line command
```bash
sh -c "$(curl -fsSL https://csst-tb.bao.ac.cn/code/csst-l1/csst_proto/-/raw/main/install.sh)"
## instruction
A simple example on how to use this package:
```python
# flip the image
img_flipped = flip_image(img=img)
```
The `csst_proto` uses an awesome algorithm based on `numpy.ndarray` indices to flip images.
## `git`: connecting collaborators
A very brief example of using `git`:
```bash
# global setting for git (name and email address)
git config --global user.name "BO ZHANG"
git config --global user.email "bozhang@nao.cas.cn"
# initialize a repository with main branch
git init --initial-branch=main
# clone a remote repository
git clone https://csst-tb.bao.ac.cn/code/csst-l1/csst_proto.git
# add some_module.py to version control system
git add ./some_module.py
# commit the changes
git commit -m "added some_module"
# add remote repository link
git remote add origin https://csst-tb.bao.ac.cn/code/csst-l1/csst_proto.git
# push changes to remote repository
git push origin main
# pull remote updates
git pull origin main
```
| file / directory | description | urgent | C6 | C7 |
|--------------------|---------------------------------|--------|-----|-----|
| `csst_proto/` | source code & data | √√ | √ | |
| `doc/` | sphinx-based documentation | | | √ |
| `example/` | code examples | - | - | - |
| `tests/` | unit tests | | | √ |
| `.gitignore` | git file | | √ | |
| `.gitlab-ci.yml` | gitlab CI/CD pipeline | | | √ |
| `LICENSE` | code license | | √ | |
| `README.md` | readme file | √√ | √ | |
| `install.sh` | single-line installation script | | √ | |
| `install_local.sh` | local installation script | | √ | |
| `readthedocs.yml` | readthedocs.io configuration | | | √ |
| `requirements.txt` | code requirements | √ | √ | |
| `setup.py` | sphinx-based documentation | √√ | √ | |
- stage 1:
- finished main code
- good code style
- `top_level_interface` available
- stage 2:
- finished `setup.py`
- can be installed with `pip install <package_name/package_link>` from gitlab
- stage 3:
- finished instruction
- `README.md`
- stage 4:
- finished unittest
- local unit test passed with `pytest`
- stage 5:
- gitlab CI/CD pipeline available
- auto unit tests passed with `.gitlab-ci.yml`
- stage 6:
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
| module name | stage 1<br>(source code) | stage 2<br>(packaging) | stage 3<br>(instruction) | stage 4<br>(unit tests) | stage 5<br>(gitlab pipeline) | stage 6<br>(sphinx doc) |
|-----------------------------|--------------------------|------------------------|--------------------------|-------------------------|------------------------------|-------------------------|
| `csst_proto` | √ | √ | √ | √ | √ | √ |
| `csst_ms_mbi_instrument` | √ | √ | | | | |
| `csst_ms_mbi_distortion` | √ | √ | √ | | | |
| `csst_ms_mbi_position` | √ | √ | | | | |
| `csst_ms_mbi_flux` | √ | √ | | | | |
| `csst_ms_mbi_photometry` | √ | √ | | | | |
| `csst_ms_sls_instrument` | √ | | | | | |
| `csst_ms_sls_mosaic` | √ | | | | | |
| `csst_ms_sls_position` | √ | | | | | |
| `csst_ms_sls_directimage` | √ ️ | | | | | |
| `csst_ms_sls_sky` | √ | | | | | |
| `csst_ms_sls_objextraction` | √ | | | | | |
| `csst_ms_sls_axe` | √ | | | | | |
| `csst_ms_sls_cde` | √ | | | | | |
| `csst_ms_qc0` | √ | | | | | |
| `csst_cpic` | √ | | | | | |
| `csst_thz_dp1` | √ | | | | | |
| `csst_mci_distortion` | √ | | | | | |
| `csst_mci_instrument` | √ | | | | | |
| `csst_mci_astrometry` | √ | | | | | |
| `csst_mci_flux` | √ | | | | | |
| `csst_mci_photometry` | √ | | | | | |
| `csst_ifs_rss` | √ | | | | | |
| `csst_ifs_cube` | √ | | | | | |
| `csst_ifs_wcs` | √ | | | | | |
- python packaging user guide: https://packaging.python.org/en/latest/
- packaging binary extensions (C/C++): https://packaging.python.org/en/latest/guides/packaging-binary-extensions
- `setuptools`: https://packaging.python.org/en/latest/tutorials/installing-packages/
- recommended IDEs
- PyCharm: https://www.jetbrains.com/pycharm/
- VS Code: https://code.visualstudio.com/
- `git`: https://git-scm.com/
- Pro Git: https://git-scm.com/book/en/v2
- Numpydoc: https://numpydoc.readthedocs.io/en/latest/format.html
- for C: https://peps.python.org/pep-0007/
- for Python: https://peps.python.org/pep-0008/
- example.py: https://numpydoc.readthedocs.io/en/latest/example.html#example
- `unittest`: https://docs.python.org/3.8/library/unittest.html
- gitlab CI/CD pipeline: https://docs.gitlab.com/ee/ci/pipelines/
- gitlab runners: https://docs.gitlab.com/runner/
- `sphinx`: https://www.sphinx-doc.org/en/master/index.html
- markdown: https://www.markdownguide.org/
- restructured text: https://docutils.sourceforge.io/rst.html
from csst_common.data_manager import CsstMbiDataManager
from csst_common.params import CSST_PARAMS
ver_sim="C5.1", dir_l0="/data/sim_data/MSC_0000100", dir_l1="/home/user/L1Pipeline/msc/work")
# process all CCDs
print("----- available detectors -----")
print(dm.available_detectors)
for detector in dm.target_detectors:
print(dm.l0_detector(detector=detector))
print(os.path.exists(dm.l0_ccd(detector=detector)))
print(dm.l0_crs(detector=detector))
print(os.path.exists(dm.l0_ccd(detector=detector)))
print(dm.l0_cat(detector=detector))
print(os.path.exists(dm.l0_cat(detector=detector)))
print(dm.l0_log(detector=detector))
print(os.path.exists(dm.l0_log(detector=detector)))