<commit_before>===========
fiberassign
===========

Introduction
------------

This repository provides code for DESI fiber assignment, *i.e.* assigning
which fibers of which telescope pointings (tiles) should be assigned to
observe which objects in a target catalog.

Compiling
---------

To compile the code, set ``$PLATFORM`` to one of the recipes in the
``platforms/`` and then run ``make install``;  *e.g.* on Cori Haswell::

    make PLATFORM=nersc_cori_haswell install

This will create the ``bin/fiberassign`` executable.

The version of fiberassign can be updated with::

    make version

or::

    make TAG=1.2.3 version

to set the version when tagging.

Running
-------

The main executable ``fiberassign`` takes its arguments (eight in total) through the command line.

An example would be:: 

    fiberassign  --mtl mtl.fits --stdstar standards-dark.fits --sky sky.fits \
    --surveytiles dark-tiles.txt --footprint $DESIMODEL/data/footprint/desi-tiles.fits \
    --positioners $DESIMODEL/data/focalplane/fiberpos.txt --fibstatusfile fiberstatus.ecsv --outdir ./

``doc/Guide_to_FiberAssignment.tex`` contains more details.  A pdf snapshot
is available to DESI collaborators at
https://desi.lbl.gov/DocDB/cgi-bin/private/ShowDocument?docid=2742 .
<commit_msg>update compile instructions for desiconda<commit_after>===========
fiberassign
===========

Introduction
------------

This repository provides code for DESI fiber assignment, *i.e.* assigning
which fibers of which telescope pointings (tiles) should be assigned to
observe which objects in a target catalog.

Compiling
---------

To compile the code, set ``$PLATFORM`` to one of the recipes in the
``platforms/`` and then run ``make install``;  *e.g.* at NERSC::

    make PLATFORM=nersc_desiconda install

The version of fiberassign can be updated with::

    make version

or::

    make TAG=1.2.3 version

to set the version when tagging.

Running
-------

The main executable ``fiberassign`` is a python wrapper around the
C++ ``fiberassign_exec`` code.  Run ``fiberassign --help`` to see the
full set of command line options.

An example would be:: 

  fiberassign  \
    --mtl targets/mtl.fits \
    --stdstar targets/standards-dark.fits \
    --sky targets/sky.fits \
    --surveytiles fiberassign/dark-tiles.txt \
    --fibstatusfile fiberstatus.ecsv \
    --outdir $SCRATCH/temp/

``doc/Guide_to_FiberAssignment.tex`` contains more details about underlying
algorithms but is out of date for the details of running fiberassign.
A pdf snapshot is available to DESI collaborators at
https://desi.lbl.gov/DocDB/cgi-bin/private/ShowDocument?docid=2742 .

{'fraction_non_alphanumeric': 0.12495252563615647, 'fraction_numerical': 0.005317128750474744, 'mean_word_length': 3.5413793103448277, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6379298', 'n_tokens_mistral': 821, 'n_tokens_neox': 778, 'n_words': 285}