Families In the Wild (FIW) Data and Development Kit

Use this repo

This documentation describes FIW DB and (working) development kit. This is work in prgress (i.e., still to come are FIW-CNN models, updated benchmarks, more in README (this), and more).

Check out FIW project page

Download here

See pulications below. A more complete list of references can be found here

 @article{robinson2018fiw,
   title={},
   author={},
   journal={IEEE Transactions on Pattern Analysis and Machine Intelligence},
   year={2018},
   publisher={IEEE}
 }
 
 @InProceedings{kinFG2017,
  author       = "Wang, Shuyang and Robinson, Joseph P and Fu, Yun",
  title        = "Kinship Verification on Families In The Wild with Marginalized Denoising Metric Learning",
  booktitle    = "Automatic Face and Gesture Recognition (FG), 2017 12th IEEE International Conference and Workshops on",
  year         = "2017",
}

@InProceedings{robinson2016families,
  author       = "Robinson, Joseph P. and Shao, Ming and Wu, Yue and Fu, Yun",
  title        = "Families In the Wild (FIW): Large-Scale Kinship Image Database and Benchmarks",
  booktitle    = "Proceedings of the 2016 ACM on Multimedia Conference",
  pages        = "242--246",
  publisher    = "ACM",
  year         = "2016"
}

By downloading the image data you agree to the following terms:

1. You will use the data only for non-commercial research and educational purposes.
2. You will NOT distribute the above images.
3. Northeastern University makes no representations or warranties regarding the data, including but not limited to warranties of non-infringement or fitness for a particular purpose. 1.You accept full responsibility for your use of the data and shall defend and indemnify Northeastern University, including its employees, officers and agents, against any and all claims arising from your use of the data, including but not limited to your use of any copies of copyrighted images that you may create from the data.

• FIW_PIDs.csv:    Photo lookup table. Each row is an image instance, containing the following fields:

  • PID:    Photo ID
  • Name:    Surname.firstName (root reference for given family)
  • URL:    Photo URL on web
  • Metadata:   Text caption for photo

• FIW_FIDs.csv:    FID (family)/ Surname lookup table.

  • FID:    Unique ID key assigned to each family.
  • Surname:    Family Name corresponding to FID key.

• FIW_RIDs.csv:   Relationship lookup table with keys [1-9] assigned to relationship types.

• FIDs/

  • FID####/    Contains labels and cropped facial images for members of family (1-1000)

    • MID#/    Face images of family member with ID key , i.e., MID #.

    • F####.csv:    File containing member information of each family:

      • relationships  matrix representing relationship
      • names    First name of family member.
      • gender    ender of family member

For example:

FID0001.csv
    
	0     1     2     3     Name    Gender
	1     0     4     5     name1   female
	2     1     0     1     name2   female
	3     5     4     0     name3   male
	

Here we have 3 family members, as seen by the MIDs across columns and down rows.

We can see that MID1 is related to MID2 by 4->1 (Parent->Sibling), which of course can be viewed as the inverse, i.e., MID2->MID1 is 1->4. It can also be seen that MID1 and MID3 are Spouses of one another, i.e., 5->5. And so on, and so forth.

Please contact Joseph Robinson (robinson.jo@husky.neu.edu) for questions, comments, or bug reports.