add analysis structure doc comments