Document reading tabular pedigree formats into sgkit

[timothymillar]

We don't currently have any IO functionality for pedigree formats. These are usually tabular but can be quite variable. We should document how to read in some generic examples and add them to an sgkit style dataset.

Basic workflow:

• Read tabular format as pandas dataframe
• Assign sample identifiers to the sample_id variable
• Assign parental columns to the parent_id variable
• Optionally set coords for the parents dim (['Father', 'Mother'], ['Sire', 'Dam'], etc.)
• Use parent_indices to generate the parents array and explain the 0-based indexing etc.
• Do something interesting like calculating kinship.

[timothymillar]

@jeromekelleher suggests also adding "Pedigree statistics" top level section to the documentation https://github.com/pystatgen/sgkit/issues/1025#issuecomment-1436755539.

I was actually just looking for documentation this morning answering a question about computing inbreeding from simulations

Could you give some more detail on these simulations?

[jeromekelleher]

Discussion here: tskit-dev/tskit#2711

[timothymillar]

This is mostly covered by #1072, but I might leave it open for now as I think there is room for more pedigree specific documentation.